Beestat

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.

Audits

Pass

ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install beestat

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

Create account at beestat.io and link your ecobee
Email contact@beestat.io with your thermostat serial number to get an API key
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