obsidian-cli-skills OpenClaw Skill

Obsidian CLI enables managing Obsidian vaults via command line, supporting note creation, search, move with wiki link update, delete, frontmatter edit, daily...

v1.0.0 Updated 1 mo ago

Installation

clawhub install obsidian-cli-skills

Requires npm i -g clawhub

492

Downloads

0

Stars

2

current installs

2 all-time

1

Versions

Obsidian CLI 探索记录

更新时间:2026-03-05

简介

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

环境配置

  • 默认 Vault/Users/luoxiaohei/.openclaw/obsidian_workspace
  • 设置默认 Vaultobsidian-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 "名"

注意事项

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

Statistics

Downloads 492
Stars 0
Current installs 2
All-time installs 2
Versions 1
Comments 0
Created Mar 5, 2026
Updated Mar 5, 2026

Latest Changes

v1.0.0 · Mar 5, 2026

Initial release of obsidian-cli-skills. - Provides comprehensive documentation for all obsidian-cli commands, options, and usage examples. - Covers creating, editing, searching, moving, and deleting notes from the command line. - Includes instructions for handling frontmatter, managing multiple vaults, and generating shell completion scripts. - Features a quick reference table for common commands and highlights important usage notes.

Quick Install

clawhub install obsidian-cli-skills
EU Made in Europe

Chat with 100+ AI Models in one App.

Use Claude, ChatGPT, Gemini alongside with EU-Hosted Models like Deepseek, GLM-5, Kimi K2.5 and many more.