Supervision Layer
/install supervision-layer
Supervision Layer
Stop trusting agents to police themselves. Supervision Layer wraps every tool call in timeouts, circuit breakers, and audit logs — enforcement the agent cannot bypass.
Before vs After
| Without Supervision | With Supervision | |
|---|---|---|
| Runaway calls | Agent loops infinitely on a failing API | Circuit breaker trips after 3 failures |
| Stuck sessions | Tool hangs silently, agent waits forever | Timeout kills it after 30s |
| Audit trail | No record of what happened | Every call logged with timestamp, outcome, cost |
| Crash loops | Subagent restarts infinitely | After 3 crashes, marked permanently failed |
Quick Start
from supervision import get_supervisor
supervisor = get_supervisor()
result = await supervisor.execute(
tool="web_fetch",
fn=fetch_fn,
agent_id="worker-1",
session_id="sess-abc",
)
Components
- TimeoutWrapper — Per-tool configurable timeouts (default 30s)
- CircuitBreaker — 3-state machine (CLOSED → OPEN → HALF_OPEN)
- AuditLogger — Structured JSONL logging, 50MB rotation, queryable
- CrashLoopProtector — Track restarts, mark failed after 3 within window
- SupervisedCall — All-in-one: crash check → circuit check → audit → timeout → audit
Testing
cd scripts/ && python -m pytest test_supervision.py -v
58 tests. 0 external dependencies. Works with any async Python project.
License
MIT
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install supervision-layer - After installation, invoke the skill by name or use
/supervision-layer - Provide required inputs per the skill's parameter spec and get structured output
What is Supervision Layer?
Wrap every tool call with timeouts, circuit breakers, audit logging, and crash loop protection. Enforcement the agent cannot bypass. It is an AI Agent Skill for Claude Code / OpenClaw, with 53 downloads so far.
How do I install Supervision Layer?
Run "/install supervision-layer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Supervision Layer free?
Yes, Supervision Layer is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Supervision Layer support?
Supervision Layer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Supervision Layer?
It is built and maintained by larios613-hub (@larios613-hub); the current version is v1.0.0.