Obsidian CLI 探索记录

更新时间：2026-03-05

简介

Obsidian CLI 是一个命令行工具，用于操作 Obsidian vault（笔记库）。它可以完成搜索、创建、移动、删除笔记等操作。

环境配置

• 默认 Vault：/Users/luoxiaohei/.openclaw/obsidian_workspace
• 设置默认 Vault：obsidian-cli set-default "\x3Cvault路径>"

命令列表

1. create - 创建笔记

obsidian-cli create "笔记名" --content "内容"

参数：

示例：

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

常用命令速查

注意事项

1. Vault 路径：CLI 通过 ~/Library/Application Support/obsidian/obsidian.json 获取 vault 信息
2. Wiki 链接：move 命令会自动更新 wiki 链接，这是相比普通 mv 的优势
3. 搜索问题：search-content 在部分环境可能有兼容性问题
4. 默认 Vault：建议先设置默认 vault，避免每次都要指定 -v 参数