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 mcporter
mcporter --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 \
  --env MODE=stdio \
  --env DEFAULT_SEARCH_ENGINE=duckduckgo \
  --env ALLOWED_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. 验证

export YOUDAONOTE_API_KEY="你的API_Key"
mcporter list youdaonote
mcporter 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。