你有没有想过，让 OpenClaw 不只是一个聊天助手，而是一个真正能帮你“搜歌、推荐歌、管理歌单、控制播放”的音乐助手？

这篇文章，我会手把手带你把 网易云音乐接入 OpenClaw，让它拥有：

• 音乐搜索能力
• 音乐推荐能力
• 每日推荐获取能力
• 歌单管理能力
• 播放控制能力

整个过程我已经亲自跑通，本文直接按实战流程整理，尽量做到照着做就能复现。

---

一、先看效果：接入完成后能做什么？

接入完成后，你可以直接对 OpenClaw 说：

• 帮我搜一下林俊杰的歌
• 推荐一些适合深夜听的歌
• 帮我播放《起风了》
• 帮我看看今天的每日推荐
• 帮我创建一个跑步歌单

也就是说，原本你需要手动打开网易云、搜索、筛选、点击播放的流程，现在都可以通过 自然语言 完成。

如果你本身就在玩：

• OpenClaw
• AI Agent
• 自动化工作流
• 飞书 / Telegram / 桌面助手集成

那这个能力会非常实用。

---

二、为什么这套方案值得做？

很多人一看到“网易云音乐接入”，第一反应就是去逆向接口。

但这次我不建议这么做。

原因很简单：

1. 官方已经给出了开发者平台
2. 官方已经提供了 CLI 工具
3. 官方文档里已经明确写了 OpenClaw 集成方式

所以，最稳的路线不是“自己造轮子”，而是：

网易云音乐开放平台 + 官方 CLI + OpenClaw Skills

这样做的优点非常明显：

• 更稳定
• 更合规
• 后续维护成本更低
• 更适合长期项目使用

---

三、本文你将学会什么？

看完这篇文章，你可以掌握：

• 如何完成网易云音乐个人开发者入驻
• 如何拿到 AppID / PrivateKey
• 如何安装官方 CLI
• 如何给 OpenClaw 安装网易云音乐相关 Skill
• 如何完成登录与配置
• 如何让 OpenClaw 拥有“搜索 / 推荐 / 播放”等音乐能力

---

四、环境准备

开始前，请确保你具备以下环境：

• 已安装 OpenClaw
• 本机已经安装 Node.js / npm
• 可以正常访问网易云音乐开放平台
• 本文默认系统为 macOS

先在终端执行：

node -v
npm -v

如果都能输出版本号，说明基础环境没问题。

---

五、前置补充：个人开发者入驻流程

这一步是整个教程的前提。

因为后续 ncm-cli 和 OpenClaw 都要用到你在网易云开放平台申请到的凭证。

步骤一：打开官方链接

进入网易云音乐开放平台：

https://music.163.com/st/developer

步骤二：点击【立即入驻】

进入官网首页后，找到并点击：立即入驻

步骤三：选择【个人开发者入驻】

如果你是个人项目、个人测试、个人使用场景，直接选择：个人开发者入驻

步骤四：输入资料并提交审核

按照页面提示填写这些信息：

• 姓名
• 手机号
• 邮箱
• 应用描述

填写完成后，提交审核。

步骤五：提交完成后，即可进入【控制台】

审核通过后，你就可以进入网易云音乐开放平台的 控制台。

控制台中你会看到：

• AppID
• AppSecret
• PubKey
• PrivateKey

后续最关键的是：

• AppID
• PrivateKey

这两个值后面一定会用到。

步骤六：可通过查看顶部相关使用文档，进一步操作了

控制台顶部会有相关文档入口，比如：

• 音乐 API 文档
• CLI 文档
• SDK 文档
• AI Agent / OpenClaw 集成文档

到这里，开发者入驻流程就完成了。

---

六、找到官方 CLI 文档

在网易云开放平台文档里，可以找到 网易云音乐 CLI。

它支持的能力非常实用：

• 音乐搜索
• 播放控制
• 歌单管理
• 每日推荐
• TUI 播放器
• AI Agent 集成

更关键的是，文档里明确写了 OpenClaw 集成方式。

也就是说，我们不是瞎试，而是沿着官方路径接入。

---

七、安装网易云音乐官方 CLI

官方 CLI 包名如下：

npm install -g @music163/ncm-cli

安装完成后，先检查一下版本：

ncm-cli --version

如果能正常输出版本号，说明安装成功。

---

八、安装 OpenClaw 对应 Skill

根据官方文档，建议安装以下三个 Skill：

clawhub install netease-music-cli
clawhub install netease-music-assistant
clawhub install ncm-cli-setup

这三个 Skill 的作用分别是：

1）netease-music-cli

负责基础能力：

• 搜索歌曲
• 播放歌曲
• 暂停 / 下一首 / 上一首 / 停止
• 查看播放状态
• 管理播放队列
• 歌单相关操作

2）netease-music-assistant

负责更智能的能力：

• 音乐推荐
• 偏好分析
• 多关键词推荐策略
• 结合上下文做推荐

3）ncm-cli-setup

负责安装 / 配置辅助。

不是强制必须，但建议一起装上。

---

九、配置 AppID 和 PrivateKey

在网易云开放平台控制台拿到 AppID 和 PrivateKey 后，执行：

ncm-cli config set appId <你的AppID>
ncm-cli config set privateKey <你的PrivateKey>

例如：

ncm-cli config set appId xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
ncm-cli config set privateKey xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

配置完成后，可以检查当前配置：

ncm-cli config list

如果你更喜欢交互方式，也可以直接运行：

ncm-cli configure

---

十、登录网易云账号

配置完凭证后，下一步就是登录账号。

执行：

ncm-cli login

如果支持后台登录，也可以尝试：

ncm-cli login --background

登录完成后，检查是否成功：

ncm-cli login --check

如果输出类似：

{
  "success": true,
  "message": "已登录实名账号"
}

说明账号登录已经完成。

---

十一、配置播放器（推荐）

如果你希望 OpenClaw 不只是能搜索、推荐，还能直接播放，那么建议配置播放器。

本文以 mpv 为例。

1）安装 mpv

macOS 下执行：

brew install mpv

2）将 ncm-cli 的播放器切换到 mpv

ncm-cli config set player mpv

3）检查配置结果

ncm-cli config get player

如果输出：

player: mpv

说明配置成功。

---

十二、开始实战：搜索、推荐、播放

接下来就是最关键的一步——验证能力有没有真正打通。

1）搜索歌曲

比如搜索林俊杰：

ncm-cli search song --keyword "林俊杰" --limit 3

也可以综合搜索：

ncm-cli search all --keyword "周杰伦"

2）查看每日推荐

ncm-cli recommend daily --limit 10

3）播放歌曲

搜索结果一般会返回：

• 加密 ID（encrypted id）
• 原始 ID（original id）

播放单曲时，需要同时带上这两个值：

ncm-cli play --song --encrypted-id <加密ID> --original-id <原始ID>

例如：

ncm-cli play --song --encrypted-id 48C847D31534FCB1793640501FCEAEE7 --original-id 26145728

4）播放控制命令

ncm-cli pause
ncm-cli resume
ncm-cli next
ncm-cli prev
ncm-cli stop
ncm-cli state

5）队列管理

ncm-cli queue
ncm-cli queue add --encrypted-id <加密ID>
ncm-cli queue clear

---

十三、OpenClaw 中怎么用？

完成以上步骤后，OpenClaw 就已经具备网易云音乐能力了。

你可以直接通过自然语言使用，例如：

• 帮我搜一下林俊杰的歌
• 推荐一些适合深夜听的歌
• 帮我播放《昨天的你的现在的未来》
• 帮我看看今日推荐
• 帮我建一个跑步歌单

这也是整套方案最香的地方：

你不再需要记住一堆命令，OpenClaw 会把自然语言转成具体操作。

---

十四、我实测后的结论

我这边实际跑下来，下面这些能力已经可以打通：

• 网易云开发者平台入驻
• AppID / PrivateKey 获取
• CLI 安装与配置
• 账号登录
• OpenClaw Skill 安装
• 搜索歌曲
• 推荐能力接入

也就是说：

“网易云音乐接入 OpenClaw，开放音乐推荐、搜索等能力” 这件事，是真能跑通的。

如果你本身就在折腾 Agent、自动化、桌面助手，这条路线非常值得试。

---

十五、实战中遇到的坑，提前告诉你

坑 1：PrivateKey 复制不完整

这是最常见的问题。

如果你发现一直认证失败，先检查：

• AppID 是否正确
• PrivateKey 是否完整
• 是否多了空格或换行

坑 2：能搜到歌，但不一定能播

有些歌曲虽然搜索结果里能看到，但不一定能真正播放。

建议重点看返回字段里是否：

• visible = true

如果是 visible = false，一般就不要强行播。

坑 3：mpv 已装，但后台播放不稳定

这次实测里，最容易卡住的不是搜索，也不是登录，而是 ncm-cli 的后台播放控制器。

典型表现：

• 搜索正常
• 登录正常
• mpv 正常
• 但播放状态和后台 daemon 偶尔不同步

这类问题本质上更偏向 ncm-cli 播放器链路的稳定性问题，而不是 OpenClaw 接入失败。

坑 4：建议先把“搜索 + 推荐”跑通

如果你的目标是先让 OpenClaw 具备音乐能力，那么建议优先保证：

• 搜索能用
• 推荐能用
• 每日推荐能用

至于播放链路，可以后续再慢慢优化稳定性。

---

十六、为什么我仍然推荐你做这套接入？

因为它真的很适合扩展。

接入完成后，你可以继续往下做这些场景：

• 飞书每日推送推荐歌单
• 根据时间段自动推荐音乐
• 根据情绪 / 场景推荐音乐
• 晨间模式自动播歌
• 睡前模式自动推荐轻音乐
• 与其他 Agent 工作流结合

这类场景一旦串起来，OpenClaw 的体验会非常像一个真正的“私人音乐助理”。

---

十七、总结

如果你也想把网易云音乐接入 OpenClaw，我建议你直接按下面这条主线走：

1. 完成个人开发者入驻
2. 获取 AppID / PrivateKey
3. 安装 @music163/ncm-cli
4. 安装 OpenClaw 对应 Skill
5. 配置凭证并登录网易云账号
6. 先验证搜索 / 推荐能力
7. 再逐步打通播放控制

一句话总结：

这套方案最大的价值，不是“能不能搜歌”，而是让 OpenClaw 真正拥有音乐能力。

这意味着你的助手不再只是一个聊天机器人，而是开始变成一个能理解你、推荐你、陪伴你的音乐入口。

---

十八、核心命令汇总（建议收藏）

安装 CLI

npm install -g @music163/ncm-cli

安装 Skill

clawhub install netease-music-cli
clawhub install netease-music-assistant
clawhub install ncm-cli-setup

配置凭证

ncm-cli config set appId <你的AppID>
ncm-cli config set privateKey <你的PrivateKey>

登录

ncm-cli login
ncm-cli login --check

安装并配置播放器

brew install mpv
ncm-cli config set player mpv

搜索 / 推荐 / 播放

ncm-cli search song --keyword "林俊杰" --limit 3
ncm-cli recommend daily --limit 10
ncm-cli play --song --encrypted-id <加密ID> --original-id <原始ID>
ncm-cli state

---

如果你也在折腾 OpenClaw、Agent、自动化工作流，这篇文章建议先收藏。后面把音乐能力接进去之后，可玩性真的会高很多。