YoudaoNote Skills 使用指南（OpenClaw 版）
本方案是 OpenClaw 平台上的技能插件（Skill），无需部署服务器，也无需在 App 中写代码集成。通过 clawhub CLI 安装 YoudaoNote Skills 后，即可在 OpenClaw 中用自然语言操作有道云笔记——剪藏网页、创建笔记、搜索内容、生成资讯推送，无需打开任何网页或 App。本指南面向已安装 OpenClaw 的用户，帮助你安装配置 YoudaoNote Skills 并开始使用。
1. 功能介绍
| 功能 | 说明 | 示例指令 |
|---|---|---|
| 网页剪藏 | 自动提取网页内容并保存到云笔记，支持图片下载 | "帮我把这个网页剪藏到云笔记：https://example.com/article" |
| 创建笔记 | 快速创建新笔记 | "帮我创建一篇笔记，标题是《会议纪要》" |
| 搜索笔记 | 在云笔记中搜索内容 | "搜索我云笔记中关于'技术方案'的内容" |
| 列出笔记 | 获取目录下的笔记和文件夹列表，支持分页 | "列出我云笔记根目录下的所有笔记" |
| 获取内容 | 获取指定笔记的文本内容 | "读取我云笔记里《会议纪要》这篇笔记的内容" |
| 资讯推送 | 基于最近收藏笔记生成资讯简报 | "帮我整理最近收藏的资讯推送" |
| 定时推送 | 定时自动推送资讯推送 | "设置资讯推送"（默认每天 9 点自动推送） |
特色功能：
- 网页剪藏会自动下载页面中的图片并内联到笔记，避免图片因防盗链失效
- 支持 Twitter/X 链接全文抓取
- 资讯推送自动分析关注话题并搜索最新资讯
2. 安装与配置
使用 YoudaoNote Skills 前需先完成安装与配置，请参阅 YoudaoNote Skills 安装指南。安装完成后，若想增强使用效果（如资讯推送更精准、支持 Twitter/X 剪藏），可参阅该文档中的「可选配置」。
3. 使用示例
以下为常见使用场景，在 OpenClaw 对话中直接说出需求即可。
案例：网页剪藏
遇到想保存的文章或页面，把链接发给 Agent：
帮我把这个网页剪藏到云笔记：https://example.com/article
剪藏会自动提取正文、下载图片并保存到有道云笔记。
案例：快速记笔记
需要记录会议要点、待办或灵感时：
帮我创建一篇笔记，标题是《本周会议纪要》，内容是……
也可以只说标题，让 Agent 创建空白笔记后再补充。
案例：查找与回顾
想找之前保存的内容时，可以用自然语言描述：
搜索我云笔记中关于「技术方案」的内容
列出我云笔记根目录下的所有笔记
读取我云笔记里《会议纪要》这篇笔记的内容
案例：资讯简报
收藏多篇网页后，可让 AI 根据你的收藏分析关注点，并搜索最新资讯生成简报：
帮我整理最近收藏的资讯推送
若希望每天固定时间收到简报，可以说「设置资讯推送」（默认每天 9:00）；修改时间如「修改简报时间到 8 点」；不再需要时说「关闭资讯推送」。
4. 常见问题
安装与配置相关问题请参阅 安装指南。
Q：有道云笔记结合 OpenClaw 能干什么？
收藏网页、搜索笔记、整理资讯简报——这些有道云笔记的核心能力，现在可以直接在 OpenClaw 的 AI 对话中调用，无需切换 App。你在和 AI 聊天、整理思路时，随时可以把内容存入笔记，或者从笔记里调取已有内容，让 AI 和笔记的协作更自然。
Q：我的笔记内容会不会被公开或泄露？
不会。YoudaoNote Skills 通过你自己的 API Key 访问你自己账号下的笔记，数据只在你的设备与有道云笔记服务器之间流转，不经过任何第三方。整个访问权限由你通过 API Key 掌控。
Q：能操作别人的笔记吗？
不能。API Key 只能访问注册手机号对应账号下的有道云笔记。
Q: 没有最近收藏？
先用 youdaonote-clip Skill 收藏一些网页，再生成话题简报。
Q：网页剪藏失败或内容为空？
部分网站需要登录或有反爬保护，内容可能无法提取。可先在浏览器中打开页面，再重新触发剪藏。
Q：Twitter/X 剪藏失败？
确认已配置 APIFY_API_TOKEN，且 Apify 账号额度充足。Twitter 剪藏失败不会自动重试，请根据错误信息排查。
Q：剪藏请求超时？
在对应 Skill 的 env 中增加 YOUDAONOTE_MCP_TIMEOUT（秒），例如 "60" 或 "120"。