Sponsored by
Ankon AI
一个基于 Python 的 CLI 工具，通过使用官方 Spotify Web API 的 AI 代理来控制 Spotify 播放和设备。
egemenyerdelen
v1.0.1
2026年2月27日
0
958
0
安装与下载
1. ClawHub CLI
从源直接安装技能的最快方式。
npx clawhub@latest install spotify-controller
2. 手动安装
将技能文件夹复制到以下位置之一
全局模式
~/.openclaw/skills/ 工作区
<project>/skills/ 优先级：工作区 > 本地 > 内置
3. 提示词安装
将此提示词复制到 OpenClaw 即可自动安装。
请帮我使用 Clawhub 安装 spotify-controller。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
更倾向于下载？
获取包含原生技能文件的ZIP压缩包。
什么是 Spotify 控制器？
Spotify 控制器技能使 AI 代理能够直接与 Spotify Web API 交互，以管理音乐播放和设备状态。它专门设计用于解决无头环境（如 VPS 或 Docker 容器）中控制媒体的挑战，在这些环境中本地音频输出不可用。通过利用 Openclaw Skills，开发人员可以赋予其代理播放曲目、调节音量以及在 Spotify Connect 设备之间无缝切换的能力。
这种集成允许实现一种复杂的流程，即代理充当远程控制器。由于它使用官方 Web API，因此不需要在服务器本身运行本地 Spotify 客户端。相反，它向任何活动设备（如智能手机、智能音箱或桌面应用）发送命令，使其成为任何 Openclaw Skills 集合的多功能补充。
Spotify 控制器 应用场景
- 通过基于终端的 AI 代理控制远程扬声器上的音乐播放。
- 自动播放由特定编码里程碑或环境变化触发的对焦主题播放列表。
- 在无头服务器上管理 Spotify 会话，无需图形用户界面。
- 使用自然语言命令搜索并立即播放曲目或特定的 Spotify URI。
Spotify 控制器 工作原理
- AI 代理执行带有特定命令（如 play、pause 或 search）的 spotify.py 脚本。
- 脚本从环境配置中检索必要的凭据（客户端 ID、密钥和刷新令牌）。
- 向 Spotify Web API 发送请求，以在用户账户上执行请求的操作。
- Spotify 的 API 将命令传递给当前活跃的 Spotify Connect 设备。
- 脚本捕获 API 响应，并将状态更新或数据负载返回给 Openclaw Skills 框架内的代理。
Spotify 控制器 配置指南
- 安装所需的 Python 依赖项：
uv pip install requests --system
- 在 Spotify 开发者仪表板创建一个 Spotify 开发者应用，并将重定向 URI 设置为 http://127.0.0.1:8888/callback。
- 通过浏览器授权应用并通过 POST 请求交换授权代码来获取刷新令牌。
- 将您的凭据添加到 .env 文件：
SPOTIFY_CLIENT_ID=your_id
SPOTIFY_CLIENT_SECRET=your_secret
SPOTIFY_REFRESH_TOKEN=your_token
- 将这些变量传递到您的 Docker 容器中并重启服务以激活 Openclaw Skills 功能。
Spotify 控制器 数据架构与分类体系
| 元素 | 类型 | 描述 |
|---|---|---|
| spotify.py | 脚本 | 与 Spotify Web API 接口的核心逻辑。 |
| 环境变量 | 凭据 | 客户端 ID、密钥和刷新令牌的安全存储。 |
| 命令行参数 | 输入 | 诸如状态、播放、暂停、音量和搜索等参数。 |
| Spotify URI | 标识符 | 用于定位特定曲目或专辑进行播放的唯一字符串。 |
Spotify 控制器 高级特性
- 支持无头 VPS 部署，允许从没有声卡的服务器进行媒体控制。
- 动态设备切换，通过 CLI 在不同的 Spotify Connect 目标之间转移播放。
- 集成的搜索并播放逻辑，自动执行第一个搜索结果。
- 实时播放状态监控，为 Openclaw Skills 内的 AI 代理提供上下文。
SKILL.md
加载中
Openclaw 相关技能
精选*
Tripo AI
基于 AI 的 3D 模型生成器，支持从图像和文本生成 3D 模型。
Ankon AI
在几分钟内将提示词、PDF、文档、博客、脚本和图片转换为 AI 白板视频。
Teammates.ai
AI驱动的客户服务、销售和潜在客户生成解决方案。
Masonry AI
一个提示，所有 AI 模型：在画布中比较各平台的图像和视频生成
ThumbnailCreator.com
AI工具，用于快速创建令人惊艳的YouTube缩略图。
Mailmodo AI
完整的邮件营销自动化与 AI 代理
APIMart
AI API, 99.9% SLA 保证。您的 AI 服务，永不掉线。
Rekam AI-Your One-Stop Voice Creation Platform
全能 AI 声音创作平台，提供文本到语音、声音克隆和语音转文本。
Gobii
雇佣自动化您的网络工作流程的人工智能员工 — 基于一个全天候运行的生产级平台，无需维护烦恼。
Verdent
只需几分钟，用大白话构建您的产品
Topview AI
#1 营销视频代理 - 将您的产品转化为病毒视频
Typecast
具备逼真 AI 语音和数字人形象的 AI 语音生成器及内容创作工具。
Airbrush Studio
一款专为追求快速、高质量、精美人像的用户而设计的桌面端照片编辑软件。
Articos
Articos 是一个快速、免招募的用户研究平台，可帮助您验证产品创意、测试用户体验流程并了解客户需求，而无需花费数周时间寻找真实参与者。您无需预约电话和处理失约，而是通过与符合您目标用户画像的逼真模拟用户进行人工智能主持的访谈。在短时间内，您将获得清晰的反馈，了解人们理解什么、困惑什么、愿意支付什么，以及什么会阻止他们使用您的产品。它专为需要在投入时间和预算构建错误方向之前获得快速指导的创始人、产品经理、设计师和代理机构而设计。
AirMusic
AI 音乐与视频生成器，助力创作独特的免版税曲目和爆款内容。
Free
APIDot
统一的 AI API 平台，提供低成本、生产级的图像和视频模型集成方案。
NewsBang
由AI驱动的新闻平台，提供摘要、见解和互动播客。
PaioClaw
一个安全、托管式的平台，可在 60 秒内快速部署并自动化运行 OpenClaw AI 助手。
Vmake AI
AI 社交视频工作室：创作、提升并优化极具带货力的社交短视频。
Zawa
面向小微企业的 AI 品牌套件生成器与设计工具
Free