OpenClaw otel-observability

OpenClaw Observability Dashboard

Visualize traces, metrics, and logs exported by the OpenClaw diagnostics-otel + otel-observability plugin via OpenTelemetry.

Features

• Token usage by type (input / cache_read / output)
• Token usage by model
• Cost tracking
• Message queue and session status
• Trace visualization (spans per service)

Requirements

• observability-stack — OpenTelemetry → OpenSearch pipeline
• Grafana OpenSearch datasource plugin (grafana-opensearch-datasource)
• OpenClaw with diagnostics-otel plugin enabled

Setup

Download these two files:

• docker-compose.grafana.yml — https://gist.github.com/fudongyingluck/a6de6636a8fcc9ae161f08d1ebd1de96
• datasources.yaml — https://gist.github.com/fudongyingluck/6cb5e7984f535ac5b3831a55012c9503

Edit datasources.yaml with your OpenSearch host, username, and password, then run:

docker compose -f docker-compose.yml -f docker-compose.grafana.yml up -d grafana

Import this dashboard and bind the three datasources:

• DS_PROMETHEUS → Prometheus
• DS_OPENSEARCH_LOGS → OpenSearch-Logs
• DS_OPENSEARCH_TRACES → OpenSearch-Traces