How epsilla-cloud/clawtrace works
ClawTrace captures cost-aware agent execution traces, stores and queries them as a trajectory graph, and presents them for inspection or AI analysis. Its related CostCraft package uses TraceCards to distill agent skills through preserve, prune, and repair patches. The main capture-to-inspection links are documented in the README; implementation excerpts are limited, so uncertain internal service wiring is omitted.
Main entry points: TracesPage.tsx ClawTrace UI · main.py Backend API · app Payment service · tracker.ts ClawTrace plugin
Components 23
Capture and ingest
- ClawTrace plugin
plugins/clawtrace/src/tracker.ts - Event sink
plugins/clawtrace/src/event-sink.ts - Ingest service
services/clawtrace-ingest/app/main.py - Raw event storage
services/clawtrace-ingest/app/storage.py
Graph and analysis
- Backend API
services/clawtrace-backend/app/main.py - Tracy MCP
services/clawtrace-backend/app/routers/tracy_mcp.py - Tracy analyst
services/clawtrace-backend/app/routers/tracy.py
User application
- ClawTrace UI
packages/clawtrace-ui/src/components/traces/TracesPage.tsx - Trace views
packages/clawtrace-ui/src/components/traces/TrajectoryPage.tsx - Tracy chat panel
packages/clawtrace-ui/src/components/tracy/TracyPanel.tsx
Accounts and billing
- Billing routes
packages/clawtrace-ui/src/app/api/billing - Payment service
services/clawtrace-payment/app
Skill distillation
- TraceCard compiler
costcraft/costcraft/tracecard.py - CostCraft refinement
costcraft/costcraft/refine.py - Skill patches
costcraft/costcraft/analysts
Other components
- OpenClaw agent
- Cloud object storage
- Databricks Lakeflow
- Silver tables
- PuppyGraph
- Neon PostgreSQL
- Agent owner
- Stripe
Connections 22
- OpenClaw agent → ClawTrace plugin: runs hooks
- ClawTrace plugin → Event sink: emits events
- Event sink → Ingest service: POSTs events
- Ingest service → Raw event storage: persists events
- Raw event storage → Cloud object storage: writes objects
- Cloud object storage → Databricks Lakeflow: feeds raw data
- Databricks Lakeflow → Silver tables: materializes tables
- Silver tables → PuppyGraph: virtualized as graph
- Backend API → PuppyGraph: runs Cypher
- Tracy MCP → PuppyGraph: queries graph
- Backend API → Neon PostgreSQL: stores account data
- Agent owner → ClawTrace UI: inspects traces
- ClawTrace UI → Backend API: requests trace data
- ClawTrace UI → Trace views: renders trajectories
- ClawTrace UI → Tracy chat panel: opens analysis
- Tracy chat panel → Backend API: sends questions
- Tracy analyst → Tracy MCP: uses graph tools
- Billing routes → Payment service: requests billing
- Payment service → Neon PostgreSQL: updates credits
- Payment service → Stripe: handles payments
- TraceCard compiler → CostCraft refinement: supplies trace summaries
- CostCraft refinement → Skill patches: produces preserve prune repair