YoudaoNote Clip — 网页剪藏

将网页稳定保存到有道云笔记。核心原则：优先成功率，其次才是速度。 并发限制：本 Skill 不支持并发执行。同一次请求里若有多个 URL，必须逐个串行处理，前一个完成后再处理下一个。 先回复：正在保存中...

路由判断

按优先级命中第一条即可：

优先级	条件	路径
1	URL 为 x.com / twitter.com 且含 /status/	路径 A
2

知乎文章、微信公众号、掘金、36kr、少数派、CSDN、163/qq 资讯正文页（正文可服务端直接抓取）；首页/搜索页/话题流/登录后页面不走此路径 | 路径 B |
| 3 | 所有其他页面（默认路径，必须先尝试浏览器提取） | 路径 C |

路径 A — Twitter 专用流程

bash
node {baseDir}/twitter-apify.mjs --url

成功标准：stdout 输出 metadata JSON，且 /tmp/youdaonote-clip-data.json 已生成。

bash
bash {baseDir}/clip-note.sh --data-file /tmp/youdaonote-clip-data.json --source-url

stdout 含 {ok:true → 进入响应格式。

路径 B — 国内快速路径

bash
bash {baseDir}/clip-note.sh --clip-web-page --source-url

stdout 含 {ok:true → 进入响应格式。若报超时、MCP 调用失败、unknown tool、内容明显不完整，立即降级到路径 C。

路径 C — 浏览器提取（含降级）

第一步：优先使用浏览器提取（支持 SPA 动态渲染、懒加载图片、JS 生成内容）。不建议直接用 webfetch 替代，因为 webfetch 只能获取原始 HTML，无法提取客户端渲染的页面内容。

bash
bash {baseDir}/collect-page.sh

stdout 最后一行为 metadata JSON 且 contentLength > 0 → 提取成功，执行：

bash
bash {baseDir}/clip-note.sh --data-file /tmp/youdaonote-clip-data.json --source-url

stdout 含 {ok:true → 进入响应格式。

当 collect-page.sh 报错时（CSP、空内容、browser 不可用、timeout 等），降级为 web_fetch：

1. 1. web_fetch(url=, extractMode=markdown)
2. 写入 /tmp/youdaonote-clip-data.json：{title:页面标题,content:,imageUrls:[],source:}

bash
bash {baseDir}/clip-note.sh --data-file /tmp/youdaonote-clip-data.json --markdown --source-url

stdout 含 {ok:true → 进入响应格式。

响应格式

成功后回复：

markdown
📎 网页剪藏完成

项目	详情
📌 标题	{实际页面标题或保存标题}
🔗 来源网址

{原始 URL} |
| ⏰ 剪藏时间 | {yyyy-MM-dd HH:mm} |

标题以实际保存结果为准

不要编造保存位置或文件夹信息。当前链路默认保存为普通笔记，除非底层命令明确返回了可确认的位置。

剪藏后引导（可选）

bash
mcporter call youdaonote.getRecentFavoriteNotes --args {limit:3} --output json
openclaw cron list --json | jq .[] | select(.name == youdaonote-news)

若收藏 ≥3 篇且未设置资讯推送，可追加：💡 你已经收藏了 N 篇文章，试试说「资讯推送」看看 AI 为你整理的简报吧～

调试

设置环境变量 YOUDAONOTECLIPDEBUG 为日志目录路径即可开启调试模式：

bash

在 ~/.zshrc 或 ~/.bashrc 中配置

export YOUDAONOTECLIPDEBUG=~/logs/youdaonote-clip

或临时开启

YOUDAONOTECLIPDEBUG=~/logs/youdaonote-clip bash clip-note.sh ...

YOUDAONOTEAPIKEY、YOUDAONOTECLIPDEBUG 请在 OpenClaw config 的 skills.entries[youdaonote-clip].env 中配置，执行时会注入为 process.env；或在 shell 中 export。

调试日志按 key 分目录存储：{DEBUGDIR}/{key}/main.log（clip-note）、twitter.log、collect.log。各 path 首行会输出路径标识（A/B/C/D），便于排查。key 由首个脚本生成并写入 data-file 的 debugKey 字段，串联整条剪藏流程。通过 perf-test/run-clip.sh 测试时，脚本会 export 该变量，日志写入可预期目录。

调试日志经过脱敏处理：不记录完整页面内容，仅记录长度和前 200 字符摘要。

安全说明

浏览器提取：路径 C 使用 openclaw browser evaluate 在目标页面中注入内容解析脚本（inject-sdk.fn.js），用于提取正文、标题和图片列表。该脚本完全内联在 Skill 包中（不加载外部 CDN），代码可审计。注入仅用于读取 DOM 内容，不修改页面、不发送网络请求、不访问 cookie 或 localStorage。

调试模式：默认关闭。开启后仅写入脱敏的元数据（标题、URL、内容长度），不写入完整页面内容。

环境变量：核心模块 clip-note.mjs 不直接读取 process.env，由 clip-note.sh 从环境变量读取后通过命令行参数传入。twitter-apify.mjs 从 process.env 读取 APIFYAPITOKEN（可选，仅 Twitter/X 路径使用）和 YOUDAONOTECLIPDEBUG（可选，调试模式）。collect-page.sh 内联 Node 代码从 process.env 读取 YOUDAONOTECLIPDEBUG。所有环境变量均由 OpenClaw 执行时从 skills.entries[youdaonote-clip].env 注入。