什么是 Spotify Intelligence？

Spotify Intelligence 是一个高性能音乐管理模块，旨在与 AI 智能体无缝集成。它利用 Spotify API 提供超越基础播放的功能；它集成了一个反馈循环和决策引擎，根据不断演变的用户偏好来策划音乐。通过利用 Openclaw Skills，开发者可以赋能其智能体处理复杂的音乐任务，如情绪转换推荐、播放列表治理和可解释的决策。

该技能通过一系列模块化的 Python 入口点运行，确保了音乐自动化的稳健和可扩展框架。它超越了标准的 API 封装，通过维护自己的本地状态和逻辑层，允许智能体理解为什么选择特定歌曲，以及它们如何与用户当前的上下文或历史反馈保持一致。

下载入口:https://github.com/openclaw/skills/tree/main/skills/kanazumie/spotify-intelligence

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Spotify Intelligence 应用场景

• 根据特定情绪、活动或环境触发器自动播放音乐。
• 使用专门的 passend（匹配）、mood-shift（情绪转换）或 explore（探索）模式生成智能歌曲推荐。
• 构建一个反馈感知的音乐库，实时学习跳过、点赞和不喜欢等行为。
• 维护所有播放列表决策和 AI 驱动音乐选择的治理记录，以便进行审计。

1. 该技能使用存储在 data/tokens.json 中的本地 OAuth 凭据通过 Spotify API 进行身份验证。
2. 用户或父智能体通过 Python 运行程序进行交互，以控制播放、搜索歌曲或请求推荐。
3. 系统处理用户反馈（包括点赞、不喜欢和跳过），以更新内部评分模型。
4. 定期重建衍生特征，以根据更新的反馈循环提高推荐准确性。
5. 每一个决策和操作都记录在本地 SQLite 数据库中，以确保治理和可解释的 AI 逻辑。

Spotify Intelligence 配置指南

要开始使用 Openclaw Skills 库中的此插件，请按照以下步骤操作：

1. 设置所需的环境变量：

export SPOTIFY_CLIENT_ID='your_client_id'
export SPOTIFY_CLIENT_SECRET='your_client_secret'
export SPOTIFY_REDIRECT_URI='your_callback_url'

2. 运行身份验证脚本以生成本地令牌：

python scripts/auth/oauth_auth.py

3. 确保初始化本地数据目录以存储令牌和 SQLite 数据库。

Spotify Intelligence 数据架构与分类体系

该技能通过 JSON 和 SQLite 格式管理数据，以确保 Openclaw Skills 生态系统内的持久性和性能：

name: spotify-intelligence
description: "Spotify intelligence skill with Python runners for auth, playback control, recommendations, feedback loop, governance, and explainable playlist decisions."
metadata:
  required-env:
    - SPOTIFY_CLIENT_ID
    - SPOTIFY_CLIENT_SECRET
    - SPOTIFY_REDIRECT_URI (optional)
  primary-credential: SPOTIFY_CLIENT_ID + SPOTIFY_CLIENT_SECRET
  local-storage:
    - data/tokens.json
    - data/spotify-intelligence.sqlite
  notes:
    - Uses Spotify API only (api.spotify.com and accounts.spotify.com)
    - Stores OAuth tokens locally on the host

Spotify Intelligence (ClawHub Edition)

This edition is ClawHub-validator compatible (text + python-focused).
The full local Windows edition may include additional PowerShell wrappers.

Required env

• SPOTIFY_CLIENT_ID
• SPOTIFY_CLIENT_SECRET
• optional SPOTIFY_REDIRECT_URI

Core Python entrypoints

• Auth token exchange: scripts/auth/oauth_auth.py
• Playback control: scripts/playback/playback_control.py
• Recommendations: scripts/recommend/recommend-now.py
• Recommendation helper: scripts/recommend/recommend_commands.py
• Derived features: scripts/decision/rebuild-derived-features.py

Key capabilities

• Playback (play/pause/next/previous/volume/device/queue)
• Song search with own-playlist preference + global fallback
• Recommendation modes: passend, mood-shift, explore
• Feedback-aware scoring (like/dislike/skip/keep)
• Governance and decision logging (DB-backed)

References

• references/read-layer.md
• references/playback-control.md
• references/recommendation-layer.md
• references/feedback-loop.md
• references/governance-cost.md
• references/status-handover-2026-02-24.md