flomo-notes – OpenClaw Skill

---

name: flomo-notes description: Save notes to Flomo via the Flomo inbox webhook. Use when the user says "save to flomo", "记录到 flomo", "flomo note", or asks to store a note in flomo.

flomo-notes

Save notes to Flomo using a single webhook POST.

Setup

Provide your Flomo inbox webhook URL via environment variable:

• FLOMO_WEBHOOK_URL (required), example: https://flomoapp.com/iwh/XXXXXXXX

You can set it either:

1. In ~/.openclaw/openclaw.json (recommended):

{
  skills: {
    entries: {
      "flomo-notes": {
        env: {
          FLOMO_WEBHOOK_URL: "https://flomoapp.com/iwh/XXXXXXXX"
        }
      }
    }
  }
}

2. Or in your shell/service environment:

export FLOMO_WEBHOOK_URL="https://flomoapp.com/iwh/XXXXXXXX"

How the skill works

When triggered, run:

bash scripts/save_to_flomo.sh "<note text>"

Example prompts (to trigger)

• save to flomo: buy milk, eggs
• 记录到 flomo：下周美股大事件...

Script manual test

FLOMO_WEBHOOK_URL="https://flomoapp.com/iwh/XXXXXXXX" \
  bash scripts/save_to_flomo.sh "hello from openclaw"

Security

Treat the webhook URL like a secret: anyone with it can post into your Flomo inbox.

flomo-notes (OpenClaw Skill)

A minimal OpenClaw Skill that saves a note to Flomo using one webhook API call.

It consists of only:

• SKILL.md
• scripts/save_to_flomo.sh

What it does

When the user asks things like:

• “save to flomo: …”
• “记录到 flomo：…”
• “把这段保存到 flomo”

…the agent should run scripts/save_to_flomo.sh to POST the note text to your Flomo inbox webhook.

Requirements

• A Flomo inbox webhook URL (looks like https://flomoapp.com/iwh/XXXX...).
• curl available on the machine running the OpenClaw Gateway.

Install (make the skill discoverable by OpenClaw)

OpenClaw scans bundled skills plus your local skill directories.

Option A (recommended): copy into ~/.openclaw/skills/

mkdir -p ~/.openclaw/skills/flomo-notes
cp -R /Users/robertshaw/GitHub/aigc/openclaw-plugin-flomo/* ~/.openclaw/skills/flomo-notes/

Restart the gateway (or start a new session) so the skills list refreshes.

Option B: load directly from this repo via skills.load.extraDirs

Edit ~/.openclaw/openclaw.json and add this repo’s parent directory to skills.load.extraDirs.

Example (JSON5 style shown in docs; your file may be JSON):

{
  skills: {
    load: {
      extraDirs: [
        "/Users/robertshaw/GitHub/aigc" // contains openclaw-plugin-flomo/
      ]
    }
  }
}

Note: OpenClaw scans directories that contain skill folders with SKILL.md inside.

Configure the webhook (FLOMO_WEBHOOK_URL)

Best way: set via OpenClaw config (per-skill env injection)

In ~/.openclaw/openclaw.json, set:

{
  skills: {
    entries: {
      "flomo-notes": {
        env: {
          FLOMO_WEBHOOK_URL: "https://flomoapp.com/iwh/XXXX..."
        }
      }
    }
  }
}

This injects the env var for each agent run (so you don’t have to export it in your shell).

Alternative: export in your shell / service environment

export FLOMO_WEBHOOK_URL="https://flomoapp.com/iwh/XXXX..."

Usage

In chat:

• save to flomo: buy milk, eggs
• 记录到 flomo：下周美股大事件...

Or run the script manually:

FLOMO_WEBHOOK_URL="https://flomoapp.com/iwh/XXXX..." \
  bash scripts/save_to_flomo.sh "hello from openclaw"

Notes / Troubleshooting

• If you see Missing FLOMO_WEBHOOK_URL, set it via config/env as above.
• If curl returns an error, verify the webhook URL and network connectivity.
• Treat the webhook URL like a secret (it allows anyone with it to post into your Flomo inbox).