Nest智能家居控制

技能简介

通过Google Smart Device Management API连接并操控Nest智能设备，支持温控器温度调节、模式切换、摄像头实时画面获取及门铃事件监听。

能做什么

• 查看并调节Nest温控器温度（摄氏/华氏）
• 切换温控器运行模式（制热/制冷/节能/关闭）
• 生成摄像头RTSP实时流地址
• 接收门铃按铃、移动侦测等实时事件推送
• 批量列出账户下所有Nest设备

使用说明

前置准备

1. 访问 Google Cloud Console 创建项目
2. 支付5美元费用后在 Device Access Console 创建项目
3. 创建OAuth 2.0凭证（Web应用类型），添加重定向URI https://www.google.com
4. 将Nest账户关联至Device Access项目

获取Refresh Token

1. 浏览器访问授权URL（替换CLIENT_ID和PROJECT_ID）：
   https://nestservices.google.com/partnerconnections/PROJECT_ID/auth?redirect_uri=https://www.google.com&access_type=offline&prompt=consent&client_id=CLIENT_ID&response_type=code&scope=https://www.googleapis.com/auth/sdm.service
2. 完成授权后从跳转URL复制code参数
3. 执行curl命令换取token：
   curl -X POST https://oauth2.googleapis.com/token -d "client_id=CLIENT_ID" -d "client_secret=CLIENT_SECRET" -d "code=AUTH_CODE" -d "grant_type=authorization_code" -d "redirect_uri=https://www.google.com"

安装与配置

推荐1Password存储：创建条目包含字段 project_id、client_id、client_secret、refresh_token

或环境变量方式：

export NEST_PROJECT_ID="your-project-id"
export NEST_CLIENT_ID="your-client-id"
export NEST_CLIENT_SECRET="your-client-secret"
export NEST_REFRESH_TOKEN="your-refresh-token"

基础命令

# 列出设备
python3 scripts/nest.py list

# 查看温控器状态
python3 scripts/nest.py get <device_id>

# 设置温度（摄氏）
python3 scripts/nest.py set-temp <device_id> 21 --unit c --type heat

# 切换模式
python3 scripts/nest.py set-mode <device_id> HEAT

# 获取摄像头流地址
python3 scripts/nest.py stream <device_id>

实时事件配置（可选）

需配置Google Cloud Pub/Sub + Cloudflare Tunnel webhook，详见原始文档。

输入与输出

见下方输入与输出表格。

风险提示

• Device Access项目需一次性支付5美元激活费用
• OAuth refresh token长期有效，泄露可能导致设备被他人控制
• 摄像头RTSP流地址有效期约5分钟，需及时使用
• 实时事件依赖Pub/Sub和外部隧道服务，配置复杂且可能产生云费用
• 温控指令直接作用于物理设备，误操作可能影响居住环境

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/amogower/nest-devices/SKILL.md
来源类型：GitHub仓库