OpenClaw Logfire Plugin

Pydantic Logfire observability plugin for OpenClaw. Traces the full agent lifecycle with OTEL GenAI semantic conventions — tool calls, token usage, errors, and optional distributed tracing across services.

Install

openclaw plugins install @ultrathink-solutions/openclaw-logfire

Set your Logfire write token:

export LOGFIRE_TOKEN="your-token"

Add to openclaw.json:

{
  "plugins": {
    "entries": {
      "openclaw-logfire": {
        "enabled": true,
        "config": {}
      }
    }
  }
}

Restart OpenClaw. Traces appear in your Logfire dashboard.

What It Traces

Every agent invocation produces a span tree:

invoke_agent chief-of-staff          (root span)
  |-- execute_tool Read              (file read)
  |-- execute_tool exec              (shell command)
  |-- execute_tool Write             (file write)

Spans follow OTEL GenAI semantic conventions: gen_ai.agent.name, gen_ai.tool.name, gen_ai.usage.input_tokens, gen_ai.usage.output_tokens, etc.

Metrics

gen_ai.client.token.usage — token count histogram (input/output)
gen_ai.client.operation.duration — agent invocation latency

Key Configuration

Setting	Default	Description
`environment`	`development`	Deployment environment label
`serviceName`	`openclaw-agent`	OTEL service name
`providerName`	—	GenAI provider (e.g. `anthropic`)
`captureToolInput`	`true`	Record tool arguments
`redactSecrets`	`true`	Strip API keys and JWTs
`distributedTracing.enabled`	`false`	W3C traceparent propagation

Security & Privacy

Secret redaction (on by default): Strips API keys, platform tokens, JWTs, and credentials from recorded tool arguments before export
Tool output is not captured by default (captureToolOutput: false)
Message content is not captured by default (captureMessageContent: false)
Data destination: Traces are exported via OTLP HTTP to Pydantic Logfire (US or EU region). No other external endpoints are contacted.
No local persistence: All data is streamed to Logfire; nothing is written to disk

External Endpoints

URL	Data Sent
`https://logfire-api.pydantic.dev` (US)	OTLP traces + metrics
`https://logfire-api-eu.pydantic.dev` (EU)	OTLP traces + metrics

By using this plugin, trace and metric data is sent to Pydantic Logfire. Only install if you trust this destination.