OpenClaw Go Music V1 Skill

openclaw-go-music-v1-skill 是一个面向 OpenClaw 对话流程设计的音乐 skill。

当前 V1 提供 4 个能力：

1. 搜索歌曲
2. 返回稳定的本地播放地址
3. 下载歌曲
4. 获取歌词

这不是对 go-music-api 的薄封装，而是一层更贴近 OpenClaw 使用方式的本地 skill：

• 搜索结果会做排序、去噪和可播性优先
• 支持“播放第一首”“下载第一首”“第一首歌词”这种跟进式指令
• 优先返回本地 stream_url，避免直接把容易 403 的上游直链暴露给用户
• 当前源不可播时，会尝试自动换源

安装

这个仓库根目录本身就是 skill，不需要额外填写 path。

对话式安装时可以这样说：

安装 GitHub skill：Zeon814/openclaw-go-music-v1-skill

如果你的 OpenClaw 支持命令式安装，通常可以这样：

openclaw skills install --repo Zeon814/openclaw-go-music-v1-skill

依赖

首次使用前，目标机器需要：

• git
• go

首次调用脚本时，skill 会自动：

1. 检查并拉取 guohuiyuan/go-music-api
2. 在本机启动 127.0.0.1:8080
3. 启动自己的本地 V1 服务 127.0.0.1:37808

目录结构

openclaw-go-music-v1-skill/
  SKILL.md
  scripts/
    ensure-service.ps1
    search-song.ps1
    get-play-url.ps1
    download-song.ps1
    get-lyrics.ps1
  service/
    main.go
    handlers.go
    state.go
    backend.go
    lyrics.go

典型用法

安装后，可以直接在 OpenClaw 里这样说：

• 搜索 周杰伦 晴天
• 播放第一首
• 下载第一首
• 第一首歌词

也可以显式指定源和 ID：

• 播放 source=kuwo id=228908
• 下载 source=kuwo id=228908

当前边界

V1 暂时不包含：

• 歌单批量下载
• 专辑批量下载
• 桌面 UI
• Web UI
• 元数据嵌入

说明

这个仓库目前仍然借用 go-music-api 作为底层能力源，但对外接口和对话体验已经按 OpenClaw 方式重做。后续如果把底层进一步替换成更直接的 go-music-dl / music-lib 逻辑，skill 的上层交互可以保持不变。