| name | byd-battery |
| description | Read BYD Battery-Box HVS/HVM/LVS/LVL home-storage telemetry through local Modbus or paired-inverter delegation, with read-only safety boundaries. |
| user-invocable | true |
| requires | {"bins":["node"]} |
| credentials | [{"id":"byd-bmu-host","kind":"header","required":false,"secret_ref":{"source":"store","id":"BYD_BMU_HOST"},"scope":"LAN hostname or IP address of the BYD BMU Modbus endpoint","how_to_obtain":"Find the BMU LAN address from the router, inverter page, or Be Connect Plus notes. Set `BYD_BMU_HOST` through browser admin at the active `/admin/secrets` route; if browser admin is unavailable, use `/secret set BYD_BMU_HOST \"192.168.1.50\"` in browser `/chat` or TUI; local console fallback: `hybridclaw secret set BYD_BMU_HOST \"192.168.1.50\"`."},{"id":"byd-bmu-modbus-port","kind":"header","required":false,"secret_ref":{"source":"store","id":"BYD_BMU_MODBUS_PORT"},"scope":"BYD BMU Modbus TCP port, usually 8080 or 502 depending on firmware and wiring","how_to_obtain":"Confirm the port in the installer documentation or LAN scan. Set `BYD_BMU_MODBUS_PORT` through browser admin at the active `/admin/secrets` route; if browser admin is unavailable, use `/secret set BYD_BMU_MODBUS_PORT \"8080\"` in browser `/chat` or TUI; local console fallback: `hybridclaw secret set BYD_BMU_MODBUS_PORT \"8080\"`."},{"id":"byd-bmu-unit-id","kind":"header","required":false,"secret_ref":{"source":"store","id":"BYD_BMU_UNIT_ID"},"scope":"Pinned Modbus unit id for the BMU, usually 1","how_to_obtain":"Confirm the unit id from the installer handoff or Modbus adapter configuration. Set `BYD_BMU_UNIT_ID` through browser admin at the active `/admin/secrets` route; if browser admin is unavailable, use `/secret set BYD_BMU_UNIT_ID \"1\"` in browser `/chat` or TUI; local console fallback: `hybridclaw secret set BYD_BMU_UNIT_ID \"1\"`."},{"id":"byd-bmu-model","kind":"header","required":false,"secret_ref":{"source":"store","id":"BYD_BMU_MODEL"},"scope":"Operator-declared Battery-Box model family such as Premium HVS, HVM, LVS, LVL, HV, or LV","how_to_obtain":"Read the battery nameplate or installer handoff. Set `BYD_BMU_MODEL` through browser admin at the active `/admin/secrets` route; if browser admin is unavailable, use `/secret set BYD_BMU_MODEL \"Premium HVS\"` in browser `/chat` or TUI; local console fallback: `hybridclaw secret set BYD_BMU_MODEL \"Premium HVS\"`."}] |
| metadata | {"hybridclaw":{"category":"home-automation","short_description":"Read-only BYD Battery-Box telemetry and incident handoff.","tags":["byd","battery","solar","energy","modbus","storage"],"stakes_tiers":{"green":"[Truncated]","red":"[Truncated]"},"escalation":{"writes":"unavailable-v1","route":"f14"},"cost_measurement":{"system":"UsageTotals","sub_limit_key":"byd-battery"}}} |
BYD Battery
Use this skill for operator-approved monitoring of BYD Battery-Box Premium HVS,
HVM, LVS, LVL, and older HV/LV family home-storage units. Prefer the bundled
helper for all protocol details:
node skills/byd-battery/byd-battery.cjs --format json read state-of-charge
node skills/byd-battery/byd-battery.cjs --format json read pack-telemetry
node skills/byd-battery/byd-battery.cjs --format json read cell-extremes
node skills/byd-battery/byd-battery.cjs --format json read inventory
node skills/byd-battery/byd-battery.cjs --format json read module-telemetry
node skills/byd-battery/byd-battery.cjs --format json read alarms
node skills/byd-battery/byd-battery.cjs --format json read firmware
node skills/byd-battery/byd-battery.cjs --format json read be-connect-metadata
node skills/byd-battery/byd-battery.cjs --format json read energy-counters
node skills/byd-battery/byd-battery.cjs --format json read state-of-charge --via fronius
Safety Boundary
Read-only v1. Do not attempt mutating actions through this skill. Remote
shutdown, BMU reset, capacity reconfiguration, installer-app operations,
cell-balancing overrides, write coils, and write-register requests are out of
scope because they can affect a high-voltage DC battery. If a future v2 adds
any mutating action, it must be red-stakes, require mandatory F8/F14 approval,
and include installer handover instructions.
Never ask for, print, or store installer-app passwords such as common default
installer codes in helper output. Treat them as SecretRef-managed even if they
are well known.
Setup
Set local BMU connection values in this order:
- Browser admin: open the active HybridClaw admin URL ending in
/admin/secrets and set the
BYD_BMU_* values.
- Browser
/chat or TUI fallback:
/secret set BYD_BMU_HOST "192.168.1.50" plus the matching port, unit id,
and model values.
- Local console fallback:
hybridclaw secret set BYD_BMU_HOST "192.168.1.50"
hybridclaw secret set BYD_BMU_MODBUS_PORT "8080"
hybridclaw secret set BYD_BMU_UNIT_ID
hybridclaw secret BYD_BMU_MODEL
