导航|地址|刷新
YoudaoNote Skills 安装指南（通用版 · 编程 AI Agent…






有道云笔记帮助中心





🏠 关于

📌 有道云笔记是什么？

☎️ 联系我们

✨ 近期新上功能

⬇️ 下载安装



🔰 基础功能

🆕 笔记创建

📋 普通笔记

🧠 脑图笔记

💾 内容收藏

⤴️ 笔记分享

📗 微信小程序



🛠️ 进阶功能

📊文转图表

📔AI助手

📑 AI摘要

🔑 AI工具

🎧 语音读笔记

📒 桌面便签

📅 日历功能

🔗 双链笔记

📝 收藏标注

✅ 待办功能

🎙️ 语音速记

✏️ 白板笔记

🔁 每日回顾

📕 PDF转Word

👨‍💻 Markdown笔记使用指南

📷 文字识别

🔐 客户端应用锁

🛤️ 笔记历史

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



💰 会员相关

🔨会员功能

👛 会员购买

⏳ 使用空间

💎 会员资格兑换



🔧 拓展能力


🦞 OpenClaw

快速上手

安装指南



💻 YoudaoNote CLI

快速上手

安装指南



🧩 YoudaoNote Skills

快速上手

安装指南（龙虾）

安装指南（编程）

LLM Wiki（知识库）




🤔 疑难问题

笔记同步报错

笔记丢失

出现冲突笔记

购买会员未生效

笔记显示乱码

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

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

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

帐号忘记了如何找回？

会员订单如何开发票？

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



更新日志

Windows

Mac

iOS

Android




YoudaoNote Skills 安装指南（通用版 · 编程 AI Agent）

本文档说明如何在 Cursor、Claude Code、OpenCode 等编程 AI Agent 中安装并配置 YoudaoNote Skills。

如果你使用的是 LobsterAI（有道龙虾）、OpenClaw、EasyClaw 等龙虾 AI Agent，请参阅 龙虾 AI Agent 安装指南。


安装 Skill
第一步：下载 Skill ZIP

第二步：解压

第三步：使用 npx skills 安装

支持的 AI Agent


验证安装

常见问题
安装相关

使用相关


安装 Skill

安装方式统一为 下载 ZIP → 解压 → npx skills add，支持 macOS、Linux 和 Windows 全平台。

需要已安装 Node.js（npx 随 Node.js 一同安装）。


第一步：下载 Skill ZIP

下载最新版 Skill 包：

youdaonote-skill-latest.zip

第二步：解压

macOS / Linux：

unzip-q youdaonote-skill-latest.zip -d /tmp/youdaonote-skill





Windows（PowerShell）：

Expand-Archive-Path youdaonote-skill-latest.zip -DestinationPath $env:TEMP\youdaonote-skill





解压后会得到一个 youdaonote 目录，内含 SKILL.md 等文件。

第三步：使用 npx skills 安装

skills 是一个开源的 Agent Skill 安装 CLI，支持 Cursor、Claude Code、OpenCode 等 40+ AI Agent。

macOS / Linux：

# 全局安装到所有检测到的 AI Agentnpx skills add /tmp/youdaonote-skill/youdaonote -g-y# 或指定安装到特定工具npx skills add /tmp/youdaonote-skill/youdaonote -g-a cursor -a claude-code -a opencode -y













Windows（PowerShell）：

npx skills add "$env:TEMP\youdaonote-skill\youdaonote"-g -y





安装完成后，重启对应的 AI Agent 使 Skill 生效。

支持的 AI Agent

npx skills add 会自动检测本机已安装的 AI Agent。常见工具对应的 --agent 参数和 Skill 安装目录：

AI Agent	--agent 参数	全局 Skill 目录
Cursor	cursor	~/.cursor/skills/
Claude Code	claude-code	~/.claude/skills/
OpenCode	opencode	~/.config/opencode/skills/
Codex	codex	~/.codex/skills/
Windsurf	windsurf	~/.codeium/windsurf/skills/
Gemini CLI	gemini-cli	~/.gemini/skills/

完整列表见 skills CLI 文档。

验证安装

安装完成后，在 AI Agent 对话中发送：

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





返回笔记列表即表示安装成功。

如果 AI 提示找不到 youdaonote 命令，说明 CLI 尚未安装，直接告诉 AI「帮我安装 youdaonote CLI」，Skill 会自动引导你完成安装。

常见问题

安装相关

Q：npx skills add 报错找不到 SKILL.md？

请确认解压后的路径正确——npx skills add 的参数应指向包含 SKILL.md 的 youdaonote 目录，而非 zip 文件本身。

Q：Cursor 安装后没有生效？

Skill 在 Cursor 启动时加载，安装后需要重启或重载 Cursor。

Q：没有安装 Node.js 怎么办？

npx skills add 依赖 Node.js。如果不想安装 Node.js，可以使用上方「手动安装」的方式，将解压得到的 youdaonote 目录直接复制到对应 AI Agent 的 Skill 目录。

使用相关

Q：提示 CLI 版本过低？

CLI 1.3.1+ 支持自动升级：运行 youdaonote upgrade。若版本较旧不支持该命令，直接告诉 AI「升级 youdaonote CLI 到最新版」，Skill 会引导你完成升级；或参考 CLI 安装指南 - 升级。

Q：提示 API Key 无效？

请访问 网易智能开发者平台 获取或确认你的 API Key，然后告诉 AI「帮我设置 API Key」，Skill 会引导你完成配置。

Q：网页剪藏失败或内容为空？

部分网站需要登录或有反爬保护，内容可能无法提取。可先在浏览器中打开页面确认内容可访问，再重新触发剪藏。





Prev

安装指南（龙虾）

Next

LLM Wiki（知识库）



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