免费在 GitHub 公开中文介绍

obsidian

通过Obsidian官方CLI搜索、创建和编辑笔记，更新每日记录与任务，检查链接和属性，也可指定操作的笔记库。

原文查看原文说明

Work with Obsidian vaults using the official obsidian CLI: read/search/create/edit notes, tasks, links, properties, plugins.

openclaw/openclaw

集成工具Obsidian

AI 评分90分/ 100 查看安装方法

适用场景

查找会议笔记与项目记录
向每日笔记追加记录
查看并完成未完成任务
检查属性及无法解析的链接

中文介绍

功能

obsidian通过官方obsidian CLI操作Obsidian笔记库，即vault。它可以阅读、搜索、创建、追加、移动和删除笔记，也可更新每日笔记、列出未完成任务并标记完成。此外，还能查看标签、属性、指向笔记的反向链接，以及无法解析的链接。

适用场景

适合查找会议笔记或项目记录，也可让智能体更新每日记录和任务。拥有多个笔记库时，可以指定操作对象。需要批量修改正文时，也可先确认笔记库的存储位置，再直接编辑Markdown文件。

使用示例

“请搜索会议笔记，并阅读相关笔记。”
“请在今天的每日笔记中添加一项检查收件箱的任务。”
“请检查未完成任务，以及包含无法找到目标链接的笔记。”

注意事项

需要Obsidian 1.12.7或更高版本。在设置中启用Command line interface，将obsidian加入PATH，并保持应用运行，因为官方CLI会连接正在运行的应用。应按情况使用笔记名称或精确路径。只有收到相关请求时才编辑.obsidian/设置文件夹。

本介绍由 AI（OpenAI Codex）根据公开的 SKILL.md 撰写。准确的规格请查看下方原文。

客观评估

AI 仅根据 SKILL.md 的内容，从 4 个方面进行了评估。星标数和热度不计入评估。

指令清晰度能否看出何时使用、做什么: A良好明确说明通过官方obsidian CLI操作笔记、任务、链接和属性。
步骤具体性步骤、输入输出和示例是否具体: A良好提供搜索、创建、删除和任务更新命令，并说明名称定位与精确路径的区别。
安全性发送数据、删除文件、执行命令等是否有说明: B部分不足包含删除及直接编辑，也限制配置修改，但未说明删除或覆盖文件前的确认步骤。
安装难易度所需工具和 API 密钥是否少且有说明: A良好说明了Obsidian版本、CLI启用、PATH注册、应用运行要求和检查命令。

总分按每项 A=25 分、B=15 分、C=5 分相加。由 AI（OpenAI Codex）于 2026年10月19日评估。仅供参考，安装前请同时查看原文。

如果您认为评估有误，请申请复核

包含的文件（1）

SKILL.md2.9 KB

SKILL.md（原文）

安装前可以查看交给 AI 代理的指令内容。

Obsidian

Use the official obsidian CLI for Obsidian vault work. Vault files are plain Markdown, so direct file edits are still fine when safer/faster.

Requirements

Obsidian 1.12.7+ installed.
Settings -> General -> Command line interface enabled.
obsidian registered on PATH.
Obsidian app running; the CLI connects to the running app.

Check:

obsidian version
obsidian help

macOS registration creates /usr/local/bin/obsidian pointing at the app-bundled CLI. Linux registration copies the binary to ~/.local/bin/obsidian.

Vault model

Notes: *.md.
Config: .obsidian/; avoid editing unless asked.
Canvases: *.canvas JSON.
Attachments: vault-configured folder.
Multiple vaults are common; pass vault="<name>" when ambiguous.

Obsidian desktop tracks vaults here:

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

Command pattern

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

Parameter values with spaces need quotes. Add --copy to copy output where useful.

Common commands

Open/read:

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

Search:

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

Create/modify:

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"

Move/delete:

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

Daily/tasks:

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

Properties/links:

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

Developer/debug:

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

Notes

file=<name> uses Obsidian-style file resolution; path=<vault-relative.md> is exact.
Prefer CLI move/delete/property commands for Obsidian-aware updates.
Prefer direct Markdown edits for bulk text changes after locating the vault path.
Do not rely on third-party obsidian-cli unless user explicitly asks for it.