Obsidian 的 Copilot 插件在PC端和手机端 Agent 功能都很弱,远落后于市面上成熟的 AI Agent 和 Claw 产品;想用 Copilot Plus 的那点 Agent 能力还得单独订阅付费。本文介绍一套更强大的方案:用成熟的 AI Agent + Obsidian CLI Skills,实现手机端和PC端双端的 Agent 辅助笔记管理、AI 主动维护知识库,能力远超 Copilot,而且不需要单独订阅。


一、背景与痛点

很多人用 Obsidian 花大量时间记笔记,底层需求其实是:让 AI 能读懂我的知识库,甚至帮我维护它

但 Obsidian 生态里的 AI 能力,现实很骨感:

痛点 1:Copilot 插件 Agent 能力很弱

Obsidian 社区里的 Copilot 插件,AI 能力远落后于市面上成熟的 Agent 产品(比如 Codex、Claude code、WorkBuddy 等)。它本质上是个封装了 API 调用的简单插件,没有真正的自主规划、多步执行能力。

痛点 2:想用 Agent 功能还得订 Copilot Plus

就算你觉得 Copilot 够用了,想用它那点"自主创建/修改笔记/理解整个仓库……"的功能,还得单独订阅 Copilot Plus,消耗 credit 才能用。花着钱,用着弱功能。

痛点 3:手机端基本没有 AI 入口

Obsidian 手机 App 里没有好用的 AI Agent。想让 Agent 理解整个仓库给你建议很难。想记一条笔记,要么手动打开手机 Obsidian 写,要么等回电脑。

痛点 4:坚果云同步需要手动触发


我想要的是什么

用成熟的 AI Agent(能力远超 Copilot)→ 理解整个仓库和我的意图 → 直接操作 Obsidian 笔记 → 自动同步到手机端

不订 Copilot Plus,不花冤枉钱,用真正强大的 AI 来维护知识库。本文完整记录我是怎么做到的。


二、整体架构

 手机微信或飞书等channels
        ↓ 发消息
    AI Agent
        ↓ 执行命令
    Obsidian CLI
        ↓ 操作笔记
    Obsidian Vault
        ↓ 触发同步
     坚果云同步
        ↓ 推送
    手机 Obsidian App

核心组件:

  • Obsidian:本地笔记管理,知识库本体
  • Obsidian CLI + Skills:命令行操控 Obsidian,AI Agent 的"手"
  • Nutstore Sync 插件:WebDAV 协议同步(非坚果云客户端)
  • AI Agent(WorkBuddy):理解用户意图,调用 CLI Skills 操作笔记

三、环境准备

3.1 安装 Obsidian CLI

Obsidian CLI 是官方提供的命令行工具,通过 URI 协议与正在运行的 Obsidian 通信,在 obsidian 中安装打开这个按钮即可完成安装。
请添加图片描述

# 验证安装
obsidian help

⚠️ 注意:Obsidian 必须处于运行状态,CLI 才能正常工作。

3.2 安装 Nutstore Sync 插件

在 Obsidian 社区插件市场搜索 Nutstore Sync(作者:nutstore,版本 1.2.1),安装并启用,然后登录。


四、关键配置:关闭两个确认弹窗(踩坑)

这是最关键的一步,也是我踩得最久的坑。

Nutstore Sync 插件默认有两个确认弹窗:

配置项 默认值 作用
confirmBeforeSync true 同步前弹确认框
confirmBeforeDeleteInAutoSync true 自动同步删除前弹确认框

问题:远程发消息给 PC 上的 Agent 用 CLI 触发同步后,确认框会在桌面端弹出,但没有界面交互,同步卡死,手机端永远收不到更新。

解决:修改插件配置,关闭这两个选项。

💡 建议同时开启 realtimeSync(实时同步),文件变动后自动同步,不需要手动触发。


五、给 Agent 配置 Obsidian Skills

前面说的所有 Obsidian 操作(创建、读取、修改、删除笔记,触发同步),都不需要人手动敲命令——这些全是 Agent 自己完成的

人只需要做一件事:给 Agent 装上正确的 Obsidian Skills

坑:别装错了 Skill

这一步我踩过坑。一开始我装了一个非官方的 Obsidian Skill,结果 Agent 一直找不到可用的 obsidian 命令,各种调用失败。后来才发现,我安装的skill根本不是官方的,调用的也不是官方的命令

正确的做法skill地址:

kepano/obsidian-skills: Agent skills for Obsidian. Teach your agent to use Markdown, Bases, JSON Canvas, and use the CLI.

仓库skills文件夹下有五个skills,直接把链接给 Agent 让他给你安装即可。

这个skill里没有坚果云同步的命令!

如果你没有订阅 obsidian 官方的同步功能那么官方skills里面的同步命令将不能用,这个需要你提醒你的 Agent,坚果云的同步命令是obsidian command id=nutstore-sync:start-sync,你也可以让你的agent扫描位于你仓库根目录下的插件文件夹来获得完整的命令列表。

💡 装好 Skill 之后,你只需要用自然语言告诉 Agent 想做什么,比如"帮我创建一条笔记"“把这个文件同步一下”,Agent 会自动选择合适的命令执行。


六、远程管理完整工作流

6.1 手机端发指令

打开微信或飞书(或其他 Agent 渠道),直接发消息:

“帮我在 Obsidian 里创建一条笔记,标题是《今日思考》,内容是……”
“把《总则》文件最后加一句话:……”
“删除测试笔记,然后同步”

不需要知道任何 CLI 命令,用自然语言就行。

6.2 Agent 执行流程

Agent 收到指令后,自主完成:

  1. 调用 Obsidian CLI 操作笔记(创建/追加/修改/删除)
  2. 调用 nutstore-sync:start-sync 触发同步
  3. 返回执行结果

6.3 手机端验证

打开 Obsidian 手机 App,笔记已经同步到位。


七、踩过的坑全记录

坑 1:同步命令"执行成功"但没效果

obsidian command 返回 Executed 但实际没同步——因为 obsidian 弹出了确认同步的弹窗,同步卡在确认弹窗。关掉弹窗设置后解决。

坑 2:Nutstore Sync 命令是隐藏的!

插件设置界面没有"同步"按钮的等效命令说明,需要从 main.js 源码里找。发现有 nutstore-sync:start-sync,但插件作者没有给它分配默认快捷键,属于隐藏功能。

告诉你的Agent坚果云同步要用命令:obsidian command id=nutstore-sync:start-sync,或者让他扫描坚果云的插件目录自己找命令(仓库的根目录里)。

坑 3:装了非官方的 Obsidian Skill,导致 CLI 命令全部不可用

一开始装了一个来路不明的 Obsidian Skill,结果 Agent 一直找不到 obsidian 命令,各种调用失败。后来才发现,必须从官方渠道github下载官方的 obsidian Skill,不能随便装第三方修改版。

九、总结

这套方案解决了三个核心问题:

  • AI Agent 能力远超 Copilot:用成熟的 Agent 操作笔记,不是简单 API 调用
  • 不需要 Copilot Plus 订阅:不花冤枉钱买 credit,能力还更强
  • 手机端也能获得强大的Agent能力:不用开电脑,发条消息 AI 就帮你记笔记
  • 双端实时同步:坚果云 WebDAV,电脑端操作完手机端即时可见

最关键的一步:关闭 Nutstore Sync 的两个确认弹窗(confirmBeforeSyncconfirmBeforeDeleteInAutoSync),否则 CLI 自动化全部卡死在弹窗上。

如果你也在用 Obsidian 管理知识库,希望让 AI 真正帮你维护笔记,而不是只当存储工具,这套方案应该能帮到你。


写于 2026-05-04,工具版本:Obsidian CLI latest,Nutstore Sync v1.2.1

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐