← 返回 Skills 市场

IAMMETER

Name: IAMMETER
Author: iammeter

作者 IAMMETER · GitHub ↗ · v0.2.0

cross-platform ⚠ suspicious

513

总下载

当前安装

版本数

在 OpenClaw 中安装

/install iammeter-openclaw

功能描述

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

使用说明 (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

安全使用建议

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.

功能分析

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.

能力评估

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

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install iammeter-openclaw
安装完成后，直接呼叫该 Skill 的名称或使用 /iammeter-openclaw 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

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.

元数据

Slug iammeter-openclaw

版本 0.2.0

许可证 —

累计安装 1

当前安装数 1

历史版本数 1

常见问题

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

如何安装 IAMMETER？

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

IAMMETER 是免费的吗？

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

IAMMETER 支持哪些平台？

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

谁开发了 IAMMETER？

由 IAMMETER（@iammeter）开发并维护，当前版本 v0.2.0。