Nest设备控制

技能简介

通过Google Smart Device Management (SDM) API，使用curl和jq命令行工具远程控制Google Nest系列智能设备，包括温控器、摄像头、门铃及智能音箱。

能做什么

• 查询并调节Nest温控器温度与运行模式
• 获取摄像头实时画面与直播流地址
• 控制智能音箱音量与播放状态
• 批量列出企业项目下的所有授权设备

使用说明

前置准备（必须完成）：

1. 访问 Google Cloud Console 创建新项目
2. 在「API与服务 → 库」中启用「Smart Device Management API」
3. 创建OAuth 2.0客户端ID，下载JSON文件提取client_id和client_secret
4. 前往 nests.google.com 注册并同意服务条款
5. 用refresh_token换取access_token：

   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

安装与配置：

本技能依赖系统已安装的curl和jq。将环境变量写入shell配置文件：

export GOOGLE_HOME_CLIENT_ID="your-client-id"
export GOOGLE_HOME_CLIENT_SECRET="your-client-secret"
export GOOGLE_HOME_ACCESS_TOKEN="your-access-token"

或创建配置文件~/.config/google-home/config.json：

{
  "project_id": "your-google-cloud-project-id",
  "access_token": "your-oauth-access-token"
}

常用命令示例：

# 列出所有设备
google-home-cli devices

# 查看客厅温控器状态
google-home-cli thermostat "Living Room" --info

# 设置目标温度72华氏度
google-home-cli thermostat "Living Room" --temp 72

# 获取前门摄像头状态
google-home-cli camera "Front Door" --status

# 下载当前画面截图
google-home-cli camera "Front Door" --snapshot

项目附带scripts/nest辅助脚本，可软链接至全局路径使用简化命令。

输入与输出

见下方输入与输出表格。

风险提示

• Access Token具有有效期，需定期刷新避免中断
• OAuth凭证泄露可能导致设备被未授权控制
• 摄像头直播流需要额外权限申请，默认可能无法直接获取
• 温度单位默认为摄氏度，华氏度需自行换算
• 设备ID使用完整路径格式，复制时容易遗漏前缀

来源信息

• 原始链接：https://github.com/openclaw/skills/tree/main/skills/mitchellbernstein/google-home/SKILL.md
• 来源类型：GitHub仓库