什么是 Beestat？

Beestat 技能为您提供了获取 ecobee 温控器遥测数据的技术网关，包括实时温度、湿度和空气质量指标。通过在 Openclaw Skills 生态系统中使用该工具，开发者可以以编程方式访问远超标准 ecobee 界面的气候数据和 HVAC 性能历史记录。它专为需要在家庭自动化环境中进行精确控制和数据可视化的用户而设计。

该技能综合了来自 Beestat API 的数据，提供了对室内空气健康（CO2 和 VOC 水平）以及传感器占用情况的深入洞察。无论您是构建个人仪表板还是自动化家庭气候响应，此 Openclaw Skills 扩展都能提供高级智能家居管理所需的结构化数据。

下载入口:https://github.com/openclaw/skills/tree/main/skills/mjrussell/beestat

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Beestat 应用场景

• 通过终端查看实时室内温度和湿度水平。
• 监控 CO2 和 VOC 水平，确保健康的室内环境。
• 回顾 HVAC 运行时间历史，分析能源效率和使用模式。
• 通过远程 ecobee 传感器检查房间占用情况，用于安全或自动化触发。
• 将温控器状态集成到自定义的 Openclaw Skills 自动化脚本中。

1. 该技能通过 beestat-cli 工具与 Beestat API 进行交互。
2. 发出命令以查询特定端点，如状态、传感器或空气质量。
3. 该工具通过 Beestat 云服务检索从您的 ecobee 账户同步的数据。
4. 遥测数据经过处理后，以格式化的终端视图或结构化 JSON 形式返回，以便进一步处理。
5. 用户可以强制与 ecobee 进行数据同步，以确保 Openclaw Skills 能够获取最新信息。

Beestat 配置指南

要开始使用此技能，请安装 CLI 并配置您的凭据：

npm install -g beestat-cli

1. 在 beestat.io 注册账户并绑定您的 ecobee 设备。
2. 通过向 contact@beestat.io 发送包含温控器序列号的邮件来获取 API 密钥。
3. 将您的 API 密钥导出为环境变量：

export BEESTAT_API_KEY="your-key"

Beestat 数据架构与分类体系

Beestat 技能将数据组织成几个逻辑结构，可以通过 --json 标志导出，以便在其他 Openclaw Skills 工作流中使用：

name: beestat
description: Query ecobee thermostat data via Beestat API including temperature, humidity, air quality (CO2, VOC), sensors, and HVAC runtime. Use when user asks about home temperature, thermostat status, air quality, or heating/cooling usage.
homepage: https://beestat.io
metadata:
  clawdbot:
    emoji: "???"
    requires:
      bins: ["beestat"]
      env: ["BEESTAT_API_KEY"]

Beestat CLI

CLI for the Beestat API (ecobee thermostat analytics). Query temperature, humidity, air quality, and HVAC runtime.

Installation

npm install -g beestat-cli

Setup

1. Create account at beestat.io and link your ecobee
2. Email contact@beestat.io with your thermostat serial number to get an API key
3. Set environment variable: export BEESTAT_API_KEY="your-key"

Commands

Status

beestat status             # Current temps, humidity, setpoints, weather
beestat status --json

Sensors

beestat sensors            # All sensors with temperature and occupancy
beestat sensors --json

Air Quality

beestat air-quality        # CO2, VOC, and air quality score
beestat aq                 # Short alias
beestat aq --json

Requires ecobee Smart Thermostat Premium (has built-in air quality sensors).

CO2 Levels:

• < 800 ppm: Excellent
• 800-1000 ppm: Good
• 1000-1500 ppm: Fair (consider ventilation)

• 1500 ppm: High (ventilate!)

VOC Levels:

• < 0.5 ppm: Excellent
• 0.5-1.0 ppm: Good
• 1.0-3.0 ppm: Fair

• 3.0 ppm: High

Thermostats

beestat thermostats        # Model info, HVAC details
beestat thermostats --json

Runtime Summary

beestat summary            # Runtime history (default 7 days)
beestat summary --days 14  # Last 14 days
beestat summary --json

Force Sync

beestat sync               # Force sync with ecobee

Usage Examples

User: "What's the temperature in the house?"

beestat status

User: "Is the air quality okay?"

beestat aq

User: "Is anyone in the bedrooms?"

beestat sensors

User: "How much did we heat the house this week?"

beestat summary --days 7

User: "What thermostats do we have?"

beestat thermostats

Notes

• Air quality data comes from ecobee runtime, not sensor capabilities
• All commands support --json for scripting/automation
• Use beestat sync if data seems stale