本文为您详细介绍 OpenClaw 通过 diagnostics-otel 插件暴露的 OpenTelemetry 指标，旨在为监控、告警和可观测性分析提供参考。

指标分析

目前，OpenClaw 通过 diagnostics-otel 插件共产生了 18 个指标，其中，12 个 Counter 类型指标用于累计计数，6 个 Histogram 类型指标用于测量值的分布情况。这些指标涵盖 OpenClaw 系统的多个关键方面，包括：模型使用、Webhook 处理、消息队列、会话管理。

模型使用相关指标

这部分指标直接关系到大模型的调用成本，是控制开支的核心。通过监控 Token 消耗、预估成本、运行时长和上下文使用情况，可以清晰了解每次调用花了多少钱，避免因配置不当导致的资源浪费。

指标名称	类型	单位	描述	标签（Label）
openclaw.tokens	Counter	1	模型处理时消耗的 Token 数量，区分输入和输出。	openclaw.channel openclaw.provider openclaw.model openclaw.token
openclaw.cost.usd	Counter	1	根据 Token 用量预估的模型使用成本（USD），实时掌握开支。注意该指标用于记录模型使用的预估成本，按美元（USD）计算费用。仅 OpenClaw 上游 model.usage 事件中明确提供 costUsd 字段时才会被记录。若上游事件未提供成本信息，此指标将不会产生数据。	openclaw.channel openclaw.provider openclaw.model
openclaw.run.duration_ms	Histogram	ms	Agent 运行时长，即一次任务从开始到结束的耗时，反映整体响应速度。	openclaw.channel openclaw.provider openclaw.model
openclaw.context.tokens	Histogram	1	上下文窗口大小和使用情况，即当前对话或任务占用的上下文 Token 数量。	openclaw.channel openclaw.provider openclaw.model openclaw.context

Webhook 处理相关指标

Webhook 是 OpenClaw 与外部系统交互的重要通道。通过监控 Webhook 接收量、处理错误率和处理时长，可以及时发现外部服务调用的异常，确保系统间集成的稳定性。

指标名称	类型	单位	描述	标签（Label）
openclaw.webhook.received	Counter	1	收到的 Webhook 请求总数。	openclaw.channel openclaw.webhook
openclaw.webhook.error	Counter	1	处理 Webhook 时出错的次数。	openclaw.channel openclaw.webhook
openclaw.webhook.duration_ms	Histogram	ms	处理单个 Webhook 请求的平均耗时。	openclaw.channel openclaw.webhook

消息队列相关指标

消息队列是 OpenClaw 处理任务的中转站。关注入队/出队数量、队列深度和等待时间，可以判断系统是否出现拥堵、任务是否积压，从而及时调整资源或排查瓶颈。

指标名称	类型	单位	描述	标签（Label）
openclaw.message.queued	Counter	1	入队的消息数，即进入待处理队列的消息总量，反映请求压力。	openclaw.channel openclaw.source
openclaw.message.processed	Counter	1	处理的消息数，即消息处理完成的次数，按成功/失败等结果分类。	openclaw.channel openclaw.outcome
openclaw.message.duration_ms	Histogram	ms	消息处理时长，即处理一条消息平均需要多少毫秒。	openclaw.channel openclaw.outcome
openclaw.queue.depth	Histogram	1	入队/出队时的队列深度，即消息入队或出队时，队列里堆积的消息数量。	openclaw.channel openclaw.source openclaw.lane
openclaw.queue.wait_ms	Histogram	ms	消息执行前的队列等待时间。	openclaw.lane
openclaw.queue.lane.enqueue	Counter	1	命令队列通道入队次数。	openclaw.lane
openclaw.queue.lane.dequeue	Counter	1	命令队列通道出队次数。	openclaw.lane

会话管理相关指标

会话状态变化和卡住会话的数量，反映了交互的健康度。通过监控会话卡住、重试次数等指标，可以快速发现哪些对话陷入了死循环或异常状态，提升用户体验。

指标名称	类型	单位	描述	标签（Label）
openclaw.session.state	Counter	1	会话状态转换。	openclaw.state openclaw.reason
openclaw.session.stuck	Counter	1	处理中卡住、没有进展的会话数量。	openclaw.state
openclaw.session.stuck_age_ms	Histogram	ms	会话卡住的时间，即这些卡住的会话已经卡了多久。	openclaw.state
openclaw.run.attempt	Counter	1	任务执行重试的次数，帮助发现不稳定环节。	openclaw.attempt

标签说明

以下详细介绍上述指标中使用标签的含义和可选值。合理利用这些指标搭建监控看板，可以全面了解 OpenClaw 系统的运行状态，及时发现和解决问题，优化系统性能，提高用户体验。

标签 (Label)	描述	可选值
openclaw.token	标记 Token 的具体类型，用于细分 openclaw.tokens 指标。	input：模型接收的输入 Token 数量。 output：模型生成的输出 Token 数量。 cache_read：从缓存中读取的 Token 数量。 cache_write：写入缓存的 Token 数量。 prompt：完整的提示 Token 数量 (通常指发送给模型的原始文本), 包含 cache 的信息。 total：上述所有类型 Token 的总和。
openclaw.context	标记上下文窗口的使用情况，用于 openclaw.context.tokens 指标。	limit：模型支持的最大上下文窗口长度。 used：本次调用实际使用的上下文 Token 数量。
openclaw.outcome	标记消息处理的最终结果，用于 openclaw.message.processed 和 openclaw.message.duration_ms 指标。	事件的输出状态，未知时通常为 unknown，典型示例： completed, error, skipped。
openclaw.channel	标识事件的来源渠道或通信平台。说明对于 diagnostic.heartbeat 事件，该维度会被设置为 heartbeat，并用于记录 openclaw.queue.depth 指标。	未知时通常为 unknown，示例值仅供参考，典型示例： slack、telegram、discord、api、cli 等。
openclaw.provider	标识提供模型服务的供应商。	未知时通常为 unknown，示例值仅供参考，典型示例：openai、anthropic、google、azure、groq 等。
openclaw.model	标识具体的模型名称。	未知时通常为 unknown，示例值仅供参考，典型示例：gpt-4-turbo、claude-3-opus-20240229、gemini-1.5-pro 等。
openclaw.webhook	标识 Webhook 的具体更新类型或事件名。	未知时通常为 unknown，示例值仅供参考。典型示例：message、callback_query、inline_query 等。
openclaw.source	标识将消息推入队列的源头。	未知时通常为 unknown，示例值仅供参考。典型示例：webhook、rpc、internal 等。
openclaw.lane	标识内部命令处理队列的“泳道”或分区。	未知时通常为 unknown，示例值仅供参考。典型示例：default、high_priority 等。
openclaw.state	标识会话所处的具体状态。	未知时通常为 unknown，示例值仅供参考。典型示例：idle、processing、waiting_for_input、blocked、finished 等。
openclaw.reason	提供会话状态转换的原因。	未知时通常为 unknown，示例值仅供参考。典型示例：user_message、tool_call、model_response、error、timeout 等。
openclaw.attempt	标记任务执行的尝试次数，通常从 1 开始计数。	典型示例：1、2、3...

全栈可观测平台