智能家居技能

直接从 CLI-JAW 控制您的物理环境。智能家居技能在您的 AI 助手与物联网设备之间架起桥梁，让您可以使用自然语言命令管理 Philips Hue 照明和 Spotify 音乐播放。

概述

CLI-JAW 内置了两个智能家居技能，通过各自的 API 连接到主流设备生态系统。两个技能均以 MCP（Model Context Protocol）服务器的形式实现，当代理检测到相关请求时按需加载。

openhue — Philips Hue 控制

openhue 技能与本地网络上的 Philips Hue Bridge 进行通信。它提供用于控制单个灯光、房间、区域和场景的 MCP 工具。

功能

配置

将 openhue MCP 服务器添加到您的 CLI-JAW 设置中。需要提供 Bridge IP 地址和 API 密钥。

{
  "mcpServers": {
    "openhue": {
      "command": "npx",
      "args": ["-y", "@openhue/mcp-server"],
      "env": {
        "OPENHUE_BRIDGE_IP": "192.168.1.100",
        "OPENHUE_API_KEY": "your-hue-api-key"
      }
    }
  }
}

要获取 Hue API 密钥，请按下 Hue Bridge 上的物理链接按钮，然后运行：

curl -X POST http://192.168.1.100/api \
  -d '{"devicetype":"cli-jaw#instance"}'

自然语言示例

工作原理

当您说类似"불 켜줘"这样的话时，CLI-JAW 会通过其技能匹配系统路由请求：

1. 代理识别出该意图是一个智能家居命令
2. 加载 openhue MCP 服务器（如果尚未运行）
3. 代理调用相应的工具（例如，set_room 并设置 on: true）
4. Hue Bridge 执行命令并返回更新后的状态
5. 代理以自然语言确认操作结果

spotify-player — Spotify 控制

spotify-player 技能连接到 Spotify Web API，让 CLI-JAW 能够完全控制音乐播放。它支持搜索曲目、管理队列、控制播放以及浏览播放列表。

功能

配置

添加 spotify-player MCP 服务器，并填入您的 Spotify OAuth 凭据。

{
  "mcpServers": {
    "spotify-player": {
      "command": "npx",
      "args": ["-y", "spotify-player-mcp"],
      "env": {
        "SPOTIFY_CLIENT_ID": "your-client-id",
        "SPOTIFY_CLIENT_SECRET": "your-client-secret",
        "SPOTIFY_REDIRECT_URI": "http://localhost:8888/callback"
      }
    }
  }
}

OAuth 设置

1. 前往 Spotify Developer Dashboard
2. 创建一个新应用，并将重定向 URI 设置为 http://localhost:8888/callback
3. 将 Client ID 和 Client Secret 复制到您的配置文件中
4. 首次使用时，CLI-JAW 将打开浏览器窗口进行 Spotify 授权
5. 授权通过后，刷新令牌将缓存在本地，供后续会话使用

自然语言示例

组合工作流

当智能家居技能彼此结合使用，或与其他 CLI-JAW 功能搭配时，将变得更加强大。由于代理能够理解上下文，您可以自然地发出复合命令。

# Example: the agent interprets "영화 볼 준비 해줘" as:
1. openhue → set_room(room="Living Room", brightness=20)
2. openhue → set_scene(scene="Relax", room="Living Room")
3. spotify-player → pause()

故障排除

环境变量参考