前言¶
OpenClaw、Claude Code、Codex 等工作區裏,助手身份與記憶往往落在 AGENTS.md、MEMORY.md 等固定文件名上。這些文件適合被 Agent 讀寫,卻不一定方便你在 Obsidian 裏按日期瀏覽、打標籤或和筆記庫打通。手工複製粘貼容易漏文件,也難保持 Frontmatter 一致。
下面介紹社區 Skill claw-memo-obsidian(座標 @user_5bab6d4d/claw-memo-obsidian):安裝後可用自然語言或腳本,把上述核心文件寫入 Obsidian Vault,並按日期分文件夾歸檔。SkillHub 分類爲 knowledge-management,當前上架版本 1.0.1,標籤標明 requires_api_key=false(無需 API Key)。
這是什麼¶
claw-memo-obsidian 是 SkillHub 社區源(發佈者 user_5bab6d4d)發佈的 Agent Skill,基於通用 SKILL.md 約定,附帶 Python / Bash 同步腳本。名稱可理解爲 Claw(智能體工作區)+ Memo(記憶歸檔)+ Obsidian。
技能包內文檔由作者「木流 2 號」維護,面向「把智能體核心配置文件同步到 Obsidian 知識庫」這一件事:默認處理五個 Markdown,重命名爲帶序號的 Obsidian 友好文件名,並注入 YAML Frontmatter。
核心功能¶
以下能力來自已安裝技能包中的 SKILL.md 與 claw-memo-obsidian.py,可與 SkillHub 元數據交叉覈對。
默認同步的文件¶
| 源文件(工作區) | 寫入 Obsidian 的文件名 | 說明 |
|---|---|---|
AGENTS.md |
01-AGENTS.md |
助手工作區配置 |
IDENTITY.md |
02-IDENTITY.md |
助手身份 |
MEMORY.md |
03-MEMORY.md |
長期記憶 |
SOUL.md |
04-SOUL.md |
助手靈魂 / 人格 |
USER.md |
05-USER.md |
用戶信息 |
歸檔與元數據¶
- 在 Vault 下按「同步文件夾 /
YYYY-MM-DD」組織目錄,例如muliu_memo/2026-04-02/。 - 爲每個文件添加 Frontmatter(
created、source、type、tags等),便於 Obsidian 檢索。 - 支持自然語言或
YYYY-MM-DD指定日期(如「昨天」「3 天前」),以及-f只同步部分文件。
多智能體與工作區¶
腳本支持 --agent openclaw | claude-code | codex | unknown,並帶有按智能體區分子目錄的默認映射(如 OpenClaw → muliu_memo,Claude Code → claude_memo,Codex → codex_memo)。技能說明中還描述了從工作區路徑向上查找 AGENTS.md、按工作區名稱推導 *_memo 文件夾等行爲,用於多 Agent 共用同一套工具時減少寫錯目錄。
安全相關¶
清理模式(--clean)在刪除日期文件夾前要求二次確認;自動化場景可用 --confirmed 跳過確認。Skill 文本明確要求 Agent 在用戶未明確確認時不要執行刪除。
技能內標註的後續能力¶
SKILL.md 中「擴展功能(未來)」列出增量同步、雙向同步等條目,當前仍爲規劃項,本文不當作已發佈能力。
安裝與啓用¶
1. 安裝 SkillHub CLI(若尚未安裝)¶
command -v skillhub && skillhub --version
未安裝時可按 SkillHub 官方說明執行:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
完整安裝說明見:https://skillhub.cn/install/skillhub.md
2. 安裝 claw-memo-obsidian¶
安裝時必須用 --dir 指向當前 Agent 的 skills 目錄,否則默認落在 ./skills/ 且可能不被識別。官方頁面給出的安裝方式爲:
skillhub install claw-memo-obsidian --namespace user_5bab6d4d --dir <你的 skills 目錄>
常見路徑示例(來自 SkillHub 安裝文檔):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或項目下的.agents/skills/
也可讓 Agent 按同一文檔安裝:請根據 https://skillhub.cn/install/skillhub.md,安裝 @user_5bab6d4d/claw-memo-obsidian。
安裝完成後重啓或重新加載 Agent,使 Skill 生效。
3. 配置 Vault 與同步行爲(可選)¶
環境變量(腳本默認值以用戶主目錄爲基準,部署後請按本機修改):
| 變量 | 作用 |
|---|---|
OBSIDIAN_VAULT_PATH |
Obsidian Vault 根路徑 |
MEMO_SYNC_FOLDER |
Vault 內同步子文件夾名(全局 fallback) |
MEMO_SYNC_FILES |
逗號分隔的同步文件列表 |
JSON 配置文件查找順序(claw-memo-obsidian.py):當前工作目錄 .memo-sync-config.json → 用戶主目錄 ~/.memo-sync-config.json → /etc/memo-sync/config.json。可在 JSON 的 agents 字段爲不同智能體設置 sync_folder 等項。
典型用法¶
在對話中觸發(推薦)¶
向已加載該 Skill 的 Agent 說明意圖即可,例如:
同步核心文件到 Obsidian
或指定日期、文件:
把 MEMORY.md 同步到昨天的文件夾
同步 AGENTS.md 和 USER.md 到 Obsidian
Skill 文檔列出可觸發說法(含 claw-memo-obsidian、memo sync 等),並說明「創建 claw-memo-obsidian」類表述不應誤當作使用技能。
命令行(技能目錄內腳本)¶
進入安裝後的技能目錄(路徑因 --dir 而異),使用 Python 入口:
python3 claw-memo-obsidian.py
python3 claw-memo-obsidian.py -d 2026-04-01
python3 claw-memo-obsidian.py -f AGENTS.md MEMORY.md
python3 claw-memo-obsidian.py --vault ~/MyVault
python3 claw-memo-obsidian.py --agent claude-code
python3 claw-memo-obsidian.py --config ~/.my-config.json
同目錄還提供 claw-memo-obsidian.sh;其內仍含作者示例的絕對路徑,生產環境更宜以 Python 腳本與環境變量 / 配置文件爲準。
腳本 --version 輸出爲 claw-memo-obsidian 2.0.0,與 SkillHub 頁面版本號 1.0.1 並存時,以你本機安裝包內文件爲準。
適用場景與注意¶
適合誰
- 已在 Obsidian 管理個人知識庫,同時用 OpenClaw / Claude Code / Codex 等維護
AGENTS.md、MEMORY.md等核心文件。 - 需要按日期留檔、統一 Frontmatter,或讓多個 Agent 共用一套同步約定。
限制與注意
- 需本機存在可寫的 Obsidian Vault;默認路徑在腳本里是作者環境示例,新機器務必用
--vault或OBSIDIAN_VAULT_PATH覆蓋。 - 包內
README.md、QUICKSTART.md仍出現舊名memo-sync與示例路徑,與當前claw-memo-obsidian文件名並存;執行時以claw-memo-obsidian.py與SKILL.md爲準。 - SkillHub 統計(抓取時):評分 100000,下載 1087,安裝 8;社區源技能,使用前可在 SkillHub 頁面自行覈對更新與安全說明。
- 刪除類操作務必走技能要求的二次確認,避免 Agent 誤刪 Vault 內歷史文件夾。
結尾¶
claw-memo-obsidian 把 Agent 工作區裏幾份高價值 Markdown 變成 Obsidian 裏可檢索、可歸檔的筆記,併兼顧多智能體目錄隔離與自然語言觸發。若你已在用 SkillHub 管理 Skills,可按上文命令裝入對應 Agent 的 skills 目錄後試用。
官方頁面:https://www.skillhub.cn/skills/user_5bab6d4d/claw-memo-obsidian
API 座標:https://api.skillhub.cn/user_5bab6d4d/claw-memo-obsidian