YoudaoNote CLI 安装指南

1. 安装

在终端运行以下命令，无需安装 Node.js：

curl -fsSL https://artifact.lx.netease.com/download/youdaonote-cli/install.sh | bash

支持平台：macOS（Intel / Apple Silicon）、Linux（x64 / ARM64）。

安装完成后，youdaonote 命令默认写入 /usr/local/bin。如需指定安装目录：

curl -fsSL https://artifact.lx.netease.com/download/youdaonote-cli/install.sh | bash -s -- -b ~/bin

安装选项

Linux 安装失败？

若使用 Snap 版 curl 出现「Permission denied」或「下载失败」：

• 不要使用 sudo curl ... | bash，直接运行 curl ... | bash
• 若仍失败，换用系统原生 curl：

sudo apt install curl
# 或
sudo snap remove curl

2. 获取 API Key

访问 MCP 控制台 获取 API Key。

前提条件：有道云笔记账号需已绑定手机号，否则无法在控制台开通 API Key。可在有道云笔记客户端的账号设置中绑定。

3. 配置

方式一：命令行（推荐）

youdaonote config set apiKey YOUR_API_KEY

方式二：配置文件

在 ~/.youdaonote.json 中写入：

{
  "backend": "mcp",
  "mcp": {
    "server": "https://open.mail.163.com/api/ynote/mcp/sse",
    "apiKey": "YOUR_API_KEY"
  }
}

方式三：环境变量（优先级最高）

export YOUDAONOTE_API_KEY=YOUR_API_KEY

4. 验证安装

youdaonote list

能列出笔记目录即表示安装和配置成功。

5. 常见问题