iammeter
// Query and export device/site data via the iammeter API (based on https://www.iammeter.com/swaggerui/swagger.json). Triggers: list sites/devices, get real-time or historical energy data, export CSV, run power or offline analysis.
$ git log --oneline --stat
stars:1,933
forks:367
updated:March 4, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
nameiammeter
descriptionQuery and export device/site data via the iammeter API (based on https://www.iammeter.com/swaggerui/swagger.json). Triggers: list sites/devices, get real-time or historical energy data, export CSV, run power or offline analysis.
metadata[object Object]
iammeter Skill (Node.js)
A Node.js client and CLI for the iammeter API, based on the official swagger spec.
Features
- API key is loaded automatically: first from the
IAMMETER_TOKENenvironment variable, then from~/.openclaw/openclaw.json(skills.entries.iammeter.apiKey) - List user sites (sitelist)
- Get latest data for all meters (metersdata)
- Get latest upload data for a single meter (meterdata / meterdata2)
- Query site energy history (energyhistory) and export CSV
- Power analysis (poweranalysis), offline analysis (offlineanalysis)
Configuration
- Option A (OpenClaw / Clawhub): set the API key in the Skills UI. It is stored in
~/.openclaw/openclaw.jsonunderskills.entries.iammeter.apiKeyand injected as theIAMMETER_TOKENenvironment variable at runtime. - Option B (local testing): export IAMMETER_TOKEN=<your_api_key> before running.
Files
- references/api.md — endpoint reference summarized from swagger
- scripts/iammeter_client.js — Node.js client wrapping common endpoints
- scripts/cli.js — CLI: sitelist|meters|meter|history|poweranalysis|offlineanalysis
- package.json — dependencies (axios, yargs)
Usage (local testing)
-
Install dependencies: cd ~/.openclaw/workspace/skills/iammeter npm install
-
Run: node scripts/cli.js sitelist node scripts/cli.js meters node scripts/cli.js meter <device_sn> node scripts/cli.js history <placeId> 2026-02-01 2026-02-25 --out out.csv
Notes
- Some endpoints have strict rate limits (see references/api.md for details).
- Do not commit real credentials to public repositories.
Credits
- API endpoints and fields from https://www.iammeter.com/swaggerui/swagger.json