文档中心

全栈可观测平台

AI Agent 观测实践

OpenClaw 链路监控

作为现象级的开源 AI Agent 项目，OpenClaw 正凭借强大的自主执行能力，迅速成为能操作文件、调用系统命令、控制浏览器的“数字员工”，但用得好是生产力，用不好可能就是个“烧钱黑洞”。本文为您详细介绍如何将 OpenClaw 的观测数据接入 APMPlus，让您的 AI 应用从“成本失控”走向“成本可控”。

背景信息

随着 OpenClaw 的自主性越强，其内部行为的不可见性就越突出。心跳检查、上下文累积、多步推理等这些看似正常的机制，都可能悄悄推高 Token 消耗，而用户却浑然不觉。

APMPlus 聚焦破解 AI 应用“黑盒”难题，提供从代码到模型的全链路监控。APMPlus 在行业内率先支持接收该插件上报的数据，并提供开箱即用的监控看板，帮助用户解决以下问题：

实时洞察 Token 消耗：预置看板直观展示 Token 用量、成本趋势，让每一分钱都有据可查。

预警异常行为：可自定义成本阈值，当心跳检查等后台任务触发异常消耗时，第一时间发出告警。

关联分析根因：将 Token 消耗与具体调用链、上下文大小关联，快速定位成本黑洞的来源。

前提条件

已经部署 v2026.4.24 及以上版本的开源 OpenClaw，部署指南参考 OpenClaw 官方介绍。

已经获取 OpenClaw 接入必备的配置信息。具体如下：

配置项	说明
AppKey	应用性能监控的认证信息。虽然认证信息 App Key 不区分接入的服务类型和数据采集方式，但不同工作区的认证信息 App Key 各不相同，获取方式参考：如何获取应用性能监控的认证信息 AppKey。
Region	服务接入的地域 ID，例如：cn-beijing。应用性能监控目前支持的地域信息参见：开服地域。
ServiceName	服务名称，例如：openclaw。服务在应用性能监控中的显示名称，可根据实际情况自定义服务名称。

操作步骤

步骤一：OpenClaw 接入

本文提供 3 种 OpenClaw 接入方式，可根据实际场景，选择合适的接入方式。

通过 CLI 一键接入

通过 OpenClaw 自动接入

通过原生命令接入

执行以下命令，一键安装 apmplus-openclaw-plugin 插件，并根据操作指引，完成配置。

步骤二：（可选）修改配置

若apmplus-openclaw-plugin 插件安装和配置完成后，需要对配置进行修改，可根据实际情况，选择合适的方式更新配置。

交互型快捷配置

通过控制台配置

通过配置文件配置

可执行以下命令，根据配置指引，进行交互型快捷配置。

步骤二：查看可观测数据

通过 WebUI 或其他方式与 OpenClaw 进行交互。对话完成后，可前往 APMPlus 控制台查看观测数据。

前往服务列表，可通过服务名搜索已经接入的 OpenClaw。

单击服务名称，进入服务详情页，在 Trace 分析页面查看 OpenClaw 服务对应的 Trace Span 列表。

单击目标 Trace ID，切换到属性页签，可查看本次请求的详细信息，例如：请求模型、Token 消耗等。

后续操作

前往预置看板，选择 OpenClaw 观测大盘，可查看 APMPlus 针对 OpenClaw 提供的预置看板。

说明

若预置看板无法满足监控需求，也可根据实际需求创建自定义看板。OpenClaw 暴露的 OpenTelemetry 指标参见 OpenClaw 指标说明。

前往告警任务，单击新建告警任务，可根据实际情况为 OpenClaw 可观测指标配置自动化告警监控，例如：Token 消耗、会话卡顿等。配置告警任务可以监测目标服务的配置项指标的异常情况，并及时收到通知，帮助您及时关注 OpenClaw 的运行状况。

说明

配置告警任务可以监测对应指标值，满足配置条件时将自动发送告警消息。告警任务相关详细介绍参见：告警任务。

常见问题

Q：为什么 Openclaw 升级到 v2026.4.24 以后版本，Trace 统计不到 LLM 节点，也缺少 Token 消耗信息上报？

A：社区 v2026.4.24 版本存在 breaking change。要求必须设置 hooks.allowConversationAccess 为 true，才允许插件使用一些钩子。若直接通过 npm 手动下载，需要执行以下命令，进行配置：

openclaw config set plugins.entries.apmplus-openclaw-plugin.hooks.allowConversationAccess true

Q：为什么下载插件时报错 (429): Rate limit exceeded？

A：OpenClaw 社区在 323 版本之后强制要求所有插件的安装必须先解析 Clawhub 再 fallback 到 npm。而 Clawhub 匿名访问时会对所有 IP 进行限流。如果触发限流，可以先执行 npx clawhub login 以个人身份登录 clawhub，再继续按步骤正常安装插件。

npx clawhub login

Q：为什么采集到的 Token 数量为 0 ？

A：社区 3.7 版本更新中，对于非 OpenClaw 原生支持的自定义 Provider 模型，全部强制设置 compat.supportsUsageInStreaming 字段为 false，将导致无法正常统计自定义 Provider 模型的 usage。将 Provider 模型中的 compat.supportsUsageInStreaming 设置为 true 、 diagnostics.enabled 设置为 true 即可。

Q：如果不想采集输入输出等敏感信息，该怎么设置？

A：可在配置中将 allowUserDetailInfoReport设置为 false。参考如下配置：

{
// 请勿修改上述其他配置
"plugins": {
"allow": [
// .....
"any-other-plugin", // 请勿删除任何其他插件
// .....
"apmplus-openclaw-plugin", // 添加 apmplus-openclaw-plugin
],
"entries": {
"apmplus-openclaw-plugin": { // 添加 apmplus-openclaw-plugin 的插件配置
"enabled": true,
"config": {
"endpoint": "http://apmplus-cn-beijing.volces.com/server_collect/third_party/open_telemetry/v2/{your_app_key}", // APMPlus 上报端点。{your_app_key} 替换为您的 appkey，cn-beijing 替换为您的 Region ID
"serviceName": "your-service-name", // 自定义服务名称
"allowUserDetailInfoReport": false // 不允许采集请求敏感信息
}
}
}
}
}

最近更新时间：2026.06.18 17:10:25

这个页面对您有帮助吗？

有用

无用