mcpField
O
obsidian

obsidian

github.com/openclaw生产力393.3k6.4k 次安装今天更新
代码仓库

关于 obsidian

通过 Obsidian 官方命令行操作 Vault 的技能，涵盖笔记管理、搜索、任务、属性、链接和开发命令，也支持直接编辑 Markdown。

主要功能

  1. 01打开、读取和搜索笔记
  2. 02创建和编辑 Markdown 笔记
  3. 03移动和删除 Vault 文件
  4. 04管理每日笔记和任务
  5. 05查看属性、标签和反向链接
  6. 06运行插件和开发命令

适用场景

  1. 01查找符合查询条件的笔记
  2. 02更新笔记和 Vault 属性
  3. 03查看或完成任务列表
  4. 04调试 Obsidian 插件

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/openclaw/openclaw --skill obsidian

安装后在 Claude Code 中输入/obsidian确认已加载。

详细介绍

Obsidian

处理 Obsidian 仓库工作时，使用官方 obsidian CLI。仓库文件是纯 Markdown，因此直接编辑文件通常更安全或更高效时，仍可这样做。

要求

  • 已安装 Obsidian 1.12.7+。
  • 设置 -> 常规 -> 命令行界面已启用。
  • obsidian 已注册到 PATH。
  • Obsidian 应用正在运行；CLI 连接到运行中的应用。

检查：

obsidian version
obsidian help

在 macOS 上注册会创建 /usr/local/bin/obsidian，指向应用内置的 CLI。在 Linux 上注册会将二进制文件复制到 ~/.local/bin/obsidian。

仓库模型

  • 笔记：*.md。
  • 配置：.obsidian/；除非用户要求，否则避免编辑。
  • 画布：JSON 格式的 *.canvas。
  • 附件：仓库中配置的文件夹。
  • 通常会有多个仓库；有歧义时，请传入 vault="<name>"。

Obsidian 桌面应用在此记录仓库：

  • ~/Library/Application Support/obsidian/obsidian.json

命令模式

obsidian <command> [name=value] [flag]
obsidian vault="Notes" search query="meeting notes" format=json

参数值中包含空格时，需要加引号。必要时添加 --copy 以复制输出。

常用命令

打开/读取：

obsidian open file=Recipe
obsidian open path="Inbox/Idea.md" newtab
obsidian read
obsidian read file=Recipe

搜索：

obsidian search query="TODO" matches
obsidian search query="status::active" format=json
obsidian search:open query="project notes"

创建/修改：

obsidian create name="New Note"
obsidian create path="Inbox/Idea.md" content="# Idea"
obsidian append file=Note content="New line"
obsidian prepend file=Note content="After frontmatter"

移动/删除：

obsidian move file=Note to=Archive/
obsidian move path="Inbox/Old.md" to="Projects/New.md"
obsidian delete file=Note

每日笔记/任务：

obsidian daily
obsidian daily:read
obsidian daily:append content="- [ ] Review inbox"
obsidian tasks all todo
obsidian task file=Note line=8 done

属性/链接：

obsidian tags all counts
obsidian property:read file=Note name=status
obsidian property:set file=Note name=status value=done
obsidian backlinks file=Note
obsidian unresolved verbose counts

开发/调试：

obsidian plugin:reload my-plugin
obsidian dev:errors
obsidian dev:screenshot file=shot.png
obsidian eval "app.vault.getFiles().length"

注意事项

  • file=<name> 使用 Obsidian 风格的文件解析机制；path=<vault-relative.md> 则指定精确路径。
  • 对于需要感知 Obsidian 的更新，优先使用 CLI 的移动、删除和属性命令。
  • 定位仓库路径后，对于批量文本修改，优先直接编辑 Markdown。
  • 除非用户明确要求，否则不要依赖第三方 obsidian-cli。

评论

支持 Markdown