← 返回 Skills 市场
lgwventrue

append-note

作者 laiguangwei · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ 安全检测通过
36
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install note-sync
功能描述
Append notes to local Markdown files via MCP append_note. Use when the user asks to save ideas, reminders, or journal entries.
使用说明 (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
安全使用建议
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.
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install note-sync
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /note-sync 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
Slug note-sync
版本 1.0.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

append-note 是什么?

Append notes to local Markdown files via MCP append_note. Use when the user asks to save ideas, reminders, or journal entries. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 36 次。

如何安装 append-note?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install note-sync」即可一键安装,无需额外配置。

append-note 是免费的吗?

是的,append-note 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

append-note 支持哪些平台?

append-note 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 append-note?

由 laiguangwei(@lgwventrue)开发并维护,当前版本 v1.0.1。

💬 留言讨论