很好玩!OpenClaw控制网易云听歌!
做梦都没想到,和 AI 八杆子打不着的网易云,推出了播放音乐的 CLI。
为的是方便 OpenClaw 或者 Claude Code 调用!

虽然八杆子打不着,其实还挺好玩的。
养龙虾的可以直接让小龙虾帮你找歌,放歌,创建歌单。
程序员们可以直接使用 Claude Code 或者命令行来进行这些操作。
控制过程可以用自然语言来下命令。
是不是有点搞头,那么来搞一搞吧!
简单看一下官方介绍和功能特性。
网易云音乐命令行工具,基于网易云音乐开放平台 API,提供音乐搜索、播放控制、歌单管理、每日推荐、TUI 播放器等功能,并支持通过 AI Agent 进行自然语言操作。
功能特性
具体包含了以下功能特性:
- 音乐搜索与播放控制
- 歌单管理与每日推荐
- TUI 播放器(旋转黑胶、歌词同步、场景切换)
- AI Agent 集成支持
- 多播放器后端支持(mpv)
好像能控制的还挺多!
玩起来
为了能调用自己的网易云播放歌曲,需要做两件事情。
第一个安装它的 CLI 工具。第二个配置网易云的 API。
安装CLI
打开终端工具,直接输入如下命令:
npm install -g @music163/ncm-cli
ncm-cli --version
Windows用户直接空白处右键 ,在终端中打开,输入命令后按回车。
第一行是安装,第二行是确认是否安装成功。

安装成功就会输出版本号了。
绑定平台
CLI 只是一个本地工具,为了访问网易云,还需要授权接入。
前往 网易云音乐开放平台 完成入驻:

根据指引填写相关信息,做两次身份认证,然后初始化应用,进入应用,获取 App ID 和 Private Key。
然后运行配置向导:
ncm-cli configure
配置向导会引导完成以下设置:
- App ID
- Private Key
- 播放器选择

Private Key 这个步骤,文件模式一直失败,我选择了粘贴 base64 的方式。
然后默认播放器选择了 内置播放器!
这里可能遇到安装失败的问题,因为没有 mpv。
遇到这种情况的话,单独安装一下 mpv 这个程序。
如果使用它提供的命令行搞不定,就直接去下载mpv 的 EXE 文件,添加环境变量就可以了。
绑定个人账号
上面的搞完之后,就可以运行登录登录自己的账号了
ncm-cli login
输入命令之后会生成一个二维码。
使用网易云音乐 App 扫描终端中的二维码完成登录授权。
到这里配置就全部完成了!
测试一下
首先根据搜索命令搜索林俊杰的歌曲。
然后从结果中找到两个 ID,一个叫 encrypted-id,一个叫 original-id。
具体命令如下:
ncm-cli search song --keyword "林俊杰"
ncm-cli play --song --encrypted-id 加密 ID --original-id 原始 ID
返回内容大致如下:
"originalId": 29814898,
"id": "66BD3177EAxxxx260B57AF6A44D75975",
"name": "可惜没如果",
"duration": 298293,
"artists": [
{
"originalId": 3684,
"id": "610913C74xxxx037F503C8DE819ECD5E",
"name": "林俊杰",
"coverImgUrl": null
}
其中的 ID 就是 encrypted-id,originalId 就是 original-id。
把这两个 ID 替换到上面的命令中:

输入命令回车按一下回车,电脑上就会想起歌声了。由于是命令播放的,不会显示任何软件。
如果你要停止的话,就输入ncm-cli stop 命令就可以了。
CLI 命令行
除了上面的命令之外,还包括了:
ncm-cli search # 搜索音乐
ncm-cli play # 播放
ncm-cli pause # 暂停
ncm-cli resume # 恢复播放
ncm-cli next # 下一首
ncm-cli prev # 上一首
ncm-cli volume 60 # 设置音量(0-100)
ncm-cli state # 查看播放状态
ncm-cli --help # 查看所有可用命令
TUI 播放器
除了用上面的命令之外,还可以打开 TUI 播放器。
命令如下:
ncm-cli tui
全屏终端播放器,支持旋转黑胶动画、歌词同步、场景切换等功能。
这个播放器还挺复古的:

我是第一次用基于终端 CLI 的播放器,感觉还挺好玩的!
在这个界面上,可以使用快捷控制播放行为。
| 快捷键 | 功能 |
|---|---|
Space | 播放 / 暂停 |
← → | 上一首 / 下一首 |
↑ ↓ | 音量 +5 / -5 |
S | 随机 / 顺序播放切换 / 单曲循环 |
L | 歌词视图 |
Q | 播放列表视图 |
C | 场景选择器 |
H | 收藏 / 取消收藏 |
Ctrl+C | 退出 |
上面的操作如果太过专业,不好记忆,那么可以通过技能接入 Agent。
然后就可以自然语言进行音乐操作。
打开这个地址:
https://github.com/NetEase/skills
可以找到网易云音乐的技能。
OpenClaw 集成
官方提供的安装命令如下:
ln -s $(pwd)/skills/netease-music-cli ~/.openclaw/skills/
ln -s $(pwd)/skills/netease-music-assistant ~/.openclaw/skills/
我推荐,直接把上面的 GitHub 地址甩给 OpenClaw 或者任意 Claw,让他们自己装去。
原理就是把网易云技能拷贝到~/.openclaw/skills/
比如我打开本地 OpenClaw 的 TUI,然后发送如下要求:

它很利落地就把三个技能都安装好了。
然后我只要跟他说“使用网易云播放可惜没如果”:

这个时候音乐就响起来。
界面上没有任何软件弹出,但是音乐已经响起来了。
理论上任意龙虾都可以,比如微信的 QClaw:

然后给它下命令,让它播放:

……我收回我上面的话。有些龙虾不行!
你这个狗屁沙盒~~
掰扯了好久,死活干不成,很糟糕的体验!
安全考虑是有必要的,但是如果我授权了,你怕什么,你把 C 盘格式化也是我的责任!
Claude Code 集成
官方提供的安装命令如下:
npx skills add https://github.com/NetEase/skills
Claude Code 集成的话,我建议直接把这个地址甩给它让它安装就可以了。
原理就是把网易云技能拷贝到 Claude Code 的技能目录下。
然后直接用自然语言提需求就可以了:

轻松搞定,没有任何废话,这就是 Claude Code 的执行力!
这两个工具的安装其实都很简单。
唯一不简单的是,你本地电脑可能无法访问 GitHub,或者有什么 S 逼沙盒!
自然语言控制
集成后支持以下对话示例:
> 帮我搜一下林俊杰的歌
> 播放晴天
> 推荐一些适合深夜听的歌
> 帮我创建一个跑步歌单
你的Agent就会根据Skill去执行了。
其实SKill的执行效率非常低,如果你自己能写命令的话,毫米级的启动速度。
但是你要记住命令和处理json格式也是比较累的。
真的是世道变了,以前都是给人做界面,现在是都在给 AI 做接口。
很多产品都推出了 CLI,希望能赶上 Agent 这班列车!
参考链接
开发平台:
开源地址: