@contextcompany/openclaw

The Context Company observability plugin for OpenClaw.

Captures LLM calls, tool executions, and agent lifecycle events from OpenClaw's plugin hook system, then exports them to The Context Company for visualization and analysis.

Quick Start

1. Install

openclaw plugins install @contextcompany/openclaw

2. Configure

Add to your openclaw.json:

{
  "plugins": {
    "allow": ["@contextcompany/openclaw"],
    "entries": {
      "@contextcompany/openclaw": {
        "enabled": true,
        "config": {
          "apiKey": "${TCC_API_KEY}"
        }
      }
    }
  }
}

3. Restart

openclaw gateway restart

That's it. The plugin hooks into the agent runtime and starts sending traces to TCC.

Alternative: Manual Registration

If you prefer to register from a custom extension:

// extensions/tcc-observability/index.ts
import { register } from "@contextcompany/openclaw";

export default async function (api) {
  register(api);
}

With explicit config:

register(api, {
  apiKey: "tcc_...",
  endpoint: "https://api.thecontext.company/v1/openclaw",
  debug: true,
});

Configuration

| Option | Env Var | Default | Description | |--------|---------|---------|-------------| | apiKey | TCC_API_KEY | — | Your Context Company API key | | endpoint | TCC_URL | Auto-detected from key | Ingestion endpoint URL | | debug | TCC_DEBUG | false | Enable debug logging |

How It Works

The plugin hooks into OpenClaw's agent lifecycle events:

| Hook | What it captures | |------|-----------------| | llm_input | LLM call start — model, prompt, system prompt, history | | llm_output | LLM call end — response, token usage, cost | | before_tool_call | Tool execution start — tool name, arguments | | after_tool_call | Tool execution end — result, errors, duration | | agent_end | Run complete — success/failure, full message history |

All events are collected during the agent run and sent as a single batch when the run completes. Sessions that never receive an agent_end are flushed after 30 minutes.