前言¶
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