OpenClaw¶
This is not a fork. It's a claw with opinions.
OpenClaw is an opinionated distribution of openclaw — the WhatsApp/Telegram/Discord/iMessage gateway for AI agents.
This fork adds observability layers that make your AI usage accountable, measurable, and improvable:
Modules¶
Green
Environmental impact tracking for AI inference. Carbon emissions, water usage, confidence scoring, and compliance exports (GHG Protocol, CDP, TCFD, ISO 14064).
Status: Shipped
Learning
Thompson Sampling bandit that learns which tools and system prompt sections help vs. hurt. Baseline A/B tracking, posterior visualization, and token savings analysis.
Status: Shipped
Cadence
Ambient intelligence via typed signals, sources, and responders. The gateway reacts to events (vault edits, cron ticks, state transitions) without being asked.
Status: Shipped (core bus + P1 responders)
Why a fork?¶
Upstream OpenClaw is a great gateway. But we wanted to answer questions it doesn't:
- How much carbon does my AI usage produce? (Green)
- Which tools actually help the agent? (Learning)
- Can the system prompt get smaller without getting worse? (Learning)
- Can the gateway react to events without being asked? (Cadence — ambient intelligence via signals and responders)
- Can we isolate agent execution beyond Docker? (OpenClaw Sandbox — process-level isolation for defense-in-depth around the built-in Docker sandbox)
Green and Learning run as always-on, zero-config layers inside the gateway. No opt-in, no setup. Data from the first request. Cadence and Sandbox are companion packages that plug in alongside.
Quick links¶
| What | Where |
|---|---|
| Green quick start | 5-minute walkthrough |
| Green CLI reference | All openclaw green commands |
| Green API reference | REST endpoints |
| Green dashboard | Chart.js visualizations |
| Standards compliance | GHG Protocol, CDP, TCFD, ISO 14064 |
| Learning quick start | 8-step walkthrough |
| Learning CLI reference | All openclaw learning commands |
| Learning API reference | REST endpoints |
| Learning dashboard | Thompson Sampling visualizations |
| Thompson Sampling theory | How the bandit works |
| Cadence overview | Signals, sources, responders |
| Cadence quick start | Wire your first responder |
| Cadence signal reference | All signal types |
| Source | github.com/Peleke/openclaw |
Built by Peleke + Claude. Lobster not included.