核心功能
IAMMETER Skill 是一款面向能源监控场景的专业 API 客户端工具,基于 IAMMETER 官方 Swagger 规范构建,提供完整的设备数据查询与分析能力。
主要能力
- 站点管理:列出用户所有监测站点(sitelist)
- 实时数据:获取全部电表最新读数(metersdata)或单设备数据(meterdata/meterdata2)
- 历史查询:按时间范围查询站点能耗历史,支持 CSV 导出
- 智能分析:运行功率分析(poweranalysis)与离线分析(offlineanalysis)
显著优点
1. 官方 API 原生支持:基于 https://www.iammeter.com/swaggerui/swagger.json 规范,接口权威可靠
2. 多协议兼容:IAMMETER 设备本身支持 Modbus/TCP、MQTT、HTTP/HTTPS、TCP 等多种开放协议,易于集成
3. 灵活配置:支持 OpenClaw 环境变量注入与本地 CLI 两种运行模式
4. 生态开放:与 OpenHAB 等开源平台深度兼容
潜在局限
- 部分接口存在严格速率限制,高频调用需额外注意
- 依赖 IAMMETER 云服务可用性,本地网络中断时实时功能受限
- 需要有效的 IAMMETER Token,设备采购成本需纳入考量
适合人群
- 家庭能源管理用户(需配套 IAMMETER 硬件)
- 小型工商业能耗监控集成商
- OpenHAB/Home Assistant 等智能家居平台开发者
- 能源数据分析与可视化项目开发者
常规风险
- Token 泄露风险:API Token 需妥善保管,避免提交至公开代码仓库
- 数据隐私:能耗数据上传至第三方云服务,敏感场景需评估合规性
- 速率限制:高频调用可能触发限流,生产环境建议实施缓存策略