尧图网站建设 
使用 OpenClaw 的 spotify-player 技能在终端控制 Spotify 播放与搜索【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw本篇技术指南以 OpenClaw 仓库内置技能 spotify-player 为核心讲解如何让 AI Agent 通过spogo首选或spotify_player备选两个终端客户端完成 Spotify 的歌曲搜索、播放/暂停/切歌、设备切换与状态查询。读完本文你将掌握该技能定义的完整语义、两个工具的前置条件与安装方式、逐条命令的实战用法以及它作为 OpenClaw Skills 如何被加载、门控与调用的底层机制。技能是什么一个目录、一份 SKILL.md在 OpenClaw 中技能Skill是一段教给 Agent「何时、如何使用某个工具」的 Markdown 指令。每个技能是一个目录内含带 YAML frontmatter 与 Markdown 正文的SKILL.md文件参见 创建技能的完整规范。本技能位于仓库的 skills/spotify-player/SKILL.md全目录仅此一个文件属于随项目分发的 bundled skills命名即来自 frontmatter 中的name: spotify-player。技能正文非常精炼目标只有一个当用户想让 Agent 在终端里播放或搜索 Spotify 音乐时优先使用spogo不可用时回退到spotify_player。整篇指令由三部分构成需求Requirements、spogo 配置与常用命令、spotify_player 备选命令及注意事项。frontmatter 逐字段拆解技能元数据如何驱动加载该技能头部 YAML 定义决定了它在 OpenClaw 技能体系中的可见性、门控条件与安装方式frontmatter 字段值作用namespotify-player技能唯一 slug也是用户/spotify-player斜杠命令名descriptionTerminal Spotify playback/search via spogo (preferred) or spotify_player.单行描述供 Agent 与发现输出展示homepagehttps://www.spotify.com在 Skills UI 中作为 Website 展示的站点metadata.openclaw.emoji技能展示图标metadata.openclaw.requires.anyBins[spogo, spotify_player]任一二进制存在于PATH即满足门控metadata.openclaw.install两条brew安装项通过 Homebrew 提供两种安装选择其中最关键的是requires.anyBins。与requires.bins要求所有二进制都存在不同anyBins只要求列表中至少一个二进制可用详见 Skills 门控字段说明。这正是「spogo 优先、spotify_player 兜底」双轨设计的落点用户装了任一工具本技能即可在条件匹配时被加载。使用前置条件技能文档明确列出两项需求一个Spotify Premium 付费账号。播放控制依赖 Premium 权限这也是调用spogo/spotify_player前应确认的基本前提本机安装了spogo或spotify_player二者之一。如果两个二进制都缺失由于requires.anyBins门控不满足该技能不会进入符合条件的技能集合Agent 也不会主动尝试用不存在的命令。安装两个终端客户端仓库 skill 元数据给出了两条等价的 Homebrew 安装路径你可以按需选择其一也可两个都装以实现完整回退链# 首选工具spogo来自 steipete/tap 第三方 tap brew install steipete/tap/spogo # 备选工具spotify_player brew install spotify_player安装后在 macOS Skills 设置界面中OpenClaw 网关会根据metadata.openclaw.install定义、安装偏好与宿主机brew是否存在来选择执行安装器参见 macOS 平台的技能安装行为。完成安装后建议用openclaw skills list确认技能已就绪详见下文「技能在 OpenClaw 中的运行机制」。首选方案spogo 的配置与常用命令spogo 是技能标注的首选播放/搜索工具。开始使用前需先完成一次会话授权。初始化授权导入浏览器 Cookiespogo auth import --browser chrome该命令把 Chrome 浏览器中已登录的 Spotify 会话 Cookie 导入到 spogo从而完成认证无需另行申请 OAuth 凭据。技能只给出了 Chrome 这一浏览器选项若导入后认证仍失败可重新执行该命令刷新 Cookie 会话。常用命令速查技能正文列出的 spogo 命令覆盖搜索、播放控制、设备管理与状态查询四个场景场景命令说明搜索spogo search track query按曲目关键词搜索query替换为实际检索词播放控制spogo play/spogo pause/spogo next/spogo prev播放、暂停、下一首、上一首设备管理spogo device list列出当前可用的播放设备设备切换spogo device set name|id把播放目标切到指定名称或 ID 的设备状态查询spogo status查看当前播放状态曲目/播放器/设备等在 Agent 场景中的典型编排是用户说「放一首 XXX」Agent 先spogo search track XXX找到目标再用spogo device listspogo device set锁定目标音箱或输出设备最后spogo play开始播放需要切换曲目时用next/prev。备选方案spotify_player 的使用当spogo不在PATH上时技能要求回退到spotify_player命令风格略有差异场景命令说明搜索spotify_player search query搜索曲目/专辑/艺人播放控制spotify_player playback play/pause/next/previous注意子命令动词拼写为previous与 spogo 的prev不同连接设备spotify_player connect建立/切换播放设备连接喜欢曲目spotify_player like把当前曲目标记为喜欢由于两个工具的参数形态并不一致技能特意为 Agent 写明各自独立的命令集避免混用。spotify_player 的配置与注意事项技能 Notes 补充了三条实战细节配置文件目录~/.config/spotify-player典型配置文件为app.toml。如需自定义行为可在此处修改Spotify Connect 集成要在 spotify_player 中启用 Spotify Connect需在配置中填入用户自己的client_id即用户级 API 凭据而非工具默认值TUI 快捷键spotify_player内置交互界面应用内按?可随时查看快捷键帮助。技能在 OpenClaw 中的运行机制加载、门控与检查要把这份技能说明放进项目语境理解需要看 OpenClaw 技能系统的三层机制加载与优先级文件型技能按优先级从高到低依次为 Workspace skillsworkspace/skills、Project agent skillsworkspace/.agents/skills、Managed skillsstate-dir/skills、Bundled skills随安装包分发等加载顺序完整表见 Skills 加载顺序。本技能即处于 bundled 层如果你想覆盖它可在 workspace 的skills/spotify-player/SKILL.md放置同名更高优先级副本。目录支持分组嵌套最多 6 层技能名始终以namefrontmatter 为准。门控过滤加载时会按requires.anyBins检查spogo/spotify_player是否存在只有至少一个命中才把该技能暴露给 Agent。这意味着未装任一客户端时本技能静默不加载也不会产生误导性指令。就绪检查与命令面可用openclaw skills check查看缺失的前置依赖无论技能是否被 allowlist 排除都会如实上报用openclaw skills list --eligible查看当前符合条件的技能命令参考见 openclaw skills CLI。技能就绪后既可由 Agent 依据系统提示自动决定调用也可通过/spotify-player斜杠命令显式触发。从源码结构可以推断技能正文会被注入/检索为 Agent 的操作指引它只负责「教 Agent 用什么命令、按什么优先级」实际的exec等工具调用由 Agent 运行时统一发起因此本技能自身无需携带脚本或依赖。实战要点与排查建议综合技能定义与 OpenClaw 体系实际使用时建议遵循以下策略始终先探测 spogo技能将 spogo 标为首选因其命令更贴近播放控制语义next/prevAgent 可先尝试 spogo 子命令报错如 command not found再切到spotify_player的对应拼写。注意两个工具的参数差异prevspogo与previousspotify_player、device setspogo与connectspotify_player并不等价回退时应整体切换命令集而不是只换二进制名。认证与会话spogo 依赖从浏览器导入的 Cookie 完成认证若长时间未使用或 Cookie 过期导致操作失败重跑spogo auth import --browser chrome即可刷新。设备定位播放前先spogo device list确认目标设备再用spogo device set name|id显式指定避免播放落到意外设备上。确认 Premium 与配置若播放/控制被拒先核对账号是否为 Spotify Premium使用 spotify_player 的 Connect 功能时检查~/.config/spotify-player/app.toml中是否已填入自己的client_id。相关资源技能原始定义skills/spotify-player/SKILL.md如何编写自定义 SKILL.mdSkills 加载顺序与门控机制openclaw skills 命令行参考macOS 平台的技能安装行为【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 使用 OpenClaw 的 spotify-player 技能在终端控制 Spotify 播放与搜索
使用 OpenClaw 的 spotify-player 技能在终端控制 Spotify 播放与搜索【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw本篇技术指南以 OpenClaw 仓库内置技能 spotify-player 为核心讲解如何让 AI Agent 通过spogo首选或spotify_player备选两个终端客户端完成 Spotify 的歌曲搜索、播放/暂停/切歌、设备切换与状态查询。读完本文你将掌握该技能定义的完整语义、两个工具的前置条件与安装方式、逐条命令的实战用法以及它作为 OpenClaw Skills 如何被加载、门控与调用的底层机制。技能是什么一个目录、一份 SKILL.md在 OpenClaw 中技能Skill是一段教给 Agent「何时、如何使用某个工具」的 Markdown 指令。每个技能是一个目录内含带 YAML frontmatter 与 Markdown 正文的SKILL.md文件参见 创建技能的完整规范。本技能位于仓库的 skills/spotify-player/SKILL.md全目录仅此一个文件属于随项目分发的 bundled skills命名即来自 frontmatter 中的name: spotify-player。技能正文非常精炼目标只有一个当用户想让 Agent 在终端里播放或搜索 Spotify 音乐时优先使用spogo不可用时回退到spotify_player。整篇指令由三部分构成需求Requirements、spogo 配置与常用命令、spotify_player 备选命令及注意事项。frontmatter 逐字段拆解技能元数据如何驱动加载该技能头部 YAML 定义决定了它在 OpenClaw 技能体系中的可见性、门控条件与安装方式frontmatter 字段值作用namespotify-player技能唯一 slug也是用户/spotify-player斜杠命令名descriptionTerminal Spotify playback/search via spogo (preferred) or spotify_player.单行描述供 Agent 与发现输出展示homepagehttps://www.spotify.com在 Skills UI 中作为 Website 展示的站点metadata.openclaw.emoji技能展示图标metadata.openclaw.requires.anyBins[spogo, spotify_player]任一二进制存在于PATH即满足门控metadata.openclaw.install两条brew安装项通过 Homebrew 提供两种安装选择其中最关键的是requires.anyBins。与requires.bins要求所有二进制都存在不同anyBins只要求列表中至少一个二进制可用详见 Skills 门控字段说明。这正是「spogo 优先、spotify_player 兜底」双轨设计的落点用户装了任一工具本技能即可在条件匹配时被加载。使用前置条件技能文档明确列出两项需求一个Spotify Premium 付费账号。播放控制依赖 Premium 权限这也是调用spogo/spotify_player前应确认的基本前提本机安装了spogo或spotify_player二者之一。如果两个二进制都缺失由于requires.anyBins门控不满足该技能不会进入符合条件的技能集合Agent 也不会主动尝试用不存在的命令。安装两个终端客户端仓库 skill 元数据给出了两条等价的 Homebrew 安装路径你可以按需选择其一也可两个都装以实现完整回退链# 首选工具spogo来自 steipete/tap 第三方 tap brew install steipete/tap/spogo # 备选工具spotify_player brew install spotify_player安装后在 macOS Skills 设置界面中OpenClaw 网关会根据metadata.openclaw.install定义、安装偏好与宿主机brew是否存在来选择执行安装器参见 macOS 平台的技能安装行为。完成安装后建议用openclaw skills list确认技能已就绪详见下文「技能在 OpenClaw 中的运行机制」。首选方案spogo 的配置与常用命令spogo 是技能标注的首选播放/搜索工具。开始使用前需先完成一次会话授权。初始化授权导入浏览器 Cookiespogo auth import --browser chrome该命令把 Chrome 浏览器中已登录的 Spotify 会话 Cookie 导入到 spogo从而完成认证无需另行申请 OAuth 凭据。技能只给出了 Chrome 这一浏览器选项若导入后认证仍失败可重新执行该命令刷新 Cookie 会话。常用命令速查技能正文列出的 spogo 命令覆盖搜索、播放控制、设备管理与状态查询四个场景场景命令说明搜索spogo search track query按曲目关键词搜索query替换为实际检索词播放控制spogo play/spogo pause/spogo next/spogo prev播放、暂停、下一首、上一首设备管理spogo device list列出当前可用的播放设备设备切换spogo device set name|id把播放目标切到指定名称或 ID 的设备状态查询spogo status查看当前播放状态曲目/播放器/设备等在 Agent 场景中的典型编排是用户说「放一首 XXX」Agent 先spogo search track XXX找到目标再用spogo device listspogo device set锁定目标音箱或输出设备最后spogo play开始播放需要切换曲目时用next/prev。备选方案spotify_player 的使用当spogo不在PATH上时技能要求回退到spotify_player命令风格略有差异场景命令说明搜索spotify_player search query搜索曲目/专辑/艺人播放控制spotify_player playback play/pause/next/previous注意子命令动词拼写为previous与 spogo 的prev不同连接设备spotify_player connect建立/切换播放设备连接喜欢曲目spotify_player like把当前曲目标记为喜欢由于两个工具的参数形态并不一致技能特意为 Agent 写明各自独立的命令集避免混用。spotify_player 的配置与注意事项技能 Notes 补充了三条实战细节配置文件目录~/.config/spotify-player典型配置文件为app.toml。如需自定义行为可在此处修改Spotify Connect 集成要在 spotify_player 中启用 Spotify Connect需在配置中填入用户自己的client_id即用户级 API 凭据而非工具默认值TUI 快捷键spotify_player内置交互界面应用内按?可随时查看快捷键帮助。技能在 OpenClaw 中的运行机制加载、门控与检查要把这份技能说明放进项目语境理解需要看 OpenClaw 技能系统的三层机制加载与优先级文件型技能按优先级从高到低依次为 Workspace skillsworkspace/skills、Project agent skillsworkspace/.agents/skills、Managed skillsstate-dir/skills、Bundled skills随安装包分发等加载顺序完整表见 Skills 加载顺序。本技能即处于 bundled 层如果你想覆盖它可在 workspace 的skills/spotify-player/SKILL.md放置同名更高优先级副本。目录支持分组嵌套最多 6 层技能名始终以namefrontmatter 为准。门控过滤加载时会按requires.anyBins检查spogo/spotify_player是否存在只有至少一个命中才把该技能暴露给 Agent。这意味着未装任一客户端时本技能静默不加载也不会产生误导性指令。就绪检查与命令面可用openclaw skills check查看缺失的前置依赖无论技能是否被 allowlist 排除都会如实上报用openclaw skills list --eligible查看当前符合条件的技能命令参考见 openclaw skills CLI。技能就绪后既可由 Agent 依据系统提示自动决定调用也可通过/spotify-player斜杠命令显式触发。从源码结构可以推断技能正文会被注入/检索为 Agent 的操作指引它只负责「教 Agent 用什么命令、按什么优先级」实际的exec等工具调用由 Agent 运行时统一发起因此本技能自身无需携带脚本或依赖。实战要点与排查建议综合技能定义与 OpenClaw 体系实际使用时建议遵循以下策略始终先探测 spogo技能将 spogo 标为首选因其命令更贴近播放控制语义next/prevAgent 可先尝试 spogo 子命令报错如 command not found再切到spotify_player的对应拼写。注意两个工具的参数差异prevspogo与previousspotify_player、device setspogo与connectspotify_player并不等价回退时应整体切换命令集而不是只换二进制名。认证与会话spogo 依赖从浏览器导入的 Cookie 完成认证若长时间未使用或 Cookie 过期导致操作失败重跑spogo auth import --browser chrome即可刷新。设备定位播放前先spogo device list确认目标设备再用spogo device set name|id显式指定避免播放落到意外设备上。确认 Premium 与配置若播放/控制被拒先核对账号是否为 Spotify Premium使用 spotify_player 的 Connect 功能时检查~/.config/spotify-player/app.toml中是否已填入自己的client_id。相关资源技能原始定义skills/spotify-player/SKILL.md如何编写自定义 SKILL.mdSkills 加载顺序与门控机制openclaw skills 命令行参考macOS 平台的技能安装行为【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考