← Back to Skills Marketplace

IAMMETER

Name: IAMMETER
Author: iammeter

by IAMMETER · GitHub ↗ · v0.2.0

cross-platform ⚠ suspicious

513

Downloads

Stars

Active Installs

Versions

Install in OpenClaw

/install iammeter-openclaw

Description

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-tim...

README (SKILL.md)

iammeter Skill (Node.js)

A Node.js client and CLI for the iammeter API, based on the official swagger spec.

Features

Token is loaded automatically: first from the IAMMETER_TOKEN environment 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 token in the Skills UI. It is stored in ~/.openclaw/openclaw.json under skills.entries.iammeter.apiKey and injected as the IAMMETER_TOKEN environment variable at runtime.
Option B (local testing): export IAMMETER_TOKEN=\x3Cyour_token> 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 \x3Cdevice_sn> node scripts/cli.js history \x3CplaceId> 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 tokens to public repositories.

Credits

API endpoints and fields from https://www.iammeter.com/swaggerui/swagger.json

About IAMMETER

IAMMETER is an energy monitoring solution provider offering Wi-Fi-based single-phase and three-phase smart meters with multiple open interfaces, including Modbus/TCP, MQTT, HTTP/HTTPS API, TCP, and Local Push protocols. These open communication options make IAMMETER devices easy to integrate with OpenHAB and other open-source platforms.

Learn more about supported protocols and APIs: Device communication protocols: https://www.iammeter.com/newsshow/blog-fw-features

IAMMETER Cloud API: https://www.iammeter.com/docs/system-api advanced-user-ecosystem

Usage Guidance

This skill appears to do what it advertises: it needs your IAMMETER_TOKEN and will call the official iammeter API endpoints and optionally write CSV files you request. Before installing/using it: (1) Review and trust the unknown publisher — there's no homepage listed. (2) Never supply your token to untrusted parties; keep tokens out of public repos. The skill will read IAMMETER_TOKEN from the environment or from ~/.openclaw/openclaw.json (so check that file if you don't want the token stored there). (3) To use locally you must run npm install which will fetch axios and yargs from npm—run that in a controlled environment if you are cautious. (4) When exporting CSVs, choose safe output file paths (the CLI will overwrite files). If you want higher assurance, run the included scripts in a sandbox or review the two JS files line-by-line (they are short) before use.

Capability Analysis

Type: OpenClaw Skill Name: iammeter-openclaw Version: 0.2.0 The skill is designed to interact with the iammeter API, loading its token from environment variables or `~/.openclaw/openclaw.json` as described in `SKILL.md`. While the core functionality appears benign, the `scripts/cli.js` file contains an arbitrary file write vulnerability in the `writeCsv` function. The `out` parameter, derived directly from user input (`argv.out`), is used without sanitization in `fs.writeFileSync(out, csv);`, allowing a malicious actor or a compromised agent to write to arbitrary file paths on the system. This is a significant vulnerability, but it does not demonstrate clear malicious intent by the skill author to exfiltrate data or establish persistence.

Capability Assessment

✓ Purpose & Capability

Name/description request an iammeter API token and the code implements the expected endpoints (sitelist/meters/meter/history/poweranalysis/offlineanalysis). Required env var IAMMETER_TOKEN and reading ~/.openclaw/openclaw.json for a stored apiKey align with the stated purpose. The lack of a homepage/source is a metadata shortcoming but not an implementation mismatch.

✓ Instruction Scope

SKILL.md and the Node scripts limit actions to calling the iammeter API and optional local CSV export. The code only reads the IAMMETER_TOKEN (env or ~/.openclaw/openclaw.json), performs HTTP GETs to https://www.iammeter.com, and writes an output CSV when requested — all consistent with the documented feature set.

ℹ Install Mechanism

No install spec in the registry (instruction-only), but the package includes Node code and package.json (axios, yargs). This is expected for a Node CLI; npm install is required for local use. Because there is no automated installer, nothing arbitrary will be fetched at install time by the platform itself, but running 'npm install' will pull public packages (axios, yargs) from npm.

✓ Credentials

Only IAMMETER_TOKEN is required (declared as primary credential). The client also reads ~/.openclaw/openclaw.json to find a stored apiKey, which the SKILL.md documents. No unrelated secrets or config paths are requested.

✓ Persistence & Privilege

always:false (no forced inclusion). The skill does not modify other skills or system-wide configs and requires explicit invocation to run. Autonomous invocation is allowed by default but not combined with broad or unrelated privileges here.

How to Use

Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install iammeter-openclaw
After installation, invoke the skill by name or use /iammeter-openclaw
Provide required inputs per the skill's parameter spec and get structured output

Version History

v0.2.0

iammeter-openclaw v0.2.0 - Added detailed documentation and usage instructions in SKILL.md, including setup, configuration options, and CLI usage examples. - Clarified how API tokens are loaded, supporting both environment variable and local configuration file methods. - Listed available API triggers and analysis features, including site/device querying and energy data export. - Provided reference links and notes on integration, protocols, and IAMMETER platform capabilities.

Metadata

Slug iammeter-openclaw

Version 0.2.0

License —

All-time Installs 1

Active Installs 1

Total Versions 1

Frequently Asked Questions

What is 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-tim... It is an AI Agent Skill for Claude Code / OpenClaw, with 513 downloads so far.

How do I install IAMMETER?

Run "/install iammeter-openclaw" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is IAMMETER free?

Yes, IAMMETER is completely free (open-source). You can download, install and use it at no cost.

Which platforms does IAMMETER support?

IAMMETER is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created IAMMETER?

It is built and maintained by IAMMETER (@iammeter); the current version is v0.2.0.

More Skills