介绍
# Google Home / Nest CLI
通过 curl + jq 使用 Smart Device Management (SDM) API 控制 Google Nest 设备。
## 设置（必需）
1. **创建 Google Cloud 项目** - 访问 https://console.cloud.google.com - 创建一个新项目
2. **启用 SDM API** - API 和服务 → 库 - 搜索“Smart Device Management” - 启用它
3. **创建 OAuth 凭证** - API 和服务 → 凭证 - 创建 OAuth 2.0 客户端 ID - 下载 JSON 文件 - 提取 `client_id` 和 `client_secret`
4. **注册您的设备** - 访问 https://nests.google.com/frame/register-user - 接受条款
5. **获取访问令牌** ```bash # Replace with your values curl -s \ -d "client_id=YOUR_CLIENT_ID" \ -d "client_secret=YOUR_CLIENT_SECRET" \ -d "refresh_token=YOUR_REFRESH_TOKEN" \ -d "grant_type=refresh_token" \ https://www.googleapis.com/oauth2/v4/token ```
## 快速开始
```bash # List devices google-home-cli devices
# Get thermostat info google-home-cli thermostat "Living Room" --info
# Set temperature (heat/cool/auto) google-home-cli thermostat "Living Room" --temp 72
# Query camera google-home-cli camera "Front Door" --status ```
## 设备命令
### 恒温器 - `google-home-cli thermostat <name>` — 显示当前温度/湿度 - `--temp <degrees>` — 设置目标温度 - `--mode heat|cool|auto` — 设置 HVAC 模式 - `--fan on|auto` — 控制风扇
### 摄像头和门铃 - `google-home-cli camera <name>` — 获取直播流/状态 - `--snapshot` — 下载当前图像 - `--stream` — 启动实时流 URL
### 扬扬器和显示屏 - `google-home-cli speaker <name>` — 设备信息 - `--volume 0-100` — 设置音量 - `--stop` — 停止播放
## 环境变量
```bash export GOOGLE_HOME_CLIENT_ID="your-client-id" export GOOGLE_HOME_CLIENT_SECRET="your-client-secret" export GOOGLE_HOME_ACCESS_TOKEN="your-access-token" ```
## 替代方案：直接 API 调用
```bash # List all devices curl -s -H "Authorization: Bearer $ACCESS_TOKEN" \ "https://smartdevicemanagement.googleapis.com/v1/enterprises/YOUR_PROJECT_ID/devices"
# Get device traits curl -s -H "Authorization: Bearer $ACCESS_TOKEN" \ "https://smartdevicemanagement.googleapis.com/v1/enterprises/YOUR_PROJECT_ID/devices/YOUR_DEVICE_ID" ```
## 辅助脚本
`scripts/nest` 中包含了一个 `nest` CLI 辅助工具：
```bash # Make it available globally ln -sf /Users/mitchellbernstein/clawd/skills/google-home/scripts/nest /usr/local/bin/nest
# List devices nest list
# Get thermostat status nest status "enterprises/PROJECT_ID/devices/DEVICE_ID"
# Set temperature (Celsius) nest temp "enterprises/PROJECT_ID/devices/DEVICE_ID" 22
# Set mode nest mode "enterprises/PROJECT_ID/devices/DEVICE_ID" HEAT ```
## 配置
创建 `~/.config/google-home/config.json`：
```json { "project_id": "your-google-cloud-project-id", "access_token": "your-oauth-access-token" } ```
## 注意事项
- 令牌会过期；请定期刷新 - 设备名称使用完整路径：`enterprises/PROJECT_ID/devices/DEVICE_ID` - 温度单位为摄氏度（如需要，请从华氏度转换） - 摄像头直播流需要额外权限