Instrument OpenClaw

The simplest OpenClaw integration pattern is:

emit canonical events from your OpenClaw runtime
confirm the event definitions appear in Chirpier
use analytics or charts on those stable event definitions
create policies for reliability, latency, and cost
route alerts to Slack, Discord, Telegram, email, or webhook destinations

Start with a single agent, such as openclaw.main, and keep workflow-specific detail in meta.

The stable event definition identity is the combination of agent and event.

If you are using chirpier-skills, export CHIRPIER_API_KEY first and start with the chirpier skill so OpenClaw follows the canonical naming, analytics, and policy patterns.

Recommended starter events

Use canonical event names so your charts and policies stay consistent across tasks, agents, and deployments.

tool.calls.count
tool.errors.count
task.duration_ms
tokens.used
heartbeat.missed.count

Raw API


curl -X POST \
  -H "Authorization: Bearer $CHIRPIER_API_KEY" \
  -H "Content-Type: application/json" \
  https://logs.chirpier.co/v1.0/logs \
  -d '[
    {
      "agent": "openclaw.main",
      "event": "tool.errors.count",
      "value": 1,
      "meta": {"tool_name": "browser.open"}
    },
    {
      "agent": "openclaw.main",
      "event": "task.duration_ms",
      "value": 780,
      "meta": {"task_name": "daily_digest"}
    }
  ]'

JavaScript


import { createClient } from "@chirpier/chirpier-js";
 
const client = createClient({ key: process.env.CHIRPIER_API_KEY! });
 
await client.log({
  agent: "openclaw.main",
  event: "task.duration_ms",
  value: 420,
  meta: { task_name: "email_triage", workflow: "ops" },
});
 
await client.flush();
await client.shutdown();

Python


from chirpier import Log, new_client
 
client = new_client(api_key="chp_your_api_key")
client.log(
    Log(
        agent="openclaw.main",
        event="task.duration_ms",
        value=420,
        meta={"task_name": "email_triage"},
    )
)
client.flush()
client.close()

Go


ctx := context.Background()
client, _ := chirpier.NewClient(chirpier.Options{Key: "chp_your_api_key"})
defer client.Close(ctx)
 
_ = client.Log(ctx, chirpier.Log{
    Agent: "openclaw.main",
    Event: "tokens.used",
    Value: 1530,
})
 
_ = client.Flush(ctx)

First charts to build

After the events are flowing, create charts for:

tool error volume over time
task latency by task name
token usage by hour
missed heartbeats by day

The key design rule is that event definitions are keyed by agent + event. Once you choose a stable producer and event name, reuse that pair everywhere.