name: obsidian description: 使用 Obsidian 知识库（纯 Markdown 笔记）并通过 obsidian-cli 实现自动化。 homepage: https://help.obsidian.md metadata: { “openclaw”: { “emoji”: “💎”, “requires”: { “bins”: [“obsidian-cli”] }, “install”: [ { “id”: “brew”, “kind”: “brew”, “formula”: “yakitrak/yakitrak/obsidian-cli”, “bins”: [“obsidian-cli”], “label”: “安装 obsidian-cli (brew)”, }, ], }, }
Obsidian
Obsidian 知识库 = 磁盘上的普通文件夹。
知识库结构（典型）
- 笔记：
*.md（纯文本 Markdown；可用任何编辑器编辑） - 配置：
.obsidian/（工作空间和插件设置；通常不从脚本中修改） - 画布：
*.canvas（JSON） - 附件：在 Obsidian 设置中选择的任何文件夹（图片/PDF 等）
查找活动知识库
Obsidian 桌面版在此处跟踪知识库（权威来源）：
~/Library/Application Support/obsidian/obsidian.json
obsidian-cli 从该文件解析知识库；知识库名称通常是文件夹名称（路径后缀）。
快速查找“哪个知识库是活动的/笔记在哪里？”
- 如果您已设置默认知识库：
obsidian-cli print-default --path-only - 否则，读取
~/Library/Application Support/obsidian/obsidian.json并使用"open": true的知识库条目。
注意
- 多个知识库很常见（iCloud 与
~/Documents、工作/个人等）。不要猜测；读取配置。 - 避免将硬编码的知识库路径写入脚本；优先读取配置或使用
print-default。
obsidian-cli 快速入门
选择一个默认知识库（一次）：
obsidian-cli set-default "<知识库文件夹名称>"obsidian-cli print-default/obsidian-cli print-default --path-only
搜索
obsidian-cli search "查询"（笔记名称）obsidian-cli search-content "查询"（笔记内容；显示片段和行号）
创建
obsidian-cli create "文件夹/新笔记" --content "..." --open- 需要 Obsidian URI 处理器（
obsidian://…）正常工作（已安装 Obsidian）。 - 避免通过 URI 在“隐藏”的点文件夹（例如
.something/...）下创建笔记；Obsidian 可能会拒绝。
移动/重命名（安全重构）
obsidian-cli move "旧路径/笔记" "新路径/笔记"- 更新整个知识库中的
[[wikilinks]]和常见 Markdown 链接（这是相对于mv命令的主要优势）。
删除
obsidian-cli delete "路径/笔记"
在适当时优先选择直接编辑：打开 .md 文件并进行更改；Obsidian 会识别它。