国内应用接入
网易云音乐接入：官方 ncm-cli、凭证配置与能力范围
安装网易官方 ncm-cli 与配套 Skill 后，机器人可以搜歌、查歌词、生成推荐、返回播放链接并管理歌单；凭证只保存在机器人的持久化目录中。
网易云音乐怎么接入 AI 助手？
网易官方发布了 ncm-cli 命令行工具和配套的 Agent Skill。OpenClaw Launch 安装的是审核固定版本：移除了上游误带的高危旧构建依赖，并禁用安装脚本、自升级、诊断上传、系统软件安装与定时调度。
凭证由您自己申请。到网易云音乐开放平台创建应用拿到 App ID 和 Private Key，然后在机器人终端运行配置和登录命令；凭证只保存在机器人的持久化目录，不要发到聊天里。
接入后可以做什么？
- 搜索歌曲：按歌名、歌手或关键词搜索，并返回可用的播放链接。
- 查看歌词：拉取指定歌曲的歌词内容。
- 生成推荐：基于账号数据生成歌曲推荐。
- 歌单管理：查看并整理歌单；写入或删除前需要确认。
如何安装并配置网易云音乐？
在国内应用列表点击安装后，机器人会装好官方 ncm-cli 与 Skill；账号凭证由您在机器人终端输入，不经过聊天。
- 申请开放平台凭证 — 到网易云音乐开放平台（developer.music.163.com）创建应用，取得 App ID 和 Private Key。
- 安装官方 Skill — 在国内应用列表选择网易云音乐并指定机器人，系统安装审核固定版的 ncm-cli 与官方 Skill。
- 在机器人终端配置 — 打开机器人的终端，运行 ncm-cli configure 输入 App ID 与 Private Key，不要在聊天中发送凭证。
- 完成登录并测试 — 运行 ncm-cli login --background 完成登录，然后让机器人搜一首歌，确认能返回结果。
连接后可以直接这样问
- “帮我搜一下周杰伦最近的歌并给出播放链接”
- “把《晴天》的歌词发给我”
- “根据我最近听的歌生成一份推荐歌单”
使用前必须知道的限制
托管服务器不提供本地音频播放，机器人返回的是搜索结果、歌词和播放链接，不会在服务器上放音乐。可用能力取决于官方 ncm-cli 当前版本，我们固定在已审核版本，新版本需要重新审核。
不要在聊天中发送 App ID 或 Private Key，配置只在机器人终端完成。修改或删除歌单前让机器人先确认目标。
托管连接还是自己搭工具？
| 方案 | 适合谁 | 您需要负责什么 |
|---|---|---|
| OpenClaw Launch 托管 | 希望尽快让机器人持续在线并连接网易云音乐的用户 | 提供必要授权、确认敏感操作并管理自己的应用账户 |
| 自行部署 | 已有服务器、愿意维护 OpenClaw/Hermes 与兼容工具的开发者 | 自行安装并校验 ncm-cli 与 Skill，处理依赖安全问题，维护凭证、登录态与版本更新。 |
自行部署是合理选择；托管方案省下的是服务器配置、运行监控和集成维护时间。OpenClaw Launch 的托管价格为首月 $3，续费 $6/月，支持支付宝和微信支付。应用自身的会员、API 配额或其他费用仍按应用方规则计算。
已经有机器人？前往国内应用一键接入查看连接状态；第一次部署可先阅读养龙虾入门指南。
网易云音乐接入常见问题
机器人能在服务器上放歌吗？
不能。托管服务器不提供本地音频播放，机器人返回的是搜索结果、歌词和播放链接。
需要把网易云账号密码给机器人吗？
不需要。使用的是开放平台的 App ID 与 Private Key，且只在机器人终端输入。
支持 Hermes 吗？
支持。OpenClaw 和 Hermes 机器人都可以安装官方 ncm-cli 与 Skill。
这个版本安全吗？
我们安装的是审核固定版本：移除了上游误带的高危旧构建依赖，并禁用安装脚本、自升级、诊断上传和定时调度。