← Back to Skills Marketplace
jcbuer

Shelly Sync

by jcbuer · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ⚠ suspicious
40
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install shelly-sync
Description
Monitor real-time power consumption from Shelly Pro 3EM and control local appliances/automation based on solar yield or grid usage.
README (SKILL.md)

Shelly Sync Skill

Interface between Shelly Pro 3EM energy monitoring and home automation.

Usage Guidelines

  • Power output in Watts (W) or Kilowatts (kW)
  • Negative = grid injection (surplus). Positive = grid consumption
  • If data fetch fails → report connection error immediately, don't hallucinate

Commands

get_status

Returns current power consumption across all 3 phases.

/shelly get_status

optimize_load

Analyzes surplus and triggers load optimization if excess energy available.

/shelly optimize_load
/shelly optimize_load target_load:heatpump

Implementation

  • Script: shelly_client.py
  • Calls Shelly Pro 3EM RPC API (EMData.GetStatus)
  • Returns clean JSON with total power and phase breakdown
Usage Guidance
Review before installing. Only use this if you intend to let the skill control the specific Home Assistant entities involved, and configure the token with the narrowest possible permissions. Treat optimize_load as capable of switching appliances on immediately, especially high-load devices such as chargers, pumps, or washers.
Capability Assessment
Purpose & Capability
Shelly power monitoring and load optimization are coherent with the stated purpose, but the artifacts show high-impact physical device control when optimize_load is used.
Instruction Scope
The skill describes threshold-based appliance triggering, and the code can turn devices on when surplus power is detected without a separate confirmation, dry-run, time window, cooldown, or visible allowlist policy.
Install Mechanism
The artifact appears to be a markdown skill plus an executable Python client; no package installer, startup hook, persistence mechanism, or privilege escalation path is evident.
Credentials
SKILL.md declares SHELLY_EM_IP, while the implementation also uses Home Assistant URL and bearer-token style credentials, which is materially broader than the declared environment surface.
Persistence & Privilege
No background persistence or broad local filesystem access is shown; the main privilege concern is credential-backed Home Assistant actuation of local devices.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install shelly-sync
  3. After installation, invoke the skill by name or use /shelly-sync
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Updated version to 1.0.1 in SKILL.md. - No functional or interface changes; documentation only.
v1.0.0
Initial release of shelly-sync. - Monitor real-time power data from Shelly Pro 3EM. - Trigger smart plugs/appliances based on configurable power thresholds. - Provide current power stats and grid status via commands. - Support load optimization actions for specific appliances. - Report connection errors clearly if the device cannot be reached.
Metadata
Slug shelly-sync
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Shelly Sync?

Monitor real-time power consumption from Shelly Pro 3EM and control local appliances/automation based on solar yield or grid usage. It is an AI Agent Skill for Claude Code / OpenClaw, with 40 downloads so far.

How do I install Shelly Sync?

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

Is Shelly Sync free?

Yes, Shelly Sync is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Shelly Sync support?

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

Who created Shelly Sync?

It is built and maintained by jcbuer (@jcbuer); the current version is v1.0.1.

💬 Comments