用途:面向本地 Obsidian 仓库(Markdown 文件加 .obsidian/ 配置的普通文件夹)的读写与查询工作。仓库默认名为 obsidian,常见路径为 ~/obsidian;官方 CLI 为 obsidian,仓库类命令需在仓库目录(如 ~/obsidian)下运行,全局命令 version、vaults 可在仓库外使用。若提示 CLI 被禁用,应请用户在 设置 -> 通用 -> 高级 -> 命令行界面 中启用,修改应用级配置后需重启 Obsidian。
主要能力:搜索与读取,包括 obsidian search query="OpenClaw" format=json、search:context、read、file、outline、backlinks、links、properties 等,均支持 format=json;已知路径时可用 sed、rg 直接读文件。写入方面支持 create 新建笔记、append 追加、daily:append 追加日记、move 移动并更新链接,简单编辑用 apply_patch 作用于 Markdown 文件。还支持 Bases 与插件发现:bases、base:views、base:query、plugins、plugins:enabled、commands filter= 等。
使用方式:先做检查,运行 command -v obsidian、obsidian version、obsidian vaults,再 cd ~/obsidian 后执行仓库命令;用 obsidian commands(而非 obsidian help)发现 CLI 命令。写操作选择最窄路径,长文本优先用 apply_patch 编辑 .md 文件,避免复杂 shell 引号。
限制与安全:不要批量重写仓库,使用定向路径并审查差异;除非用户要求,不编辑 .obsidian/;不删除笔记,优先移入回收站;不通过 URI/CLI 创建隐藏点目录笔记;保留 frontmatter 与 wikilinks,除非任务就是重构它们;多仓库存在时不要猜测,用 obsidian vaults 与 obsidian.json 确认。.canvas、.base、.json 按结构化数据处理,编辑后校验 JSON。