flomo-sync

What This Skill Does

The flomo-sync skill is a powerful command-line utility designed for users of the flomo note-taking platform. It acts as an automated bridge between your cloud-based flomo memos and your local file system, transforming your unstructured notes into structured Markdown files. By interacting with the flomo API, it performs incremental synchronizations, ensuring that only new or updated memos are processed during subsequent runs. This tool handles the complexities of data retrieval, including the extraction of tags, the preservation of metadata (such as timestamps and source identifiers), and the optional downloading of attached media files. It is an essential utility for anyone looking to own their data, create offline backups, or integrate their flomo content into static site generators or local knowledge management systems like Obsidian or Logseq.

Installation

To begin using this skill, ensure you have Python 3.10 or higher installed on your system. First, use the OpenClaw CLI to install the skill package: clawhub install openclaw/skills/skills/giraffe-tree/flomo-sync. Once installed, you will need to set up your environment by installing the required Python dependencies: pip install requests markdownify. For authentication, create a .flomo.config file in your project root containing your token=<access_token>. This ensures secure access to your account data without needing to handle credentials through command arguments repeatedly.

Use Cases

1. Personal Knowledge Management (PKM) Backup: Periodically back up all flomo memos to a local directory for long-term storage and data sovereignty.
2. Content Portability: Export your flomo content into Markdown to migrate your notes to other applications or to incorporate them into personal websites built with Hugo or Jekyll.
3. Incremental Archiving: Save time by only syncing memos that have changed since your last execution, maintaining an up-to-date repository without redundant API calls.

Example Prompts

1. "OpenClaw, please run the flomo-sync skill to pull all my latest notes into my current project folder at /Users/jdoe/notes/flomo_backup."
2. "Sync my flomo memos, but skip downloading the attachments to save space and just keep the reference URLs."
3. "I only need the updates from this month; can you run the flomo sync command with the --after 2024-10-01 flag?"

Tips & Limitations

• Security: Never share your .flomo.config file or expose your API token in open repositories. Always use absolute paths for the --dir parameter to ensure consistent execution regardless of your current shell context.
• Authentication: Always prefer the .flomo.config method over command-line arguments to avoid leaking tokens in your shell command history.
• Limitations: This tool is designed for syncing data from the cloud to local storage. It does not support bi-directional synchronization; changes made to the local Markdown files will not be pushed back to flomo. Additionally, ensure stable internet connectivity during the first sync, especially if you have a high volume of attachments to download.