Nest 设备访问

通过 Google 的智能设备管理 API 控制 Nest 设备。

设置

1. Google Cloud 与设备访问

1. 在以下网址创建一个 Google Cloud 项目：console.cloud.google.com
2. 支付 5 美元费用，并在以下网址创建一个设备访问项目：console.nest.google.com/device-access
3. 创建 OAuth 2.0 凭据（Web 应用程序类型）
4. 添加https://www.google.com作为授权的重定向 URI
5. 将您的 Nest 账户链接到设备访问项目

2. 获取刷新令牌

运行 OAuth 流程以获取刷新令牌：

# 1. Open this URL in browser (replace CLIENT_ID and 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. Authorize and copy the 'code' parameter from the redirect URL

# 3. Exchange code for tokens:
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"

3. 存储凭据

存储在 1Password 或环境变量中：

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

恒温器

# Get status
python3 scripts/nest.py get <device_id>

# Set temperature (Celsius)
python3 scripts/nest.py set-temp <device_id> 21 --unit c --type heat

# Set temperature (Fahrenheit)
python3 scripts/nest.py set-temp <device_id> 70 --unit f --type heat

# Change mode (HEAT, COOL, HEATCOOL, OFF)
python3 scripts/nest.py set-mode <device_id> HEAT

# Eco mode
python3 scripts/nest.py set-eco <device_id> MANUAL_ECO

摄像头

# Generate live stream URL (RTSP, valid ~5 min)
python3 scripts/nest.py stream <device_id>

Python API

from nest import NestClient

client = NestClient()

# List devices
devices = client.list_devices()

# Thermostat control
client.set_heat_temperature(device_id, 21.0)  # Celsius
client.set_thermostat_mode(device_id, 'HEAT')
client.set_eco_mode(device_id, 'MANUAL_ECO')

# Camera stream
result = client.generate_stream(device_id)
rtsp_url = result['results']['streamUrls']['rtspUrl']

配置

脚本按以下顺序检查凭据：

1. 1Password：设置NEST_OP_VAULT和NEST_OP_ITEM（或使用默认值：保险库"Alfred"，项目"Nest Device Access API"）
2. 环境变量：NEST_PROJECT_ID、NEST_CLIENT_ID、NEST_CLIENT_SECRET,NEST刷新令牌

温度参考

实时事件（门铃、运动等）

要在有人按门铃或检测到运动时获得即时警报，您需要使用Webhook设置Google Cloud Pub/Sub。

先决条件

• 已安装并完成身份验证的Google Cloud CLI (gcloud)
• 用于隧道的Cloudflare账户（免费套餐即可）
• Clawdbot 钩子已在配置中启用

1. 启用 Clawdbot 钩子

添加到您的clawdbot.json文件：

{
  "hooks": {
    "enabled": true,
    "token": "your-secret-token-here"
  }
}

生成令牌：openssl rand -hex 24

2. 创建 Pub/Sub 主题

gcloud config set project YOUR_GCP_PROJECT_ID

# Create topic
gcloud pubsub topics create nest-events

# Grant SDM permission to publish (both the service account and publisher group)
gcloud pubsub topics add-iam-policy-binding nest-events \
  --member="serviceAccount:sdm-prod@sdm-prod.iam.gserviceaccount.com" \
  --role="roles/pubsub.publisher"

gcloud pubsub topics add-iam-policy-binding nest-events \
  --member="group:sdm-publisher@googlegroups.com" \
  --role="roles/pubsub.publisher"

3. 将主题链接到设备访问

前往console.nest.google.com/device-access→ 您的项目 → 编辑 → 将 Pub/Sub 主题设置为：

projects/YOUR_GCP_PROJECT_ID/topics/nest-events

4. 设置 Cloudflare 隧道

# Install cloudflared
curl -L -o ~/.local/bin/cloudflared https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64
chmod +x ~/.local/bin/cloudflared

# Authenticate (opens browser)
~/.local/bin/cloudflared tunnel login

# Create named tunnel
~/.local/bin/cloudflared tunnel create nest-webhook

# Note the Tunnel ID (UUID) from output

创建文件~/.cloudflared/config.yml，内容如下：

tunnel: nest-webhook
credentials-file: /home/YOUR_USER/.cloudflared/TUNNEL_ID.json

ingress:
  - hostname: nest.yourdomain.com
    service: http://localhost:8420
  - service: http_status:404

创建 DNS 路由：

~/.local/bin/cloudflared tunnel route dns nest-webhook nest.yourdomain.com

5. 创建 Systemd 服务

Webhook 服务器服务（文件/etc/systemd/system/nest-webhook.service）：

[Unit]
Description=Nest Pub/Sub Webhook Server
After=network.target

[Service]
Type=simple
User=YOUR_USER
Environment=CLAWDBOT_GATEWAY_URL=http://localhost:18789
Environment=CLAWDBOT_HOOKS_TOKEN=your-hooks-token-here
ExecStart=/usr/bin/python3 /path/to/skills/nest-devices/scripts/nest-webhook.py
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Cloudflare 隧道服务（/etc/systemd/system/cloudflared-nest.service):

[Unit]
Description=Cloudflare Tunnel for Nest Webhook
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=YOUR_USER
ExecStart=/home/YOUR_USER/.local/bin/cloudflared tunnel run nest-webhook
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

启用并启动:

sudo systemctl daemon-reload
sudo systemctl enable --now nest-webhook cloudflared-nest

6. 创建 Pub/Sub 推送订阅

gcloud pubsub subscriptions create nest-events-sub \
  --topic=nest-events \
  --push-endpoint="https://nest.yourdomain.com/nest/events" \
  --ack-deadline=30

7. 测试

# Test webhook endpoint
curl https://nest.yourdomain.com/health

# Simulate doorbell event
curl -X POST http://localhost:8420/nest/events \
  -H "Content-Type: application/json" \
  -d '{"message":{"data":"eyJyZXNvdXJjZVVwZGF0ZSI6eyJuYW1lIjoiZW50ZXJwcmlzZXMvdGVzdC9kZXZpY2VzL0RPT1JCRUxMLTAxIiwiZXZlbnRzIjp7InNkbS5kZXZpY2VzLmV2ZW50cy5Eb29yYmVsbENoaW1lLkNoaW1lIjp7ImV2ZW50SWQiOiJ0ZXN0In19fX0="}}'

支持的事件

陈旧性过滤器:超过5分钟的事件会被记录但不会触发警报。这可以防止因队列中的Pub/Sub消息延迟送达而导致的警报泛滥。

图像捕捉

当门铃或人员事件触发警报时：

1. 首选方案：SDMGenerateImageAPI——快速、事件特定的快照
2. 备用方案：通过ffmpeg捕获RTSP实时流帧（需要ffmpeg

已安装）

重要设置注意事项

• 验证完整的Pub/Sub主题路径在设备访问控制台中的内容必须与你的GCP项目完全匹配：projects/你的_GCP_项目_ID/topics/nest-events
• 使用推送订阅，而非拉取——webhook期望通过HTTP POST方式投递
• 进行端到端测试安装后：按响门铃并确认照片已送达。不要仅依赖模拟的POST请求。

限制

• 摄像头事件图像约5分钟后过期（RTSP备用方案会捕获当前帧）
• 实时事件需要设置Pub/Sub（参见上文）
• 快速隧道（无需Cloudflare账户）不保证正常运行时间
• 部分较旧的Nest设备可能不支持全部功能
• 为避免通知疲劳，特意不提醒运动和声音事件