OpenClaw Flomo Skill

---

name: flomo description: Read and write flomo memos on macOS. Use when user asks to fetch recent flomo notes, search memo text in local flomo cache, or create/write a new memo to flomo via incoming webhook or URL scheme.

---

flomo

Use this skill on macOS to read and write flomo content.

Commands

Read recent memos (remote API, recommended; auto-expands time window):

python3 scripts/flomo_tool.py read --remote --limit 20

Search recent memos by keyword (remote API):

python3 scripts/flomo_tool.py read --remote --limit 100 --query "关键词"

Read by tag (recommended for diary/book/etc):

python3 scripts/flomo_tool.py read --remote --limit 10 --tag "日记"

List top tags (to see how many memos each tag has):

python3 scripts/flomo_tool.py read --dump-tags --limit 20

Write memo (auto-resolve incoming webhook from local flomo login state):

python3 scripts/flomo_tool.py write --content "内容"

Write memo via URL scheme (opens flomo app draft):

python3 scripts/flomo_tool.py write --content "内容" --url-scheme

One-shot health check (read + write-url-scheme dry flow):

python3 scripts/flomo_tool.py verify --try-webhook --query "#openclaw"

Behavior Rules

Prefer webhook write; script can auto-resolve webhook when logged in on this Mac.

Use URL scheme write only as fallback, because it requires GUI interaction to confirm/save.

Read path uses remote API first and can auto-expand search window for sparse tags/keywords.

For tag intent, prefer --tag; --query "#标签" is also supported.

Never print full webhook URL in logs; only print masked form.