Opik – An Observability Layer for OpenClaw

Official plugin for OpenClaw that exports agent traces to
Opik for observability and monitoring.

Opik is a leading open-source LLM and agent observability, tracing, evaluation and optimization platform. @opik/opik-openclaw adds native Opik tracing for OpenClaw runs:

LLM request/response spans
Sub-agent request/response spans
Tool call spans with inputs, outputs, and errors
Run-level finalize metadata
Usage and cost metadata

The plugin runs inside the OpenClaw Gateway process. If your gateway is remote, install and configure the plugin on that host.

Prerequisites:

OpenClaw >=2026.3.2
Node.js >=22.12.0
npm >=10

openclaw plugins install @opik/opik-openclaw

If the Gateway is already running, restart it after install.

The setup wizard validates endpoint and credentials, then writes config under plugins.entries.opik-openclaw. If you choose Opik Cloud and do not have an account yet, the wizard now points you to the free signup flow before asking for an API key.

openclaw gateway run
openclaw message send "hello from openclaw"

Then confirm traces in your Opik project.

{ "plugins": { "entries": { "opik-openclaw": { "enabled": true, "config": { // base configuration "enabled": true, "apiKey": "your-api-key", "apiUrl": "https://www.comet.com/opik/api", "projectName": "openclaw", "workspaceName": "default", // optional advanced configuration "tags": ["openclaw"], "toolResultPersistSanitizeEnabled": false, "staleTraceCleanupEnabled": true, "staleTraceTimeoutMs": 300000, "staleSweepIntervalMs": 60000, "flushRetryCount": 2, "flushRetryBaseDelayMs": 250
        }
      }
    }
  }
}

OpenClaw warns when plugins.allow is empty and a community plugin is discovered. Pin trusted plugins explicitly:

{ "plugins": { "allow": ["opik-openclaw"]
  }
}

OPIK_API_KEY
OPIK_URL_OVERRIDE
OPIK_PROJECT_NAME
OPIK_WORKSPACE

toolResultPersistSanitizeEnabled is disabled by default. When enabled, the plugin rewrites local image refs in persisted tool transcript messages via tool_result_persist.

Command	Description
`openclaw plugins install @opik/opik-openclaw`	Install plugin package
`openclaw opik configure`	Interactive setup wizard
`openclaw opik status`	Print effective Opik configuration

OpenClaw event	Opik entity	Notes
`llm_input`	trace + llm span	starts trace and llm span
`llm_output`	llm span update/end	writes usage/output and closes span
`before_tool_call`	tool span start	captures tool name + input
`after_tool_call`	tool span update/end	captures output/error + duration
`subagent_spawning`	subagent span start	starts subagent lifecycle span on requester trace
`subagent_spawned`	subagent span update	enriches subagent span with run metadata
`subagent_ended`	subagent span update/end	finalizes subagent span with outcome/error
`agent_end`	trace finalize	closes pending spans and trace

No OpenClaw core changes are included in this repository and relies on native hooks within the OpenClaw ecosystem.

Prerequisites:

Node.js >=22.12.0
npm >=10

npm ci
npm run lint
npm run typecheck
npm run test
npm run smoke

Read CONTRIBUTING.md before opening a PR.

Apache-2.0

Hacker News

Opik – An Observability Layer for OpenClaw

Show article

calebkaiser

Comments

HackerNews