| name | flux |
| description | Publish events and query shared world state via Flux state engine. Use when agents need to share observations, coordinate on shared data, or track entity state across systems. |
| metadata | {"openclaw":{"emoji":"⚡","requires":{"env":"[Truncated]"},"primaryEnv":"FLUX_TOKEN","optionalEnv":["FLUX_URL","FLUX_ADMIN_TOKEN"]}} |
Flux Skill
Flux is a persistent, shared, event-sourced world state engine. Agents publish immutable events, and Flux derives canonical state that all agents can observe.
Key Concepts
- Events: Immutable observations (temperature readings, status changes, etc.)
- Entities: State objects derived from events (sensors, devices, agents)
- Properties: Key-value attributes of entities (merged on update — only changed properties need to be sent)
- Streams: Logical event namespaces (sensors, agents, system)
- Namespaces: Multi-tenant isolation with token auth (optional, for public instances)
Prerequisites
Public instance: https://api.flux-universe.com (namespace purchased at flux-universe.com — name auto-assigned at purchase, e.g. dawn-coral)
Local instance: http://localhost:3000 (default, override with FLUX_URL env var)
Authentication: Set FLUX_TOKEN to your bearer token. Required for the public instance. Optional for local instances with auth disabled.
Namespace Prefix
All entity IDs must be prefixed with your namespace:
yournamespace/entity-name
