append-note
/install note-sync
\r \r
Note Sync\r
\r
Save conversation content to local Markdown files using the MCP tool append_note.\r
\r
When to use\r
\r Invoke when the user wants to:\r \r
- Save an idea, insight, or reminder as a note\r
- Append content to a named note file (e.g. 感悟, 待办, journal)\r
- Persist text from the chat to disk\r \r
One-time setup\r
\r
ClawHub installs this skill to ~/.openclaw/skills/note-sync/. Complete these steps once.\r
\r
Step 1 — Clone repo and build MCP (Windows)\r
\r
git clone https://github.com/your-org/go-note-sync-mcp.git\r
cd go-note-sync-mcp\mcp-server\r
go build -o note-sync-mcp.exe\r
```\r
\r
MCP binary path (fixed convention):\r
\r
```\r
$NOTE_SYNC_REPO/mcp-server/note-sync-mcp.exe\r
```\r
\r
WSL example: `/mnt/e/github/go-note-sync-mcp/mcp-server/note-sync-mcp.exe`\r
\r
### Step 2 — Configure `~/.openclaw/openclaw.json`\r
\r
Replace `\x3CWSL_REPO>` with your repo root in WSL (e.g. `/mnt/e/github/go-note-sync-mcp`).\r
\r
Replace `\x3CSKILL_DIR>` with your skill install path (default `~/.openclaw/skills/note-sync`).\r
\r
```json\r
{\r
"skills": {\r
"entries": {\r
"note-sync": {\r
"enabled": true,\r
"env": {\r
"NOTE_SYNC_REPO": "\x3CWSL_REPO>"\r
}\r
}\r
}\r
},\r
"mcp": {\r
"servers": {\r
"note-sync": {\r
"command": "\x3CSKILL_DIR>/scripts/note-sync-mcp.sh",\r
"args": []\r
}\r
}\r
}\r
}\r
```\r
\r
The bundled launcher `{baseDir}/scripts/note-sync-mcp.sh` runs `\x3CWSL_REPO>/mcp-server/note-sync-mcp.exe`.\r
\r
**Alternative:** point `mcp.servers.note-sync.command` directly to `\x3CWSL_REPO>/mcp-server/note-sync-mcp.exe`.\r
\r
### Step 3 — Restart and verify\r
\r
```bash\r
openclaw gateway restart\r
openclaw skills info note-sync\r
openclaw mcp list\r
```\r
\r
Status should be **Ready** and tool `append_note` should appear.\r
\r
Copy-paste template: `{baseDir}/references/openclaw.json.example`\r
\r
## Tool: append_note\r
\r
| Argument | Type | Required | Description |\r
|----------|------|----------|-------------|\r
| `title` | string | yes | Note title; used as filename |\r
| `content` | string | yes | Note body (Markdown supported) |\r
\r
**Success:** `已保存笔记:{title}`\r
\r
**Example call:**\r
\r
```json\r
{\r
"title": "感悟",\r
"content": "手上有钱,身体健康,才是人生的巅峰。"\r
}\r
```\r
\r
## Agent rules\r
\r
1. Infer `title` from user intent (or use a short category like 感悟 / 待办).\r
2. Call `append_note` with `title` and `content`.\r
3. Confirm success and mention notes are stored under `\x3Crepo>/mcp-server/notes/`.\r
\r
## References\r
\r
- Full setup: `{baseDir}/references/setup.md`\r
- Tool spec: `{baseDir}/references/tool-reference.md`\r
- Config template: `{baseDir}/references/openclaw.json.example`\r
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install note-sync - After installation, invoke the skill by name or use
/note-sync - Provide required inputs per the skill's parameter spec and get structured output
What is append-note?
Append notes to local Markdown files via MCP append_note. Use when the user asks to save ideas, reminders, or journal entries. It is an AI Agent Skill for Claude Code / OpenClaw, with 36 downloads so far.
How do I install append-note?
Run "/install note-sync" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is append-note free?
Yes, append-note is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does append-note support?
append-note is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created append-note?
It is built and maintained by laiguangwei (@lgwventrue); the current version is v1.0.1.