YoudaoNote Skills 使用指南（通用版）

YoudaoNote Skills（通用版）是一个 AI Agent 技能插件，安装后即可在 LobsterAI（有道龙虾）、OpenClaw、QClaw、WorkBuddy、EasyClaw、Cursor、Claude Code、OpenCode 等 AI Agent 中用自然语言操作有道云笔记——管理笔记、创建待办、剪藏网页、搜索内容，无需打开任何网页或 App。

关于 OpenClaw 版：OpenClaw 版仅支持网页剪藏和资讯推送；通用版功能更全面，涵盖笔记 CRUD、待办管理、搜索、剪藏等全部能力，推荐优先使用通用版。

1. 快速开始

第一步：安装 CLI 并配置 API Key

按 CLI 安装指南完成 YoudaoNote CLI（≥ 1.2.0）安装、API Key 获取和配置。

第二步：安装 Skill 到你的 AI Agent

根据你使用的 AI Agent 类型，选择对应的安装指南：

你使用的 AI Agent	安装指南
LobsterAI（有道龙虾）、OpenClaw、QClaw、WorkBuddy、EasyClaw 等龙虾 AI Agent	龙虾 AI Agent 安装指南
Cursor、Claude Code、OpenCode 等编程 AI Agent	编程 AI Agent 安装指南

第三步：验证

在 AI Agent 对话中说：

列出我有道云笔记中的笔记

返回笔记列表即表示安装成功。

2. 功能介绍

功能	说明	示例指令
笔记管理	创建、读取、更新、删除、重命名、移动笔记	"帮我创建一篇笔记，标题是《会议纪要》"
待办管理	创建待办、设置截止日期、标记完成、分组管理	"帮我创建一个待办：明天交周报"
搜索笔记	按关键词搜索笔记内容	"搜索我云笔记中关于'技术方案'的内容"
浏览目录	查看目录结构和笔记列表	"列出我云笔记根目录下的所有笔记"
网页剪藏	自动抓取网页内容并保存为笔记	"帮我剪藏这个网页：https://example.com"
最近笔记	查看最近编辑或收藏的笔记	"显示我最近编辑的笔记"

3. 使用示例

以下为常见使用场景，在 AI Agent 对话中直接说出需求即可。

快速记笔记

帮我保存一篇笔记，标题是《产品优化想法》，内容是：
用户反馈搜索功能太慢，可以考虑加缓存

Skill 会自动将内容保存为 Markdown 格式的笔记。

保存文件到云笔记

把当前打开的 README.md 保存到我的有道云笔记

AI 会读取当前文件内容，保存为 Markdown 格式的云笔记。适合将项目文档、技术方案、会议纪要等随时同步到云笔记，方便跨设备查看和分享。

管理待办事项

帮我创建一个待办：写周报，截止日期是周五

也可以查看、完成、删除待办：

显示我的待办列表
帮我把"写周报"这个待办标记为完成

还支持用分组整理待办：

创建一个待办分组叫"工作"
把"准备会议材料"这个待办移到"工作"分组

网页剪藏

帮我剪藏这个网页：https://example.com/article

剪藏会自动提取正文并保存到有道云笔记。

查找与回顾

搜索我云笔记中关于「技术方案」的内容
列出我云笔记根目录下的所有笔记
读取我云笔记里《会议纪要》这篇笔记的内容

AI 辅助处理

让 AI 读取笔记后进行总结、翻译或改写：

读取我的《技术方案》笔记，帮我写一个中文摘要，保存为新笔记

技术调研并保存

帮我调研一下 React Server Components 的最新进展，整理成笔记保存到云笔记

AI 会搜索相关资料，整理成结构化的技术调研笔记并保存，不用在浏览器和笔记之间来回切换。

跨笔记整合

搜索我云笔记里所有关于「周报」的笔记，汇总成一篇本月工作总结

AI 会搜索并读取多篇相关笔记，自动提炼要点、整合成一篇新笔记保存。适合月度总结、项目复盘、知识归纳等场景。

4. 常见问题

Q：通用版和 OpenClaw 版有什么区别？

OpenClaw 平台同时提供专版和通用版两种选择。专版通过 clawhub CLI 安装，支持网页剪藏和资讯推送；通用版通过手动安装，支持笔记全功能 + 待办管理。其他 AI Agent 平台（LobsterAI、Cursor 等）均使用通用版。

Q：需要安装 Node.js 吗？

CLI 本身不需要。npx skills add 命令依赖 Node.js，但这仅适用于编程 AI Agent（Cursor 等）。如果你使用 LobsterAI、OpenClaw 等龙虾 AI Agent，安装 Skill 无需 Node.js，详见龙虾 AI Agent 安装指南。

Q：我的笔记内容会不会被公开或泄露？

不会。Skill 通过你自己的 API Key 访问你自己账号下的笔记，数据只在你的设备与有道云笔记服务器之间流转，不经过任何第三方。

Q：AI Agent 提示找不到 youdaonote 命令？

说明 CLI 未安装或未加入 PATH。请参阅 CLI 安装指南完成安装。

Q：提示 API Key 无效或未设置？

请访问网易智能开发者平台确认 API Key 有效，然后执行 youdaonote config set apiKey YOUR_KEY 重新配置。

Q：支持 Windows 吗？

支持。CLI 提供 Windows 预编译包（x64 / ARM64），详见 CLI 安装指南。Skill 安装方式取决于你的 AI Agent：LobsterAI 支持应用内直接安装，编程 AI Agent 使用 npx skills add（Windows 原生支持）。

安装遇到其他问题？请参阅龙虾 AI Agent 安装指南或编程 AI Agent 安装指南。