agentCLAWHUBUnverified
酷狗
酷狗，酷狗音乐，酷狗skill，酷狗音乐skill，酷狗音乐助手 提供歌曲搜索、猜你喜欢、相似推荐、收藏管理、听歌统计、酷狗榜单、创建歌单、调整音乐偏好等功能。 **触发场景**（满足任一即使用本技能）： - 用户要求推荐歌曲、听歌建议 - 用户要求搜索歌曲、查找歌手作品 - 用户要求查看音乐榜单（飙升榜、TOP500、抖音热歌等） - 用户要求查看收藏、最近播放、听歌统计 - 用户要求创建歌单、自建歌单 - 用户要求调整音乐偏好（"少推点 XX 歌手"、"多推点 XX 语种"、"别再推 XX 曲风" 等） - 用户提供 base64 secret 字符串要求登录或导入身份 - Agent Skill: 酷狗 Owner: shamo88 Summary: 酷狗，酷狗音乐，酷狗skill，酷狗音乐skill，酷狗音乐助手 提供歌曲搜索、猜你喜欢、相似推荐、收藏管理、听歌统计、酷狗榜单、创建歌单、调整音乐偏好等功能。 **触发场景**（满足任一即使用本技能）： - 用户要求推荐歌曲、听歌建议 - 用户要求搜索歌曲、查找歌手作品 - 用户要求查看音乐榜单（飙升榜、TOP500、抖音热歌等） - 用户要求查看收藏、最近播放、听歌统计 - 用户要求创建歌单、自建歌单 - 用户要求调整音乐偏好（"少推点 XX 歌手"、"多推点 XX 语种"、"别再推 XX 曲风" 等） - 用户提供 base64 secret 字符串要求登录或导入身份 - Agent Tags: latest:0.1.20 Version history: v0.1.20 | 2026-09-14T03:04:35.881Z | user kugou-sk
OpenClaw
Rank
62
Safety
84
Downloads
1.2k
Updated
Oct 11, 2026
Version
0.1.20
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.2K downloadsadoption · observed Oct 11, 2026
- Latest release
- 0.1.20release · observed Sep 14, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17817v0twfch5vbdchhmj7nh588v7tg:kugou-skill- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-shamo88-kugou-skill/snapshot"
Documentation
CLAWHUB
144,711 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: kugou-skill
description: |
酷狗，酷狗音乐，酷狗skill，酷狗音乐skill，酷狗音乐助手
提供歌曲搜索、猜你喜欢、相似推荐、收藏管理、听歌统计、酷狗榜单、创建歌单、调整音乐偏好等功能。
**触发场景**（满足任一即使用本技能）：
- 用户要求推荐歌曲、听歌建议
- 用户要求搜索歌曲、查找歌手作品
- 用户要求查看音乐榜单（飙升榜、TOP500、抖音热歌等）
- 用户要求查看收藏、最近播放、听歌统计
- 用户要求创建歌单、自建歌单
- 用户要求调整音乐偏好（"少推点 XX 歌手"、"多推点 XX 语种"、"别再推 XX 曲风" 等）
- 用户提供 base64 secret 字符串要求登录或导入身份
- Agent 在尝试扫码登录时遇到环境限制（无法发图片）→ 主动询问用户是否可提供 secret
- 用户提到"酷狗"、"kugou"、"猜你喜欢"、"相似歌曲"
- 用户要求让 PC/Mac 客户端播放歌曲、暂停、切歌、收藏、创建歌单
- 用户提到酷狗 URL scheme（"kugou://" 或 "mackugou://"）
- 用户提到"本机控制"、"控制酷狗客户端"
**与其他音乐技能的区别**：酷狗音乐以推荐算法见长，榜单数据实时更新，适合获取热门歌曲和个性化推荐；同时支持把用户偏好（歌手/语种/曲风等）实时反馈给推荐引擎。
安装方式：npm install -g @kg-ai/kugou-skill
---
# kugou-skill
## AI 使用工作流（优先阅读）
使用本工具时的标准流程：
```
1. 检查安装 → npm install -g @kg-ai/kugou-skill
2. 检查登录态 → kugou-cli auth status
3. 登录决策（按以下优先级严格判断，不要跳步）：
├─ 状态 a：已登录（logged_in: true）→ 跳到第 6 步
├─ 状态 b：未登录 + 用户**明确**说"我有 secret" → 调 `kugou-cli auth set-secret "<secret>"` 一次完成 → 跳到第 6 步
├─ 状态 c：未登录 + 当前环境**无法**渲染远程 URL 图片 **且** 无法读取本地二维码文件 → **强制**走 set-secret（同上）
└─ 状态 d：未登录 + 其他所有情况 → 走扫码流程（第 4 步）
注意：状态 b/c/d 互斥；不要在用户未明确给 secret 时擅自走 set-secret。
4. 引导登录——扫码（详见 references/auth.md）：
- 执行 `auth login`，从输出读 `qrcode_img_url` 和 `qrcode_img_path`，按当前客户端能力选一种方式把二维码**直接展示给用户**
- **阶段 A（主动轮询）**：图片刚展示，**主动**重试几次 `auth status`（每次隔几秒），覆盖用户秒扫场景
- 任意一次返回 `logged_in: true` → 跳到第 6 步
- 见到 `status: failed` → **不要换新图**，隔 1-2 秒用同一个本地 qrcode 再调一次（计入阶段 A 的 5 次预算）
- 见到 `status: expired` → 告诉用户二维码已失效，调 `auth login` 拿新图，从阶段 A 重新开始
- 几次都返回 `waiting` / `failed` 且未出现 `scanned` / `logged_in` / `expired` → 进入阶段 B
- **阶段 B（等用户回复）**：停下，告诉用户"请用酷狗 APP 扫码登录，扫完后告诉我已扫码"，**不再调 status**，等用户**主动回复"已扫码"**
- **阶段 C（验证一次）**：用户回复"已扫码"后，**调一次** `auth status`：
- `logged_in: true` → 完成，跳到第 6 步
- `scanned`（已扫但未确认）→ 等几秒再调一次，最多**额外**调几次，仍是 scanned 就告诉用户"手机端是否已点确认？"
- `failed` → **不要换新图**，隔 1-2 秒用同一个本地 qrcode 再调一次，最多重试 2-3 次；仍 failed 则告诉用户稍后重试
- `expired` / `{"logged_in": false}`（无 status 字段，说明本地 qrcode 已被上游清掉）→ 重新 `auth login` 拿新图（覆盖本地），从阶段 A 重新开始
5. **首次要展示歌曲/歌单前探测本机客户端可用性**（详见 [references/control.md §13](references/control.md#13-client-detection-control-detect)）：
- **触发时机**：本会话中第一次要向用户展示歌曲列表、歌单列表或歌单内歌曲列表之前。后续展示**复用本次探测结果**（会话内探测一次即可，不要每条命令前都跑）
- **命令**：`kugou-cli control detect`（零副作用，不启动客户端、不抢焦点）
- **判定**：
- 退出码 `0` → 本机有客户端，标记 `client_available = true`
- 退出码 `2` → 本机没装客户端，标记 `client_available = false`
- 退出码 `1` → 探测过程出错（注册表权限等），按 `false` 处理并继续
- **不影响 control 命令本身**：当用户主动要求 `control play` 等命令时，仍按原本的 `control` 错误处理（找不到客户端会由 `control start` 报"handshake file not found"，不要用探测结果跳过 `control` 调用）
- **何时不探测**：用户请求只查询统计数据、查收藏/最近播放、看错误页等**不展示歌曲列表**的纯查询场景；登录流程本身；debug / 排错场景
6. 按请求类型分流：
- **请求类型 A：控制已有歌 / 歌单 / 收藏**（用户已有 mixsongid 或 global_id）→ 直接执行 `control` 命令（详见 [references/control.md](references/control.md)），不需要先调 `music` 拿 ID
- 例：`control play`_meta.json
{
"ownerId": "kn7crmv8zas1ep290wm2ag0wtn88te0q",
"slug": "kugou-skill",
"version": "0.1.20",
"publishedAt": 1789355075881
}references/auth.md
# 认证命令 (auth)
> 🔐 = 需要先登录
## 命令列表
| 命令 | 说明 | 需要登录 |
|------|------|---------|
| `kugou-cli auth login` | 获取二维码（`qrcode` 内部字符串 + `qrcode_img_url` 远程图片 URL + `qrcode_img_path` 本地 PNG 路径） | 否 |
| `kugou-cli auth status` | 检查登录状态（**单次查询，不内部轮询**，agent 需外层循环 2-3s 间隔） | 否 |
| `kugou-cli auth set-secret <secret>` | 直接导入已持有的 base64 secret 登录（跳过扫码） | 否 |
| `kugou-cli auth logout` | 登出 | 否 |
---
## 1. 扫码登录
登录流程极简：
```bash
# Step 1: 获取二维码，同时得到远程 URL 和本地 PNG 路径
kugou-cli auth login
# Step 2: 循环调用 status（**单次查询不内部轮询**，agent 自己外层循环）
# 每次间隔 2-3 秒，看到 logged_in=true / status=success 即完成
kugou-cli auth status
```
**auth login 输出示例**:
```json
{"qrcode": "xxx", "qrcode_img_path": "C:\\Temp\\kugou-qrcode.png", "qrcode_img_url": "https://static.kugou.com/.../qrcode.png"}
```
字段说明：
- `qrcode`：二维码字符串标识，**Agent 不要使用** —— 仅供 CLI 内部持久化，以便后续 status 调上游 check 接口
- `qrcode_img_path`：CLI 生成的本地二维码 PNG 文件绝对路径。当前客户端支持读取或附加本地图片时使用它，例如 Codex 等本地文件能力较强的客户端
- `qrcode_img_url`：酷狗上游返回的远程二维码图片 URL。当前客户端支持 Markdown 外链图片时使用它，例如 WorkBuddy 等客户端
- `qrcode_img_path` 和 `qrcode_img_url` 是两种并行的图片展示方式，Agent 根据当前客户端能力自行选择一种，不要同时展示两张二维码
---
## 2. AI 引导流程
### 2.1 决策点：先问 secret，再选路径
在调用任何 auth 命令之前，**先询问用户**：
> "你手上是否已有可用的 base64 secret 字符串？（从其他设备/工具导出的）"
- **用户明确说"有"** → 直接走 §3 `set-secret`，跳过 §1 扫码
- **用户说"没有"或不确定** → 走 §2.2 扫码流程
- **当前环境无法发送图片**（纯文本 agent、SSH 远端、容器）→ 强制走 §3 `set-secret`，不要走扫码
> **默认行为**：除非用户明确说"我有 secret"，否则优先走扫码。
### 2.2 扫码流程
1. 调用 `auth login`，读取返回的 `qrcode_img_path` 和 `qrcode_img_url`
2. **根据当前客户端能力选择一种方式展示二维码图片**：
- 客户端支持读取或附加本地文件（如 Codex 等）→ 优先使用 `qrcode_img_path`，通过客户端的本地图片读取/附件能力展示。不要只把路径作为普通文本发给用户
- 客户端支持 Markdown 外链图片（如 WorkBuddy 等）→ 使用 `qrcode_img_url`，在消息中输出 ``
- Agent 可以自行选择最适合当前环境的方式，不要同时展示两张二维码
- **避免**只输出“请打开 xxx URL”或“图片路径是 xxx”这种纯文字提示，用户应直接看到二维码图片
- 选择的方式展示失败时，切换到另一种方式：远程图片加载失败则尝试本地文件，本地文件无法读取则尝试远程 Markdown 图片
- 如果当前客户端既不能读取本地文件，也不能渲染远程 Markdown 图片 → 放弃扫码，切换到 §3 `set-secret` 路径
3. **阶段 A — 主动轮询（覆盖秒扫）**：图片展示后，**主动**外层循环调用 `auth status`，每次间隔 2-3 秒，**最多 5 次**（与 `failed` 重试合并计数）：
- 看到 `logged_in: true` → 完成，继续执行用户请求
- 看到 `status: success` → 完成，继续执行用户请求
- 看到 `status: scanned` → 等几秒再调一次 status
- 看到 `status: failed` → **不要换新图**，隔 1-2 秒后用同一个本地 qrcode 再调一次 status（计入 5 次轮询预算）
- 看到 `status: expired` → **不再继续轮询**，主动告诉用户"二维码已失效，正在重新获取"，调 `auth login` 拿新图，回到步骤 1
- 5 次都是 `waiting` / `failed` → 进入阶段 B
4. **阶段 B — 等待用户反馈（关键）**：5 次主动轮询后仍未登录，**停下来**，不再调任何 auth 命令。主动告诉用户：
> "请用酷狗 APP 扫码登录，扫完后告诉我已扫码"
然后**等用户主动回复**。**不要**自己继续轮询。
5. **阶段 C — 验证登录**：用户回复"已扫码"后，调一次 `auth status` 验证：
- `logged_in: true` → 完成，继续执行用户请求
- `status: scanned` → 用户在手机上还没点确认，等几秒再调一次
- `status: failed` → **不要换新图**，隔 1-2 秒后用同一个本地 qrcode 再调一次 status（最多重试 2-3 次）
- `status: expired` → 上游明确说过期（CLI 已清理本地），重新 `auth login` 拿新图，回到步骤 1
- `logged_in: false`（无 status 字段）→ qrcode 已被清理（通常是上一步 `expired` 后状态），提示用户"二维码可能已过期，正在重新获取"并回到步骤 1
6. **若用户在阶references/control.md
# 控制命令 (control)
> AI-facing usage guide for `kugou-cli control` — the local PC/Mac Kugou client control subcommands.
本模块通过本机 HTTP server 控制 PC/Mac 酷狗客户端，支持播放控制、收藏管理、歌单创建等操作。输出格式为原始 JSON（详见 [references/output-format.md](./output-format.md)）。
**前置条件**: CLI 已登录（`kugou-cli auth login`）+ 酷狗客户端正在运行。仅支持 Windows / macOS（Linux 运行时会报错，见下方错误场景）。
---
## 命令列表
### 读操作（read）
| 命令 | 说明 |
|------|------|
| `kugou-cli control start` | 显式触发握手/唤起客户端（用于预热或调试） |
| `kugou-cli control status` | 获取客户端状态（协议版本、登录态、能力列表） |
| `kugou-cli control current` | 获取当前播放歌曲（歌名、进度、音量、收藏状态） |
### 播放器控制（player）
| 命令 | 说明 |
|------|------|
| `kugou-cli control play` | 播放歌曲（按 mixsongid） |
| `kugou-cli control play-playlist` | 播放整个歌单（按 global_collection_id） |
| `kugou-cli control continue-play` | 拉取"另一设备续播"列表并开始播放 |
| `kugou-cli control player` | 播放器控制（播放/暂停/切歌/停止） |
| `kugou-cli control seek` | 进度控制（快进/快退/跳转） |
| `kugou-cli control volume` | 音量控制（增减/设置/静音） |
### 账户操作（account）
| 命令 | 说明 |
|------|------|
| `kugou-cli control favorite song` | 收藏/取消收藏歌曲 |
| `kugou-cli control favorite songlist` | 收藏/取消收藏歌单 |
| `kugou-cli control playlist create` | 创建本地歌单（带歌曲列表） |
### 系统操作（utility）
| 命令 | 说明 |
|------|------|
| `kugou-cli control open` | 打开客户端内页面（主界面/歌手/专辑/歌单/搜索） |
| `kugou-cli control doctor` | 诊断 `control start` 失败的根因（HVCI / VBS / launcher / home-dir） |
---
## 1. start — 显式触发握手
触发酷狗客户端的 URL scheme 唤起，等待客户端建立本机 HTTP 通道并返回状态。仅用于预热通道或调试连通性，不调用任何 `/v1/...` 业务接口。
```bash
kugou-cli control start
```
**输出示例**（成功）:
```json
{"handshake":"ok","addr":"http://127.0.0.1:52144"}
```
**输出示例**（失败）:
```
kugou-cli control: not logged in, run `kugou-cli auth login` first: auth file not found
```
**`start` 失败时优先跑 `control doctor` 诊断根因**（见下文 §N）。常见场景：
- Win11 Memory Integrity (HVCI) 开着 + 客户端 v20.1.40：HVCI 拦截客户端启动时访问的内存，触发 NTSTATUS 0xC0000005 → 关 HVCI 后重试
- PowerShell 被裁掉（Windows Sandbox / AppContainer）：URL scheme 触发失败 → 自动 fallback 到 `cmd /c start`
- $HOME / $USERPROFILE 未设置或不可写：握手文件无法落地 → 设置有效环境变量
---
## 2. status — 获取客户端状态
查询本地酷狗客户端的协议版本、登录态和能力列表。
```bash
kugou-cli control status
```
**输出示例**:
```json
{
"code": 0,
"data": {
"version": "1.0.0",
"login": true,
"capabilities": ["play", "pause", "seek", "volume", "favorite", "playlist"]
}
}
```
---
## 3. current — 获取当前播放
查询当前播放歌曲详情，包括歌名、歌手、进度、音量和收藏状态。
```bash
kugou-cli control current
```
**输出示例**:
```json
{
"code": 0,
"data": {
"song_name": "晴天",
"singer_name": "周杰伦",
"mixsongid": "32100650",
"position_ms": 45000,
"duration_ms": 240000,
"volume": 65,
"favorited": false
}
}
```
---
## 4. play — 播放歌曲
在客户端播放一首歌曲。`--mixsongid` 必填，其余字段可选（仅用于客户端展示，不影响播放命中）。
```bash
kugou-cli control play --mixsongid 32100650 --song-name "晴天" --singer-name "周杰伦"
kugou-cli control play --mix-song-id 32100650 --mode "append_queue"
```
**参数**:
| 参数 | 说明 |
|------|------|
references/error-handling.md
# 错误处理 > **判定优先级**：退出码（非 0 = 失败）→ stdout body 的 `errcode` 字段 → stderr 文案。 > Agent **不应依赖 stderr 文案字面量**判断错误类型——文案可能随版本变化；以退出码和下表为准。 --- ## 常见错误及处理 | 错误信息 | 原因 | 处理方式 | |---------|------|---------| | `账号登录过期，请重新登录` | 登录态已过期（errcode 语义由上游约定）。CLI 已**自动**清理本地登录态 | 引导用户重新登录：`kugou-cli auth login`（扫码）或 `kugou-cli auth set-secret "<新 secret>"` | | `not logged in` / `auth file not found` | 未登录 | 引导用户执行 `kugou-cli auth login` | | `HTTP error: 400` | 请求参数有误 | 检查命令参数是否正确 | | `HTTP error: 500` | 服务端错误 | 稍后重试，或告知用户 | | `API error: <errmsg> (code=<N>)` | 业务错误（上游 errcode ≠ 0） | 根据 errmsg 提示用户 | | `network error: ...` | 网络连接问题 | 检查网络，可尝试 `--proxy` | | `failed to get device info` | 设备信息获取失败（仅 control） | 运行时环境异常，检查权限 |
Github ReposUpdated 1d agoRank 70
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
OPENCLAW
Github ReposUpdated 6mo agoRank 70
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
OPENCLAW
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/shamo88/skills/kugou-skill",
"sourceUrl": "https://clawhub.ai/shamo88/skills/kugou-skill",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T04:43:08.802Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-shamo88-kugou-skill/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-shamo88-kugou-skill/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T04:43:08.802Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.2K downloads",
"href": "https://clawhub.ai/shamo88/kugou-skill",
"sourceUrl": "https://clawhub.ai/shamo88/kugou-skill",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T04:43:08.802Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.1.20",
"href": "https://clawhub.ai/shamo88/kugou-skill",
"sourceUrl": "https://clawhub.ai/shamo88/kugou-skill",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-14T03:04:35.881Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-shamo88-kugou-skill/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-shamo88-kugou-skill/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.1.20",
"description": "kugou-skill 0.1.20 - 新增“调整音乐偏好”相关说明，支持按歌手/语种/曲风进行推荐偏好调整 - 描述中强化偏好反馈功能，明确支持基于用户反馈实时调整推荐 - 触发场景增加“调整音乐偏好”类请求的支持 - 移除文档 `skill-card.md` - 其他描述及细节文案微调",
"href": "https://clawhub.ai/shamo88/kugou-skill",
"sourceUrl": "https://clawhub.ai/shamo88/kugou-skill",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-14T03:04:35.881Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.