一種筆記技能，使 AI 代理能夠使用 Model Context Protocol (MCP) 工具將想法、提醒和日記條目追加到本機 Markdown 檔案中。
安裝與下載
1. ClawHub CLI
從來源直接安裝技能的最快方式。
npx clawhub@latest install note-sync
2. 手動安裝
將技能資料夾複製到以下位置之一
~/.openclaw/skills/ <project>/skills/ 優先級：工作區 > 本地 > 內建
3. 提示詞安裝
將此提示詞複製到 OpenClaw 即可自動安裝。
請幫我使用 Clawhub 安裝 note-sync。如果尚未安裝 Clawhub，請先安裝（npm i -g clawhub）。
想要直接下載？
取得包含原生技能檔案的ZIP壓縮檔。
什麼是 Note Sync？
Note Sync 是一項旨在彌合 AI 對話與個人知識管理之間鴻溝的整合工具。透過利用本機執行的自訂 Model Context Protocol (MCP) 伺服器，該技能使 AI 助手能夠將對話訊息、腦力激盪的想法和行動項目直接儲存到本機檔案中。對於希望在不離開 AI 工作區的情況下將見解整理在磁碟上的開發者和進階使用者來說，它是 Openclaw Skills 中的重要組件。
該技能透過 append_note 工具運作，允許助手安全地與主機或 Windows Subsystem for Linux (WSL) 環境中的本機儲存進行互動。它處理檔案寫入，直接在指定的標題下追加筆記，並根據使用者意圖自動分類資訊。這使您的個人筆記、日記和任務清單能夠完全以本機 Markdown 格式保持結構化。
Note Sync 應用場景
- 在 AI 對話期間自動擷取稍縱即逝的想法、見解或程式碼片段，並直接儲存於本機日記中。
- 透過將新項目追加到專用檔案中來維護任務積壓或待辦事項清單。
- 將 AI 分析期間產生的研究筆記或多步驟行動計畫直接匯總到磁碟。
- 無需手動複製貼上，即可在本機 Markdown 檔案中組織個人日記或日常日誌。
Note Sync 運作原理
- 使用者請求 AI 代理儲存或記錄資訊（例如：「將這個想法儲存到我的日記中」）。
- AI 助手觸發 append_note 工具，自動推斷檔名（例如「journal」或「todo」）並建構 Markdown 內容。
- note-sync MCP 伺服器接收指令，並將新的文字區塊安全地追加到指定的本機 Markdown 檔案中。
- 伺服器傳回成功確認訊息，更新 AI 代理，以便其通知使用者筆記已安全儲存於工作區中。
Note Sync 設定指南
請依照下列步驟設定 Note Sync，這是最可靠的 Openclaw Skills 生產力工具之一：
第 1 步：複製儲存庫並建構 MCP 二進位檔案
將輔助儲存庫複製到您的機器（或 WSL 內）並編譯 Go 可執行檔：
git clone https://github.com/your-org/go-note-sync-mcp.git
cd go-note-sync-mcp/mcp-server
go build -o note-sync-mcp.exe
確保環境變數 NOTE_SYNC_REPO 直接指向此複製目錄的根目錄。
第 2 步：設定 openclaw.json
編輯您的 Openclaw 設定檔（通常位於 ~/.openclaw/openclaw.json），以註冊該技能及其本機 MCP 伺服器。將 <WSL_REPO> 取代為您的本機儲存庫路徑，將 <SKILL_DIR> 取代為 ClawHub 安裝該技能的位置（通常為 ~/.openclaw/skills/note-sync）：
{
"skills": {
"entries": {
"note-sync": {
"enabled": true,
"env": {
"NOTE_SYNC_REPO": "<WSL_REPO>"
}
}
}
},
"mcp": {
"servers": {
"note-sync": {
"command": "<SKILL_DIR>/scripts/note-sync-mcp.sh",
"args": []
}
}
}
}
第 3 步：重啟閘道並驗證
重啟閘道程序並檢查該技能和工具是否已正確載入：
openclaw gateway restart
openclaw skills info note-sync
openclaw mcp list
成功後，append_note 工具應顯示在終端機清單中。
Note Sync 資料結構與分類體系
Note Sync 技能在您的本機檔案系統 <repo>/mcp-server/notes/ 目錄下動態管理資料。每個筆記都儲存為一個獨立的 Markdown (.md) 檔案，並使用推斷出的標題作為檔名。
目錄配置
<NOTE_SYNC_REPO>/
└── mcp-server/
├── notes/
│ ├── 感悟.md
│ ├── 待辦.md
│ └── journal.md
└── note-sync-mcp.exe
MCP 工具參數架構
主要的工具介面 append_note 需要以下 JSON 結構的有效負載：
| 參數 | 類型 | 必需 | 說明 |
|---|---|---|---|
title |
string | 是 | 筆記的檔名和標題（例如 'journal', 'todo'） |
content |
string | 是 | 要追加到檔案中的 Markdown 相容內容本體 |
Note Sync 進階特性
- WSL 與 Windows 原生互操作性：旨在透過跨越 WSL 邊界啟動 Windows
.exe檔案的 shell 封裝器，在不同環境中無縫執行。 - 自訂目錄覆寫：輕鬆調整路徑設定，將您的筆記直接儲存到 Obsidian 保險庫目錄或 Logseq 圖譜中。
- 動態標題推斷：利用 LLM 驅動的智慧來分析對話情境，並在無須使用者提示的情況下自動將筆記分類到相應的檔案中。
- Model Context Protocol 整合：利用強大的 MCP 工具標準，確保與其他 Openclaw Skills 和現代代理介面的高度相容性。
SKILL.md
加載中
Openclaw 相關技能
Metabolical 食物與健康工具包
一個 AI 代理技能，將 Robert Lustig 博士的 Metabolical 框架轉化為可操作的營養原則，以保護肝臟、滋養腸道並逆轉慢性疾病。
精選*
