导航|地址|刷新
YoudaoNote Skills 安装指南（OpenClaw 版） | 有道云…

有道云笔记帮助中心

🏠 关于

📌 有道云笔记是什么？

☎️ 联系我们

 ✨ 近期新上功能

 ⬇️ 下载安装

🔰 基础功能

🆕 笔记创建

 📋 普通笔记

 🧠 脑图笔记

 💾 内容收藏

 ⤴️ 笔记分享

 📗 微信小程序

🛠️ 进阶功能

📊文转图表

 📔AI助手

 📑 AI摘要

 🔑 AI工具

 🎧 语音读笔记

 📒 桌面便签

 📅 日历功能

 🔗 双链笔记

 📝 收藏标注

 ✅ 待办功能

 🎙️ 语音速记

 ✏️ 白板笔记

 🔁 每日回顾

 📕 PDF转Word

👨‍💻 Markdown笔记使用指南

 📷 文字识别

 🔐 客户端应用锁

 🛤️ 笔记历史

 ⌨️ 有道云笔记桌面端快捷键

💰 会员相关

🔨会员功能

 👛 会员购买

 ⏳ 使用空间

 💎 会员资格兑换

🔧 拓展能力

🦞 OpenClaw

快速上手

 安装指南

💻 YoudaoNote CLI

快速上手

 安装指南

🧩 YoudaoNote Skills

快速上手

 安装指南（龙虾）

安装指南（编程）

LLM Wiki（知识库）

🤔 疑难问题

笔记同步报错

 笔记丢失

 出现冲突笔记

 购买会员未生效

 笔记显示乱码

 应用无法启动/登录界面白屏

 多帐户的笔记内容如何合并？

如何在笔记中设置笔记目录？

帐号忘记了如何找回？

会员订单如何开发票？

搜索功能受限问题排查指南

更新日志

Windows

Mac

iOS

Android

YoudaoNote Skills 安装指南（OpenClaw 版）

本文档说明如何在 OpenClaw 中安装并配置 YoudaoNote Skills（网页剪藏、资讯推送等）。

推荐：优先使用「方式一：对话安装」，将安装文档交给 OpenClaw Agent 自动执行；若希望自己逐步操作，请按「方式二：手动安装」执行。

------

方式一：对话安装（推荐）

在 OpenClaw 对话中发送以下指令，Agent 会自动拉取安装文档并完成安装与配置，无需逐条敲命令：

Fetch and follow instructions from https://note.youdao.com/help-center/openclaw-install-skills.html

------

方式二：手动安装

步骤 1：获取 API Key

打开网易智能开发者平台

使用手机号登录（前提：有道云笔记账号已绑定手机号）

在 API 管理 中获取 API Key

注意：API Key 仅能访问该账号下的有道云笔记，无法跨账号操作。

步骤 2：安装 Skill

clawhub install 可能限流，建议先执行 clawhub login 登录；登录后不受限流影响，安装更易成功。若在 SSH 远程、CI、Docker 等无桌面环境，需先在可打开浏览器的机器上登录 clawhub.ai 生成 API Token，再执行 clawhub login --token <TOKEN>。

npm i -g clawhub # 安装 ClawHub CLI（已安装可跳过）clawhub login # 登录 ClawHub（推荐，可避免限流）clawhub install youdaonote-clip # 网页剪藏clawhub install youdaonote-news # 资讯推送

步骤 3：配置 API Key

所有配置在 ~/.openclaw/openclaw.json 的 skills.entries 下完成。

必需：有道云笔记 API Key。编辑 openclaw.json，为两个 Skill 填写 YOUDAONOTE_API_KEY：

{"skills":{"entries":{"youdaonote-clip":{"enabled":true,"env":{"YOUDAONOTE_API_KEY":"你的API_Key"}},"youdaonote-news":{"enabled":true,"env":{"YOUDAONOTE_API_KEY":"你的API_Key"}}}}}

也可在 ~/.zshrc 或 ~/.bashrc 中添加 export YOUDAONOTE_API_KEY="YOUR_API_KEY" 并 source，但 OpenClaw 运行 Agent 时不一定继承该环境，建议同时在 openclaw.json 中配置。

步骤 4：配置 mcporter（必需）

mcporter 用于在本地连接有道云笔记的 MCP 服务（如获取收藏列表等），Skill 依赖它完成部分能力。mcporter 需用户本机单独安装，OpenClaw 不会自动安装。请先安装 mcporter。

1. 检查并安装 mcporter

npm i -g mcportermcporter --version

2. 添加 youdaonote server

mcporter config add youdaonote https://open.mail.163.com/api/ynote/mcp/sse \--header'x-api-key=${YOUDAONOTE_API_KEY}'\--scope home

若你本机的 mcporter config add 不支持 --header，可先执行：
mcporter config add youdaonote https://open.mail.163.com/api/ynote/mcp/sse --scope home
再编辑 ~/.mcporter/mcporter.json，在 mcpServers.youdaonote 下增加：
"headers": { "x-api-key": "${YOUDAONOTE_API_KEY}" }。

3. 添加 open-websearch server（资讯推送兜底搜索引擎）

mcporter config add open-websearch \--command npx --arg open-websearch@1.2.5 \--envMODE=stdio \--envDEFAULT_SEARCH_ENGINE=duckduckgo \--envALLOWED_SEARCH_ENGINES=duckduckgo,bing,baidu \--scope home

若 mcporter config add 不支持 --command，可手动编辑 ~/.mcporter/mcporter.json，在 mcpServers 下增加：

"open-websearch":{"command":"npx","args":["open-websearch@1.2.5"],"env":{"MODE":"stdio","DEFAULT_SEARCH_ENGINE":"duckduckgo","ALLOWED_SEARCH_ENGINES":"duckduckgo,bing,baidu"}}

4. 验证

exportYOUDAONOTE_API_KEY="你的API_Key"mcporter list youdaonotemcporter list open-websearch

能列出 youdaonote 和 open-websearch 的工具即表示配置成功。

步骤 5：验证

启动一个新的 OpenClaw session（已有 session 不会自动加载新 Skill），然后发送：

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

返回笔记列表即表示安装成功。也可在终端执行 openclaw skills list，输出中应包含 youdaonote-clip 和 youdaonote-news。

可选配置（增强使用效果）

以下配置非安装必需，按需设置可提升体验：

搜索（资讯推送）：youdaonote-news 使用 OpenClaw 的 web_search。Perplexity 配置在 Perplexity API Key 管理页创建后，写入 youdaonote-news 的 env：

"youdaonote-news":{"enabled":true,"env":{"YOUDAONOTE_API_KEY":"你的API_Key","PERPLEXITY_API_KEY":"pplx-xxxxxxxx"}}

Brave 需在 OpenClaw 的 web_search 配置（tools.web.search）中设置，例如：

"tools":{"web":{"search":{"provider":"brave","apiKey":"YOUR_BRAVE_API_KEY"}}}

Twitter/X 剪藏：在 apify.com 注册并获取 API Token（有免费额度），在 youdaonote-clip 的 env 中增加：

"youdaonote-clip":{"enabled":true,"env":{"YOUDAONOTE_API_KEY":"你的API_Key","APIFY_API_TOKEN":"apify_api_xxxxxxxx"}}

超时：Skill 调用有道云笔记 MCP 接口（如剪藏、搜索、列笔记）时，单次 HTTP 请求的最长等待时间（秒）。超时未完成会报错。在对应 Skill 的 env 中增加 YOUDAONOTE_MCP_TIMEOUT，例如：

"youdaonote-clip":{"enabled":true,"env":{"YOUDAONOTE_API_KEY":"你的API_Key","YOUDAONOTE_MCP_TIMEOUT":"120"}}

------

常见问题（安装与配置）

安装与生效

Q：安装后 OpenClaw 找不到 youdaonote-clip？

必须启动新的 session。Skill 在 session 启动时快照加载，已有 session 不会自动刷新。

Q：如何确认 Skill 已安装？

执行 openclaw skills list，输出中应包含 youdaonote-clip 和 youdaonote-news。

API Key 与配置

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

检查 openclaw.json 中 YOUDAONOTE_API_KEY 是否填写正确；若写在 ~/.zshrc，需确保执行 Skill 前已 source 或在新终端中生效。

Q：如何暂时禁用某个 Skill？

在 openclaw.json 中设置 "enabled": false：

{"skills":{"entries":{"youdaonote-clip":{"enabled":false}}}}

Q：能否只用 shell 环境变量，不写 openclaw.json？

可将 YOUDAONOTE_API_KEY 写在 ~/.zshrc 等，但 OpenClaw 运行 Agent 时不一定继承该环境，建议同时在 openclaw.json 的 skills.entries.<skill>.env 中配置，确保 Skill 能读到 Key。

Prev

快速上手

------
导航页打开网址