← Back to Skills Marketplace
lgwventrue

append-note

by laiguangwei · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ Security Clean
36
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install note-sync
Description
Append notes to local Markdown files via MCP append_note. Use when the user asks to save ideas, reminders, or journal entries.
README (SKILL.md)

\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
Usage Guidance
Install only if you want an agent-accessible tool that can save selected chat text to local Markdown files. Review the external go-note-sync-mcp repository and built executable before configuring it, and avoid saving passwords, API keys, private messages, or sensitive personal data unless local disk retention is acceptable.
Capability Assessment
Purpose & Capability
The stated purpose is to save ideas, reminders, journal entries, and chat text to local Markdown files through an append_note MCP tool; the file-writing capability fits that purpose.
Instruction Scope
The agent rules only direct use when the user wants content saved, then require confirming the storage location. Users should still treat saved note content as durable local data.
Install Mechanism
Setup is manual and requires an external go-note-sync-mcp repository, a built Windows executable, NOTE_SYNC_REPO, and MCP server configuration. The bundled launcher only validates the env var and execs the configured binary.
Credentials
The required environment variable and MCP configuration are proportionate for a local note-writing integration, and the inspected artifacts do not show broad filesystem scanning, credential access, network exfiltration, or destructive behavior.
Persistence & Privilege
Persistence is the core feature: notes are stored under $NOTE_SYNC_REPO/mcp-server/notes/ as Markdown files. This is disclosed, but retention continues until the user deletes those files.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install note-sync
  3. After installation, invoke the skill by name or use /note-sync
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Updated version to 1.0.2 in SKILL.md. - Expanded documentation for Windows build and configuration steps. - Added detailed instructions for MCP setup, environment variables, and config. - Improved guidance on tool usage and agent rules. - Clarified storage location for saved notes.
v1.0.0
- Initial release of note-sync skill. - Enables appending thoughts, insights, and to-do items to local Markdown notes via the MCP append_note tool. - Requires configuration of note-sync MCP server and exe path for Windows or WSL environments. - Automatically extracts title and content from user prompts for note creation. - Notes are saved in the exe's notes/ directory and grouped by title. - Provides clear setup instructions for both Windows and WSL.
Metadata
Slug note-sync
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

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.

💬 Comments