Yandex Music Control

使用捆绑的辅助脚本执行确定性操作，而非重写 API 片段。

首次使用

1. 1. 阅读 references/token-and-control.md。
2. 检查令牌是否已通过 YM_TOKEN 或工作区配置文件可用。
3. 如果缺少令牌，请向用户索要令牌或引导其提供令牌；不要自行编造提取流程。
4. 使用以下命令验证令牌：

bash
scripts/ymctl.py auth-check

运行时

优先使用技能本地的虚拟环境解释器（若存在）：

bash
./.venv/bin/python scripts/ymctl.py ...

如果 .venv 缺失，则创建它并安装库：

bash
python3 -m venv .venv
./.venv/bin/pip install yandex-music

保存令牌

bash
./.venv/bin/python scripts/ymctl.py auth-set
./.venv/bin/python scripts/ymctl.py auth-set --device
./.venv/bin/python scripts/ymctl.py auth-where
./.venv/bin/python scripts/ymctl.py auth-clear

默认配置路径：

text
/root/.openclaw/workspace/.openclaw/yandex-music-control/config.json

常用命令

搜索曲目：

bash
./.venv/bin/python scripts/ymctl.py search кино группа крови
./.venv/bin/python scripts/ymctl.py search масло черного тмина --type artist

当前曲目：

bash
./.venv/bin/python scripts/ymctl.py now-playing

喜欢与播放列表：

bash
./.venv/bin/python scripts/ymctl.py likes --limit 20
./.venv/bin/python scripts/ymctl.py playlists
./.venv/bin/python scripts/ymctl.py like shortparis страшно
./.venv/bin/python scripts/ymctl.py unlike shortparis страшно

行为规则

• - 本技能以读取/搜索为导向：不声称具备实时传输控制功能。
• now-playing 使用本地 Ynison WebSocket 探测功能，适用于现代客户端。
• 不要将密钥回显到聊天中。
• 令牌处理应仅限于环境变量或工作区配置文件。

文件

• - 辅助脚本：scripts/ymctl.py
• 控制/令牌说明：references/token-and-control.md