🤖HermesBlog
Hermes 功能详解 · 第41篇2026/8/9· Easy Understand Hermes Agent

第41篇：Spotify 控制——让 AI 放音乐

Hermes 功能详解第41篇：Spotify。用 AI 控制你的音乐播放。

这篇讲的是如何让 Hermes Agent 直接操控你的 Spotify——搜歌、建歌单、控制播放，全用聊天搞定。

Spotify 控制：让 AI 放音乐

先搞明白：为什么这么麻烦？

Hermes 控制 Spotify 走的是官方 Web API，而且现在是通过插件目录里的官方 spotify 插件实现的——它由 Nous Research 维护在 NousResearch/hermes-official-plugins，不属于 Hermes 核心。这不是 Hermes 故意刁难你——Spotify 不允许第三方直接提供公共登录入口，每个人都要注册自己的小应用。整个过程大约两分钟，而且 hermes spotify login 会一步步带你走。

另外注意：免费账号能用搜索、歌单、收藏这些功能；Premium 账号才能控制播放（播放、暂停、切歌、调音量、加队列）。

第一步：安装插件并启用工具集

先装插件：

hermes plugins install spotify

插件是按 profile 安装的。要在另一个 profile 里用 Spotify，得在那里也装一遍（hermes -p <profile> plugins install spotify）。

装好后打开终端，运行：

hermes tools

在列表里找到 🔌 Spotify，按空格键打开它，然后按 s 保存。也可以直接：

hermes tools enable spotify

这个工具集是 opt-in 的——不想用的人就不会在每次 API 调用里多带一堆工具 schema。

从旧版本升级过来的用户：什么都不用做。只要某个 profile 之前已经在用 Spotify（auth.json 里有 Spotify 登录，或者 platform_toolsets 里列了 spotify 工具集），hermes update 会自动从插件目录装上插件；如果那一步没跑成，profile 首次启动时也会补装（受 security.allow_lazy_installs 控制）。你的登录、spotify 工具集和工具名都原样保留。唯一可见的变化：hermes auth spotify 现在叫 hermes spotify login（hermes auth status spotify / hermes auth logout spotify 也分别改成了 hermes spotify status / hermes spotify logout）；敲旧命令会提示你新写法。如果你之后手动移除插件（hermes plugins remove spotify），它就会保持移除状态。

第二步：登录（跟着向导走）

hermes spotify login

如果没设置 HERMES_SPOTIFY_CLIENT_ID，Hermes 会内联带你走一遍应用注册：

  1. 在浏览器打开 https://developer.spotify.com/dashboard
  2. 打印出要粘进 Spotify “Create app” 表单的确切值
  3. 提示你粘贴拿到的 Client ID
  4. 存到 ~/.hermes/.env，以后就不用再填
  5. 直接进入 OAuth 授权流程

点击 Create app，填写：

  • App name：随便填，比如 hermes-agent
  • App description：随便填
  • Website：留空
  • Redirect URI：http://127.0.0.1:43827/spotify/callback（这个必须一字不差）
  • Which API/SDKs?：勾选 Web API

保存后进入 Settings，复制 Client ID 粘贴回终端。不需要 Client Secret——PKCE 认证方式用不到它。

同意授权后，令牌会写到 ~/.hermes/auth.json 里的 providers.spotify 下。当前推理 provider 不会被改动——Spotify 认证和你的 LLM provider 是独立的。以后不用重复登录（大约半年过期，到时重新运行 hermes spotify login 即可）。

小提示：如果你是通过 SSH 远程操作，Hermes 不会自动打开浏览器。它会打印一个授权链接，你在本地浏览器打开即可。如果打不开，需要做端口转发：

ssh -N -L 43827:127.0.0.1:43827 user@remote-host

第三步：验证是否成功

hermes spotify status

看到令牌信息就说明搞定了。刷新是自动的：任何 Spotify API 调用返回 401 时，客户端会用 refresh token 换一次并重试一次。refresh token 跨 Hermes 重启保留，所以只有你在 Spotify 账号设置里撤销了应用、或者运行了 hermes spotify logout，才需要重新登录。

开始使用：像聊天一样放音乐

登录后，Hermes 多了 7 个 Spotify 工具。你不需要记命令，直接说人话：

> 放点 Miles Davis
> 我现在在听什么？
> 把这首歌加到我的 Late Night Jazz 歌单
> 切到下一首
> 新建一个叫"Focus 2026"的歌单，把我最近听的3首歌加进去
> 把我收藏的专辑里 Radiohead 的找出来
> 搜索 Blackbird 的翻唱版本
> 把播放转移到厨房音箱

几个实用细节

  • 播放控制需要设备：手机、电脑、音箱上至少有一个 Spotify 客户端处于打开状态。否则会报 403 Forbidden（提示 no active device），打开任意设备上的 Spotify 再试。
  • Home Assistant 用户：如果你的智能音箱（Sonos、Echo 等）支持 Spotify Connect，Hermes 能直接控制它们，不需要额外桥接——Spotify 自己处理设备路由。
  • 免费 vs Premium：搜索、查看歌单、获取播放状态这些只读操作免费可用；播放、暂停、切歌、调音量、加队列都要 Premium。
  • 401 反复出现：说明 refresh token 被撤销了（通常是你把应用从账号里移除了，或者应用被删了）。重新运行 hermes spotify login 即可。

小结

配置过程虽然多了一步“注册开发者应用”，但换来的是 AI 完全掌控你的音乐体验。一次性配置，长期享受——这也是 Hermes 系列里最“生活化”的功能之一。

下篇预告：第42篇，我们来聊聊 Hermes 的定时任务功能——让 AI 在指定时间自动干活，比如每天早上帮你查天气、汇总邮件。

📖 官方文档

本文根据 Hermes Agent 官方文档编写，原文见：官方文档 › user-guide/features/spotify

← 返回全部文章