功能描述

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.

使用说明 (SKILL.md)

Beestat CLI

Name: Beestat
Author: mjrussell

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 [email protected] 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:

\x3C 800 ppm: Excellent
800-1000 ppm: Good
1000-1500 ppm: Fair (consider ventilation)
1500 ppm: High (ventilate!)

VOC Levels:

\x3C 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

安全使用建议

Before installing or enabling this skill: (1) resolve the metadata mismatch — confirm whether the skill actually requires the beestat CLI and BEESTAT_API_KEY, (2) verify the npm package publisher and inspect the package (or run in a sandbox) before performing a global `npm install -g`, (3) obtain an API key with the minimum scope possible and be ready to revoke it if anything looks suspicious, (4) confirm the contact email and homepage (beestat.io) are legitimate, and (5) if you allow the agent to invoke skills autonomously, be aware that this skill will have network access to the Beestat API when invoked. If you need higher assurance, ask the skill author for source code or a signed release link (GitHub release) rather than installing an opaque npm package.

功能分析

Type: OpenClaw Skill Name: beestat Version: 0.1.0 The skill bundle defines a legitimate purpose: querying ecobee thermostat data via the Beestat API using a CLI. The `SKILL.md` provides standard installation instructions (`npm install -g beestat-cli`) and usage examples that are consistent with the stated goal. There is no evidence of prompt injection against the agent, data exfiltration, malicious execution, persistence mechanisms, or obfuscation within the provided files. The required environment variable `BEESTAT_API_KEY` is a standard practice for API access.

能力评估

ℹ Purpose & Capability

The SKILL.md describes a CLI that queries Beestat/ecobee data and requires the beestat CLI plus BEESTAT_API_KEY — this is coherent with the stated purpose. HOWEVER the registry metadata shown to the scanner lists no required binaries or env vars while the SKILL.md metadata declares bins:["beestat"] and env:["BEESTAT_API_KEY"]. That mismatch is an inconsistency in the package metadata that should be resolved.

✓ Instruction Scope

The instructions are narrowly scoped: they tell the user to install an npm package, obtain an API key from beestat.io, set BEESTAT_API_KEY, and run CLI commands to fetch thermostat, sensor, and air-quality data. There are no instructions to read unrelated local files or exfiltrate data outside the Beestat API.

ℹ Install Mechanism

This is an instruction-only skill that advises running `npm install -g beestat-cli`. Installing a global npm package is a common delivery method but has moderate supply-chain risk (npm package integrity, publisher identity, post-install hooks). The registry contains no automated install spec — the install step is manual and therefore under the user's control, but you should verify the npm package and publisher before installing.

ℹ Credentials

Requesting a single BEESTAT_API_KEY is proportionate to a service that calls the Beestat API. The concern is the metadata inconsistency: the public registry/skill summary claims no required env vars while the SKILL.md requires BEESTAT_API_KEY. Ensure the agent/platform will not demand broader credentials and confirm the key's intended scope before providing it.

✓ Persistence & Privilege

The skill does not request 'always: true' and does not declare persistence or system-wide configuration changes. It is user-invocable and may be invoked autonomously per platform defaults, which is expected for skills and is not by itself a red flag.

版本历史

v0.1.0

Initial release - ecobee thermostat via Beestat API

元数据

Slug beestat

版本 0.1.0

许可证 —

累计安装 1

当前安装数 1

历史版本数 1

常见问题

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. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 1949 次。

如何安装 Beestat？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install beestat」即可一键安装，无需额外配置。

Beestat 是免费的吗？

是的，Beestat 完全免费（开源免费），可自由下载、安装和使用。

Beestat 支持哪些平台？

Beestat 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Beestat？

由 Matt Russell（@mjrussell）开发并维护，当前版本 v0.1.0。

Beestat