| name | dancing-lights |
| description | Use this spell for lightweight indicators: status pips, progress markers, heartbeat widgets, and ambient observability that help humans orient quickly. It is not a full dashboard strategy; it is the small visual cue that says where to look next. |
| user-invocable | true |
| metadata | {"openclaw":{"requires":{"env":["HA_URL","HA_TOKEN"],"bins":["curl"]},"primaryEnv":"HA_TOKEN","emoji":"💡"}} |
Dancing Lights
Hang small moving signals in the dark so people can tell what the system is doing.
Overview
Dancing Lights is interpreted here as a hybrid spell with a shipping-now execution model.
Canonical source: Dancing Lights (spell)
Provider target: OpenClaw
When To Use
- You need a lightweight status or progress display rather than a full observability buildout.
- A small ambient indicator would help people see health, motion, or blockage at a glance.
- The goal is orientation and reassurance, not deep analysis in a heavy dashboard.
- Your Home Assistant setup has Philips Hue or other smart lights that can serve as ambient status indicators.
Workflow
- Choose the minimum set of signals that actually matter at a glance.
- Map those signals to simple visuals, placement, and refresh behavior that stay legible under stress.
- Return the indicator spec with data sources, stale-state handling, and error states.
- If Home Assistant is available, use the HA REST API to set light states directly — POST to /api/services/light/turn_on with entity_id, brightness, and rgb_color.
Deliverables
- A compact status display concept or implementation brief.
- A signal-to-visual mapping for healthy, stale, and failing states.
- Notes on refresh cadence, placement, and what the indicator does not claim.
Guardrails
- Do not imply precision or freshness the underlying data cannot support.
- Make stale, unknown, or disconnected states visibly different from healthy ones.
Default Invocation
Use $dancing-lights to design a small status display for this workflow and make the signal states unambiguous.
