小智 Plus 设备控制

要解决什么问题

如果你已经在用 小智 这类端侧智能设备，真正麻烦的部分往往不是「说一句话」，而是把意图落到具体设备上：要知道是哪台机器（deviceId，通常是 MAC）、用哪把钥匙（apiKey），再选对 HTTP 路径和参数。本技能把这套约定封装进 OpenClaw 调用流程，让 Agent 在对话里直接发聊天、控播放器、调音量亮度，而不必每次手写请求。

技能如何工作

底层是对固定 Base URL 与 /api/xiaozhi/ 前缀下的一组 POST 接口的封装，认证方式为 Bearer Token。每次调用前，技能文档要求同时带上：

• deviceId：设备 MAC，例如 30:ed:a0:ae:05:08
• apiKey：平台分配的 API Key

文档中标注为已验证的能力包括：

| 场景 | 端点（节选） | 关键参数 |
|------|--------------|----------|
| 对话 | SendChatMessage | message |
| 音乐 | SendPlayMusicMessage / SendStopMusicMessage 等 | keywords 或仅 deviceId |
| 播放模式 | SendPlayerModeMessage | playerMode：SEQUENCE、RANDOM、LIST_LOOP、SINGLE_LOOP |
| 设备状态 | SendVolumeMessage / SendBrightnessMessage | value（0–100） |
| 界面 | SendThemeMessage | value：light / dark |

典型自然语言意图如「播放周杰伦」「音量调到 50」「切换到随机播放」，会被映射到上述端点；待机、上一曲/下一曲、恢复播放等多为仅需 deviceId 的调用。

适用边界与注意点

• 凭据与设备绑定：deviceId、apiKey 需由用户提供或从会话记忆中取得，技能本身不替你发现局域网设备。
• 接口范围：以 SKILL 中列出的端点为「已验证」集合；未列出的能力不要假设存在。
• 环境与可达性：请求发往文档中的服务地址；若你的网络或部署与作者环境不一致，需在集成前自行验证连通性与鉴权。
• 设备名：展示用名称可与 MAC 分开维护，但实际控制仍以 deviceId 为准。