概述

本文档介绍如何将 OpenClaw 的可观测数据接入云监控 BCM 的 Agent 可观测模块，并在控制台查看应用概览、模型调用分析、Token 分析和调用链分析等数据。

背景

当前 OpenClaw 凭借其卓越的自主执行能力，从基础文件处理到复杂的系统命令调用，已成为开发者心目中高效的“数字员工”。然而，这种强大的自主性也带来了一个巨大的挑战：行为的不可见性与成本的不可预测性。

OpenClaw 缺乏可观测性导致三大核心痛点：

• 成本黑洞： 随着 OpenClaw 执行任务的复杂度，持续累积的上下文以及多轮的递归推理，往往会在后台悄无声息地消耗大量 Token，企业无法精准知晓 Token 消耗节点，成本优化无从下手。
• 排障黑盒： OpenClaw 处理大量请求，内部会产生多环节链路，缺乏可观测性导致推理链路如同黑盒，缺少追踪让排障只能靠猜。
• 被动发现问题： 系统状态不可见，故障只能在用户投诉后才后知后觉，无法实现主动监控和预防。

解决方案

为了破解 AI 应用的“黑盒”困境，云监控 BCM 的 Agent 可观测提供了从会话到模型调用的全链路监控方案。通过将 OpenClaw 的观测数据接入Agent 可观测，您可以实现以下三大核心价值：

• 全透明成本监控： 利用内置看板实时追踪 Token 消耗走势，确保每一笔模型调用支出都清晰可见。
• 深度根因定位： 将 Token 消耗数据与具体的调用链 Trace 及上下文长度进行关联分析，精准锁定导致高额成本的具体逻辑或任务节点。
• 异常行为自动预警： 针对心跳检测异常或后台任务过度消耗等场景设置阈值，在成本失控前及时介入（即将支持）。

接入可观测数据

步骤1：获取接入点与 Token

• 接入点：http://apm-collector.bj.baidubce.com
• Authentication：ItEpH7MlHT7okHCrVv9TSFsE

步骤2：安装官方可观测插件

先检查当前版本和安装状态：

1openclaw --version
2openclaw plugins list

尚未安装时执行：

1openclaw plugins install clawhub:@openclaw/diagnostics-otel

已安装时不要重复安装；需要更新时执行：

1openclaw plugins update diagnostics-otel

本文配置在 2026.9.2 组合下验证通过。使用其他版本时，先确认其支持 captureContent 和 tracesEndpoint。安装使用官方 ClawHub 包，SDK 依赖由插件管理。官方插件参考

步骤3：启用可观测插件

1openclaw plugins enable diagnostics-otel

如果已有 plugins.allow 白名单，请保留现有条目并加入 diagnostics-otel。

如已安装 Langfuse Bridge，需停用 Bridge，避免双路上报；只有已安装 Bridge 的环境才执行：

1openclaw plugins disable langfuse-bridge

步骤4：添加数据上报配置

将以下配置合并到 ~/.openclaw/openclaw.json，保留现有模型、渠道及其他配置。填写实际 tracesEndpoint，并将 <控制台提供的完整 auth> 替换为复制的 auth 值，即可完成上报配置。

可复制附件 official-otel-config.fragment.json 中的内容，不要用片段覆盖整个文件。

1{
2  "plugins": {
3    "entries": {
4      "diagnostics-otel": {
5        "enabled": true
6      }
7    }
8  },
9  "diagnostics": {
10    "enabled": true,
11    "otel": {
12      "enabled": true,
13      "tracesEndpoint": "http://<endpoint>/api/public/otel/v1/traces", // 替换提供的接入点
14      "protocol": "http/protobuf",
15      "headers": {
16        "Authorization": "<Authentication>" // 替换提供的Authentication
17      },
18      "serviceName": "openclaw", // 可自行替换需要的服务名
19      "traces": true,
20      "metrics": false,
21      "logs": false,
22      "sampleRate": 1.0,
23      "captureContent": true
24    }
25  }
26}

captureContent 位于 diagnostics.otel，不是 plugins.entries.diagnostics-otel.config。

步骤5：重启 OpenClaw gateway 服务

1openclaw config validate --json
2openclaw gateway restart
3openclaw gateway status
4openclaw plugins list

确认配置校验通过、Gateway 正在运行且可以连接，diagnostics-otel 为 loaded，旧 Bridge 已停用。插件加载成功不等于 APM 接收成功，需要继续完成步骤 6。

本机已完成上述操作，Gateway 2026.9.2 正在运行，连接探针通过。

步骤6：接入验证

通过 Gateway 的 WebChat、TUI 或 openclaw agent 发起一次包含唯一标记的非敏感请求。下面的测试使用新会话，仅调用一次 exec 输出测试文本；再次测试请更换唯一标记和会话键。

1openclaw agent \
2  --session-key agent:main:apm-otel-test-001 \
3  --message "APM-OTEL-TEST-001：请只调用一次 exec，执行 printf 'APM_TOOL_OK_001'，完成后回复 APM_REPLY_OK_001 并附上工具输出。不要读取文件或发送外部消息。" \
4  --thinking minimal --timeout 120 --json

等待 Trace 批量发送完成，然后在 Agent可观测->应用列表 中按应用 openclaw 和测试时间查找。不要使用 openclaw agent exec 代替该命令，它在本版本中不启动此 exporter。

查看OpenClaw可观测数据

和OpenClaw进行对话交互后，可前往“BCM 云监控->Agent 可观测”平台查看观测数据
1.在“LLM应用性能监控->应用列表”找到已经接入的 OpenClaw应用。

2.点击应用名称，进入到应用详情页，展示应用概览、模型调用分析、大模型操作、Token 分析等内置看板。所有指标均可配置阈值报警，问题发生时第一时间通知，及时发现异常。

3.点击应用详情里的调用链分析 Tab，查看 OpenClaw 应用所有的 Trace和Span 数据。

4.点击目标 Trace ID，可清晰查看每一次请求调用链路，告别排障黑盒。切换到属性页签，可查看本次请求的详细信息，如：模型名称、Token消耗等，让企业清楚掌握每一次调用的 Token 成本具体花在何处。