⚡ Obsidian 拓展技能

核心推荐 · 生产力 & 任务

无缝连接与管理您的 Obsidian 知识库——支持智能查找、笔记创建与编辑，并可通过 obsidian-cli 在移动文件时自动重构全程 [[wikilink]] 双向链接。

OpenClaw Team

🚀 快速安装

在您的终端中执行以下命令即可完成安装：

npx clawhub install obsidian

📊 数据总览

⭐ 收藏点赞	☁️ 总计下载	👥 当前活跃	🎯 稳定版本
1.5k	52.3w	6,200	v2.0.1

🎛️ 详解：它是如何工作的？

本拓展技能赋予了 AI 助手直接访问并操作本地 Obsidian 知识库（纯 Markdown 格式）的完整能力。系统会自动解析 obsidian.json 配置文件，完美适应多 Vault、iCloud 云盘以及自定义路径的复杂环境：

🔍 智能语义检索：不仅支持传统的文件名与标题匹配，更内建了基于向量的全文语义搜索引擎。当您只记得一个模糊的灵感片段，它也能在海量卡片中为您瞬间定位原文。
📝 智能内容管理：基于自然语言指令自动整理、追加内容，或直接生成格式完备的新笔记。支持 YAML frontmatter 元数据注入、标签自动归类、模板变量动态替换等高级操作。
🔗 跨链重构维护：在重命名或移动笔记时，自动遍历并更新全库范围内所有关联的 [[wikilink]] 双向链接与 ![[embed]] 嵌入引用，从源头杜绝死链产生。
📂 多 Vault 统筹调度：单一会话内即可在多个独立知识库之间切换操作，适用于"工作 + 个人 + 学术"多知识域并行管理的重度用户场景。

🧭 典型业务场景剖析

🧠 场景一：个人知识管家

将 AI 当作第二大脑管理员。让其自动梳理每日待办、提炼总结阅读长文的核心论点，并根据工作上下文自主完成双向链接重构与归档操作。

📅 场景二：模板化日记与复盘

可配置为每天自动按模板要求插入附带日期和标签元数据的晨间计划表与晚间总结日志，让日常灵感随时结构化落盘，形成可追溯的个人成长链路。

🌲 场景三：大库架构重组

面对极为分散的早期旧笔记（数千甚至上万篇），AI 能够执行完全安全的大规模多层级分类转移操作。它会先进行只读模拟演练并生成变更预览清单，待您确认后再批量执行。

⚡ 场景四：自然语言闪查

用纯自然语言向助手描述您模糊的灵感记忆碎片，它能在海量的笔记卡片中为您瞬间定位内容，呈现出完整的历史上下文与关联网络图谱。

💻 常用命令参考

安装完成后，您不仅可以通过对话让 AI 自主调用，还可以在 CLI 侧手动发起操作：

在指定 Vault 中执行自然语言搜索：

clawhub obsidian search "分布式系统笔记" --vault ~/Documents/MyVault

创建一篇带有 frontmatter 元数据的新笔记：

clawhub obsidian create "每周复盘" --template weekly-review --tags "复盘,GTD"

安全地重命名笔记并自动更新全库反向链接：

clawhub obsidian rename "旧标题.md" "新标题.md" --update-links

执行跨文件夹批量迁移（先预览，再确认）：

clawhub obsidian move "inbox/*.md" --to "archive/2026/" --dry-run

🛡️ 环境要求与安全说明

📑 Obsidian 桌面端：需要预先安装 Obsidian 桌面客户端（v1.4+），以便系统能正确使用 obsidian:// URI 协议。
🛠️ obsidian-cli：命令行拓展工具。Mac 用户通过 brew install obsidian-cli 部署；Windows 用户使用 winget install obsidian-cli。
🔒 本地优先：所有笔记操作均在本地文件系统完成，不上传任何内容至云端第三方服务器。

🔗 查看 GitHub 源代码