Obsidian CLI 探索记录
更新时间：2026-03-05
简介
Obsidian CLI 是一个命令行工具，用于操作 Obsidian vault（笔记库）。它可以完成搜索、创建、移动、删除笔记等操作。
环境配置
- 默认 Vault：
/Users/luoxiaohei/.openclaw/obsidian_workspace - 设置默认 Vault：
obsidian-cli set-default "<vault路径>"
命令列表
1. create - 创建笔记
obsidian-cli create "笔记名" --content "内容"
参数：
| 参数 | 简写 | 说明 |
|---|---|---|
| --content | -c | 笔记内容 |
| --open | -o | 创建后打开笔记 |
| --overwrite | -o | 覆盖已存在的笔记 |
| --append | -a | 追加到已存在的笔记 |
| --vault | -v | 指定 vault 名称 |
示例：
obsidian-cli create "新笔记" --content "这是笔记内容"
obsidian-cli create "test-note" --content "This is a test note" --open
2. print - 打印笔记内容
obsidian-cli print "笔记名"
示例：
obsidian-cli print "test-note"
# 输出: This is a test note
3. search - Fuzzy 搜索
obsidian-cli search "关键词"
说明： 交互式搜索，会打开 Obsidian 让你选择笔记。
4. search-content - 全文搜索
obsidian-cli search-content "关键词"
说明： 在笔记内容中搜索包含指定关键词的笔记。
⚠️ 注意： 当前版本测试有问题，可能需要指定 vault 参数。
5. move - 移动/重命名笔记
obsidian-cli move "旧路径" "新路径"
特点： 移动时会自动更新 wiki 链接。
示例：
obsidian-cli move "test-note" "test-note-moved"
# 输出: Moved note from .../test-note.md to .../test-note-moved.md
6. delete - 删除笔记
obsidian-cli delete "笔记名"
示例：
obsidian-cli delete "test-note-moved"
# 输出: Deleted note: /Users/luoxiaohei/.openclaw/obsidian_workspace/test-note-moved.md
7. frontmatter - 查看/修改 YAML 头信息
# 查看 frontmatter
obsidian-cli frontmatter "笔记名" --print
# 修改 frontmatter
obsidian-cli frontmatter "笔记名" --edit --key "key名" --value "值"
# 删除 frontmatter
obsidian-cli frontmatter "笔记名" --delete --key "key名"
示例：
# 查看
obsidian-cli frontmatter "test-note" --print
# 添加/修改
obsidian-cli frontmatter "test-note" --edit --key "tags" --value "test,cli"
# 删除
obsidian-cli frontmatter "test-note" --delete --key "draft"
8. daily - 创建/打开每日笔记
obsidian-cli daily
说明： 自动创建或打开当天的每日笔记（格式：YYYY-MM-DD.md）。
9. open - 在 Obsidian 中打开笔记
obsidian-cli open "笔记名"
示例：
obsidian-cli open "my-note"
10. print-default - 查看默认 Vault
obsidian-cli print-default
obsidian-cli print-default --path-only # 只显示路径
输出示例：
Default vault name: obsidian_workspace
Default vault path: /Users/luoxiaohei/.openclaw/obsidian_workspace
11. set-default - 设置默认 Vault
obsidian-cli set-default "vault名称或路径"
示例：
obsidian-cli set-default "obsidian_workspace"
obsidian-cli set-default "/Users/luoxiaohei/.openclaw/obsidian_workspace"
12. completion - 生成自动补全脚本
obsidian-cli completion [shell]
支持的 shell： bash, zsh, fish, powershell
示例：
obsidian-cli completion zsh
常用命令速查
| 功能 | 命令 |
|---|---|
| 查看默认 vault | obsidian-cli print-default |
| 设置默认 vault | obsidian-cli set-default "vault名" |
| 创建笔记 | obsidian-cli create "名" --content "内容" |
| 查看笔记 | obsidian-cli print "名" |
| 搜索笔记名 | obsidian-cli search "关键词" |
| 全文搜索 | obsidian-cli search-content "关键词" |
| 移动/重命名 | obsidian-cli move "旧" "新" |
| 删除笔记 | obsidian-cli delete "名" |
| 查看头信息 | obsidian-cli frontmatter "名" --print |
| 修改头信息 | obsidian-cli frontmatter "名" --edit --key "x" --value "y" |
| 每日笔记 | obsidian-cli daily |
| 在 Obsidian 打开 | obsidian-cli open "名" |
注意事项
- Vault 路径：CLI 通过
~/Library/Application Support/obsidian/obsidian.json获取 vault 信息 - Wiki 链接：
move命令会自动更新 wiki 链接，这是相比普通 mv 的优势 - 搜索问题：
search-content在部分环境可能有兼容性问题 - 默认 Vault：建议先设置默认 vault，避免每次都要指定
-v参数