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

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

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

Xiaoye