1. 为什么要把网易云音乐塞进 OpenClawOpenClaw 本身是个能跑 Skill 的 Agent 框架但默认状态下它跟音乐这件事没什么关系。你让它搜歌它只能给你一段文字描述你让它播放它没有任何播放链路。而网易云音乐开放平台提供了官方 CLI 工具music163/ncm-cli配合 OpenClaw 的 Skill 机制可以把搜索、推荐、歌单、播放控制这些能力变成 Agent 可以直接调用的命令。这套方案适合谁三类人一是已经在用 OpenClaw 做桌面助手或自动化工作流想让助手多一个音乐入口二是折腾过 AI Agent 但不想自己逆向接口希望走官方合规路线三是想用自然语言控制本地播放器比如 mpv不想每次手动打开客户端搜歌点播放。核心检索词先明确OpenClaw 是 Agent 运行框架网易云音乐开放平台提供 AppID/PrivateKey 凭证ncm-cli是官方命令行工具Skill 是 OpenClaw 调用外部能力的封装层mpv 是本地播放器。整条链路是自然语言 → OpenClaw Skill → ncm-cli → 网易云 API → mpv 播放。我试过把这套流程完整跑一遍踩过的坑主要集中在凭证配置和播放器 daemon 同步上。下面按实战顺序拆开讲每一步都给可复制的命令和配置。2. 前置准备TaoToken 统一 Key 与 OpenClaw 环境在装 Skill 之前先把 OpenClaw 的模型调用链路配好。OpenClaw 本身需要一个大模型后端来理解自然语言并决定调用哪个 Skill这里用 TaoToken 做统一 Key 管理好处是一个 Key 可以覆盖多个模型不用在 OpenClaw 里来回切换配置。TaoToken 的定位是模型 API 聚合层官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。你需要在控制台创建一个 API Key然后把它写进 OpenClaw 的配置里。先确认基础环境node -v npm -v两个命令都能输出版本号即可。OpenClaw 建议用较新版本ncm-cli依赖 Node 18 以上。接着在 TaoToken 控制台拿到 Key 后配置到 OpenClaw 的模型后端。OpenClaw 的配置文件通常在~/.openclaw/config.toml骨架如下[model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model claude-sonnet-4-20250514 [skills] dir ~/.openclaw/skills这里base_url指向 TaoToken 的 API 入口api_key填你在控制台生成的 Key。模型名按你实际订阅的填TaoToken 支持多个模型选一个响应稳定的即可。注意config.toml里的 Key 不要提交到 Git建议用环境变量注入或加.gitignore。如果你还没创建 Key去 https://taotoken.net/api-keys 生成一个。这一步是整个链路的前提OpenClaw 没有模型后端就无法把帮我搜林俊杰的歌翻译成ncm-cli search song命令。3. 安装 ncm-cli 与 OpenClaw Skill网易云音乐开放平台提供了官方 CLI包名music163/ncm-cli。全局安装npm install -g music163/ncm-cli装完检查版本ncm-cli --version能输出版本号说明安装成功。如果报command not found检查 npm 全局 bin 目录是否在 PATH 里macOS 下通常是/usr/local/bin或~/.npm-global/bin。接下来装 OpenClaw 的 Skill。官方文档建议装三个clawhub install netease-music-cli clawhub install netease-music-assistant clawhub install ncm-cli-setup三个 Skill 分工不同。netease-music-cli负责基础能力搜索、播放、暂停、下一首、队列管理、歌单操作。netease-music-assistant负责智能推荐偏好分析、多关键词策略、结合上下文推荐。ncm-cli-setup是配置辅助帮你检查凭证和登录状态不是强制但建议装上。装完后 Skill 目录结构大致是这样~/.openclaw/skills/ ├── netease-music-cli/ │ ├── SKILL.md │ ├── skill.toml │ └── scripts/ │ ├── search.sh │ ├── play.sh │ └── control.sh ├── netease-music-assistant/ │ ├── SKILL.md │ └── skill.toml └── ncm-cli-setup/ ├── SKILL.md └── skill.toml每个 Skill 的skill.toml定义了触发条件和调用命令。OpenClaw 在收到自然语言请求时会匹配对应 Skill 并执行scripts/下的脚本。你不需要手动改这些脚本除非要自定义播放器参数。4. 配置凭证、登录与 mpv 播放器这一步是整条链路最容易出问题的地方。先去网易云音乐开放平台控制台拿到AppID和PrivateKey然后写入 ncm-clincm-cli config set appId 你的AppID ncm-cli config set privateKey 你的PrivateKey检查配置ncm-cli config list如果输出里能看到 appId 和 privateKey 就对了。PrivateKey 通常是一长串复制时容易漏掉尾部字符或带入换行建议用ncm-cli config list核对长度。接着登录网易云账号ncm-cli login如果支持后台登录可以加--backgroundncm-cli login --background登录后检查状态ncm-cli login --check成功时输出类似{ success: true, message: 已登录实名账号 }然后配置播放器。本文用 mpv先安装brew install mpv把 ncm-cli 的播放器切到 mpvncm-cli config set player mpv确认ncm-cli config get player输出player: mpv即可。到这里凭证、登录、播放器三件事都配好了可以进入验证阶段。5. 验证请求搜索、推荐、播放全链路先验证搜索能力。搜林俊杰ncm-cli search song --keyword 林俊杰 --limit 3返回结果里会包含每首歌的encrypted_id和original_id这两个值播放时都要用。综合搜索可以用ncm-cli search all --keyword 周杰伦再看每日推荐ncm-cli recommend daily --limit 10播放单曲时把搜索返回的两个 ID 都带上ncm-cli play --song --encrypted-id 加密ID --original-id 原始ID例如ncm-cli play --song --encrypted-id 48C847D31534FCB1793640501FCEAEE7 --original-id 26145728播放控制命令ncm-cli pause ncm-cli resume ncm-cli next ncm-cli prev ncm-cli stop ncm-cli state队列管理ncm-cli queue ncm-cli queue add --encrypted-id 加密ID ncm-cli queue clear验证成功的标志是ncm-cli state返回当前播放状态mpv 窗口弹出并开始播放。如果state显示playing但没声音检查 mpv 是否被静音或音频输出设备是否正确。回到 OpenClaw 侧现在你可以直接用自然语言帮我搜一下林俊杰的歌 推荐一些适合深夜听的歌 帮我播放《起风了》 帮我看看今天的每日推荐OpenClaw 会通过 Skill 把自然语言转成上面的 ncm-cli 命令并执行。这一步跑通说明整条链路已经打通。6. 本篇常见报错排查报错一认证失败提示 invalid appId 或 privateKey最常见的原因是 PrivateKey 复制不完整。检查ncm-cli config list里的值是否和开放平台控制台一致注意有没有多余空格或换行。AppID 是数字PrivateKey 是长字符串两者不要填反。报错二能搜到歌但播放失败搜索结果里有些歌的visible字段是false这类歌曲通常没有播放权限强行播会报错。建议在 Skill 脚本里加一层过滤只播visible true的结果。另外检查original_id和encrypted_id是否配对两个 ID 来自同一首歌混用会失败。报错三mpv 已装但后台播放状态不同步典型表现是搜索正常、登录正常、mpv 也能启动但ncm-cli state和实际播放状态偶尔不一致。这类问题偏向 ncm-cli 播放器 daemon 的稳定性不是 OpenClaw 接入失败。可以尝试重启 daemonncm-cli stop ncm-cli play --song --encrypted-id 加密ID --original-id 原始ID如果频繁出现建议先把搜索和推荐跑通播放链路后续再优化。报错四OpenClaw 不触发音乐 Skill检查~/.openclaw/config.toml里的skills.dir是否指向正确目录以及 Skill 是否真的装到了那个目录下。另外确认模型后端TaoToken配置正确模型无法理解意图时不会调用 Skill。可以在 OpenClaw 里手动触发一次 Skill 看日志。报错五ncm-cli 命令找不到全局安装后 PATH 没生效。macOS 下检查npm config get prefix把对应的 bin 目录加到~/.zshrc的 PATH 里然后source ~/.zshrc。7. 继续扩展与 CTA搜索、推荐、播放跑通之后可玩性会高很多。你可以把每日推荐接到飞书或 Telegram 做定时推送也可以根据时间段自动切换歌单比如晨间模式播轻音乐、跑步模式播节奏强的歌。这些场景本质上都是在 OpenClaw 里加一层定时触发或条件判断底层还是调 ncm-cli 的命令。如果你在配置凭证或接入 OpenClaw 时遇到报错先去 TaoToken 控制台确认 API Key 状态再对照接入文档检查config.toml的base_url和api_key字段https://taotoken.net/api-keys 和 https://taotoken.net/doc 。想先验证模型对话是否正常可以用模型对话入口测一条请求https://taotoken.net/models 。如果你打算长期跑编码类或 Agent 类任务Coding Plan 的额度模型更适合持续调用https://taotoken.net/coding-plan 。整套流程的核心不是能不能搜歌而是让 OpenClaw 从聊天助手变成能实际执行操作的 Agent。先把搜索和推荐跑稳播放链路的稳定性可以慢慢调。