claw-memo-obsidian:把 Agent 核心 Markdown 同步進 Obsidian

前言

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 用戶信息

歸檔與元數據

  1. 在 Vault 下按「同步文件夾 / YYYY-MM-DD」組織目錄,例如 muliu_memo/2026-04-02/。
  2. 爲每個文件添加 Frontmatter(created、source、type、tags 等),便於 Obsidian 檢索。
  3. 支持自然語言或 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 共用一套同步約定。

限制與注意

  1. 需本機存在可寫的 Obsidian Vault;默認路徑在腳本里是作者環境示例,新機器務必用 --vault 或 OBSIDIAN_VAULT_PATH 覆蓋。
  2. 包內 README.md、QUICKSTART.md 仍出現舊名 memo-sync 與示例路徑,與當前 claw-memo-obsidian 文件名並存;執行時以 claw-memo-obsidian.py 與 SKILL.md 爲準。
  3. SkillHub 統計(抓取時):評分 100000,下載 1087,安裝 8;社區源技能,使用前可在 SkillHub 頁面自行覈對更新與安全說明。
  4. 刪除類操作務必走技能要求的二次確認,避免 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

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜