iammeter-openclaw_skill

Overview

This skill provides a client and CLI to query and export device and site data from the IAMMETER cloud API. It supports listing sites and devices, retrieving real-time and historical energy data, exporting CSV, and running power or offline analyses. Token loading is automatic from an environment variable or a local skills configuration for convenience. The implementation targets practical data extraction and archival workflows.

How this skill works

The skill wraps IAMMETER API endpoints and exposes commands to list sites, fetch meter data, query energy history, and trigger power/offline analysis. It loads the API token from IAMMETER_TOKEN or a local skills config, then issues HTTP requests to the documented endpoints and formats responses for CLI output or CSV export. Rate limits are respected where required and CSV export writes compatible files for downstream processing.

When to use it

• Archive or back up historical energy readings from IAMMETER to local storage
• Quickly check real-time meter values across all devices or a single device
• Export site energy history to CSV for analysis or reporting
• Run power analysis or offline analysis provided by the API
• Integrate IAMMETER data into other automation or monitoring systems

Best practices

• Keep your IAMMETER token secret and do not commit it to public repositories
• Use the token injection option in the skills UI or set IAMMETER_TOKEN for local testing
• Respect API rate limits; limit bulk exports and paginate requests when possible
• Validate CSV output before importing into analytics tools to ensure timezone and field alignment
• Schedule periodic exports for archiving rather than continuous polling when realtime is not required

Example use cases

• Run 'sitelist' to discover all monitored sites and their IDs for archival tasks
• Fetch latest data for all meters to populate a central dashboard or database
• Export a site's energy history between two dates into CSV for billing or audit purposes
• Invoke poweranalysis to generate aggregated power insights for a given site
• Use meter-specific queries to troubleshoot a single meter's recent uploads