YoudaoNote Skills 安装指引（OpenClaw 版）

请按以下步骤依次执行。每个 Step 完成后再进入下一个。

Step 1：安装 / 更新 Skill 到最新版

先检查 clawhub CLI 是否可用：

clawhub --cli-version

• 如果提示 command not found，先安装：npm i -g clawhub
• 如果提示未登录，执行 clawhub login（会打开浏览器完成授权；无头环境请用 clawhub login --token <TOKEN>，Token 在 clawhub.ai 获取）

安装两个 Skill（--force 确保覆盖安装为最新版本）：

clawhub install youdaonote-clip --force
clawhub install youdaonote-news --force

安装成功后，Skill 文件位于 OpenClaw workspace 的 skills/ 目录下。

Step 2：检测并配置 YOUDAONOTE_API_KEY（必需）

读取 ~/.openclaw/openclaw.json，检查 skills.entries 中是否已有 YOUDAONOTE_API_KEY（检查 youdaonote-clip 或 youdaonote-news 任一条目即可）。

已有 Key

告知用户：「已检测到 YOUDAONOTE_API_KEY，跳过配置。」，继续 Step 3。

未配置

告诉用户：

使用 YoudaoNote Skills 需要有道云笔记 API Key。请按以下步骤获取：

1. 打开 网易智能开发者平台
2. 使用手机号登录（前提：有道云笔记账号已绑定手机号）
3. 在API管理，获取 API Key

获取后请把 Key 发给我。

等用户提供 Key 后才继续下一步。

Step 3：写入 openclaw.json

将 YOUDAONOTE_API_KEY 写入 ~/.openclaw/openclaw.json 的 skills.entries。

配置模板：

{
  "skills": {
    "entries": {
      "youdaonote-clip": {
        "enabled": true,
        "env": {
          "YOUDAONOTE_API_KEY": "<用户提供的 Key>"
        }
      },
      "youdaonote-news": {
        "enabled": true,
        "env": {
          "YOUDAONOTE_API_KEY": "<用户提供的 Key>"
        }
      }
    }
  }
}

若 openclaw.json 中已有其他 skill 配置，仅 merge 新增/更新 youdaonote-clip 和 youdaonote-news 条目，不要覆盖或删除已有的其他 skill 配置。

Step 4：配置 mcporter（必需）

YoudaoNote Skills 通过 mcporter 调用有道云笔记 MCP，需在用户本机配置 youdaonote server。请用 CLI 完成，勿手写 JSON。

1. 检查并安装 mcporter

   • 执行：mcporter --version 或 which mcporter
   • 若未安装：npm i -g mcporter

2. 检查是否已配置 youdaonote

   • 执行：mcporter config list 或 mcporter list youdaonote
   • 若已存在 youdaonote 且可列出，跳到第 4 步。

3. 用 CLI 添加 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}" }（注意与已有字段合并，勿覆盖其它 server）。

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

   • 执行：mcporter list open-websearch 检查是否已配置
   • 若已存在且可列出，跳到第 5 步。
   • 若未配置，执行：

     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"
       }
     }
     
     注意与已有字段合并，勿覆盖其它 server。

5. 验证：先执行 export YOUDAONOTE_API_KEY="<用户提供的 Key 或从 openclaw.json 的 skills.entries 中读取>"，再执行 mcporter list youdaonote 和 mcporter list open-websearch。能列出两者的工具即表示配置成功，进入 Step 5。

Step 5：验证

告诉用户：

安装和配置已完成！请关闭当前对话，重新打开一个新的 OpenClaw session（Skill 在 session 启动时加载），然后输入：

「列出我最新收藏的笔记」

如果能返回笔记列表，说明一切就绪。

功能简介

安装完成后，你可以在 OpenClaw 对话中使用以下功能：

安装完成后，上述步骤仅包含必选配置。若需增强使用效果（如 Twitter/X 剪藏、资讯推送搜索更精准），请参阅 YoudaoNote Skills 安装指南 中的「可选配置」自行按需设置。