手机电脑双端 AI Agent + Obsidian CLI Skills :突破 Obsidian Copilot 的能力天花板,坚果云双端同步完整方案
Obsidian 的 Copilot 插件在PC端和手机端 Agent 功能都很弱,远落后于市面上成熟的 AI Agent 和 Claw 产品;想用 Copilot Plus 的那点 Agent 能力还得单独订阅付费。本文介绍一套更强大的方案:用成熟的 AI Agent + Obsidian CLI Skills,实现手机端和PC端双端的 Agent 辅助笔记管理、AI 主动维护知识库,能力远超
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地址:
仓库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 收到指令后,自主完成:
- 调用 Obsidian CLI 操作笔记(创建/追加/修改/删除)
- 调用
nutstore-sync:start-sync触发同步 - 返回执行结果
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 的两个确认弹窗(confirmBeforeSync 和 confirmBeforeDeleteInAutoSync),否则 CLI 自动化全部卡死在弹窗上。
如果你也在用 Obsidian 管理知识库,希望让 AI 真正帮你维护笔记,而不是只当存储工具,这套方案应该能帮到你。
写于 2026-05-04,工具版本:Obsidian CLI latest,Nutstore Sync v1.2.1
更多推荐




所有评论(0)