文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>腾讯云可观测平台>LLM 可观测>接入应用>接入 OpenClaw 应用

接入 OpenClaw 应用

最近更新时间：2026-04-08 17:30:14

我的收藏

本页目录：

OpenClaw 是一款可自我演化的开源通用智能体框架，本文介绍如何将 OpenClaw 应用接入腾讯云可观测平台，实现对业务链路、系统状态、Token 消耗的全方位掌控。

前提条件

OpenClaw 版本 ≥ 2026.3.13。可以通过openclaw --version命令查看 OpenClaw 版本。
已拥有腾讯云账号，且已开通 应用性能监控（APM）。

接入流程

步骤1：获取接入点与 Token

1. 进入 腾讯云可观测平台 > LLM 可观测 > 应用列表 页面。
2. 单击应用列表中的接入应用。
3. 在右侧弹出的接入应用抽屉框中，单击 OpenClaw。
4. 选择您所要接入的地域以及业务系统。
5. 选择您想要的上报方式，获取您的接入点和 Token。
说明：
内网上报：使用此上报方式，您的服务需运行在腾讯云 VPC。通过 VPC 直接连通，在避免外网通信的安全风险的同时，可以节省上报流量开销。
外网上报：当您的服务部署在本地或非腾讯云 VPC 内，可以通过此方式上报数据。请注意外网通信存在安全风险，同时也会造成一定上报流量费用。

步骤2：安装 diagnostics-otel

OpenClaw 通过 diagnostics-otel 插件实现指标上报，该插件随 OpenClaw 一起分发，但其运行所依赖的 npm 包可能未预安装。在启用插件前，需要确认相关依赖已经安装就绪。
执行如下命令检查 node_modules 目录是否存在。
ls <OpenClaw installation directory>/extensions/diagnostics-otel/node_modules/
若该目录不存在或为空，表示依赖尚未安装。请进入 diagnostics-otel 插件目录，执行安装命令。
cd <OpenClaw installation directory>/extensions/diagnostics-otel
npm install --production
安装成功后，终端会输出类似 "added 72 packages" 的提示。
注意：
依赖必须在插件目录 extensions/diagnostics-otel/ 下安装，不能在 OpenClaw 根目录安装，否则会导致依赖解析错误。

步骤3：安装 openclaw-tencent-plugin

openclaw-tencent-plugin 是腾讯云 APM 可观测性增强插件，为 OpenClaw 提供全链路分布式追踪能力，自动构建完整的 Span 树。该插件依赖 diagnostics-otel 插件提供的全局 OTel SDK，需要在 diagnostics-otel 之后加载。
在 OpenClaw 的 extensions 目录下，执行如下命令安装 openclaw-tencent-plugin 插件。
cd ~/.openclaw/extensions/
openclaw plugins install openclaw-tencent-plugin

步骤4：修改配置文件

编辑 OpenClaw 的配置文件 openclaw.json。
配置文件位置：
直接安装：~/.openclaw/openclaw.json
Docker 部署：宿主机上映射到容器的配置目录中（取决于 docker-compose.yml 中的 volume 映射路径）。
在配置文件中添加以下两个配置块：
{
  "plugins": {
    "entries": {
      "diagnostics-otel": {
        "enabled": true
      },
      "openclaw-tencent-plugin": {
        "enabled": true
      }
    }
  },
  "diagnostics": {
    "enabled": true,
    "otel": {
      "enabled": true,
      "endpoint": "<endpoint>",
      "protocol": "http/protobuf",
      "headers": {
        "Authorization": "<token>"
      },
      "serviceName": "<serviceName>",
      "traces": true,
      "metrics": true,
      "logs": false,
      "flushIntervalMs": 5000
    }
  }
}
说明：
如果 openclaw.json 中已有其他配置项（如 agents、gateway 等），请将上述 plugins 和 diagnostics 块合并到现有配置中，不要覆盖已有内容。

配置字段说明

字段
必填
说明
plugins.entries.diagnostics-otel.enabled
是
设为 true 启用 diagnostics-otel 插件。
plugins.entries.openclaw-tencent-plugin.enabled
是
设为 true 启用 openclaw-tencent-plugin 插件。
diagnostics.enabled
是
设为 true 启用诊断功能。
diagnostics.otel.enabled
是
设为 true 启用 OTel 数据导出。
diagnostics.otel.endpoint
是
APM 接入点地址。必须包含 http:// 前缀。
示例：http://ap-guangzhou.apm.tencentcs.com:90/otlp
diagnostics.otel.protocol
是
固定填写 http/protobuf，OpenClaw 仅支持此协议。
diagnostics.otel.headers
否
自定义 HTTP 请求头，用于传递认证信息。键值对格式，如 {"Authentication": "<token>"}。
diagnostics.otel.serviceName
是
应用名称，用于在 APM 控制台中标识此应用。最长63个字符，只能包含小写字母、数字及分隔符 -，且必须以小写字母开头。
diagnostics.otel.traces
否
是否上报链路追踪数据，默认为 true。
diagnostics.otel.metrics
否
是否上报指标数据，默认为 true。
diagnostics.otel.logs
否
是否上报日志数据，默认为 false。
diagnostics.otel.sampleRate
否
采样率，取值范围为0.0 - 1.0，默认全量采集。
diagnostics.otel.flushIntervalMs
否
数据刷新间隔（毫秒），最小值1000，建议设为5000。

配置示例

以应用名为 my-openclaw 为例。
{
  "plugins": {
    "entries": {
      "diagnostics-otel": {
        "enabled": true
      },
      "openclaw-tencent-plugin": {
        "enabled": true
      }
    }
  },
  "diagnostics": {
    "enabled": true,
    "otel": {
      "enabled": true,
      "endpoint": "http://ap-guangzhou.apm.tencentcs.com:90/otlp",
      "protocol": "http/protobuf",
      "headers": {
        "Authorization": "aBcDeFgHiJkL"
      },
      "serviceName": "my-openclaw",
      "traces": true,
      "metrics": true,
      "logs": false,
      "flushIntervalMs": 5000
    }
  }
}

配置指标聚合模式

OpenClaw 的 diagnostics-otel 插件默认使用 Cumulative（累积）模式上报 Metrics 数据。如需切换为 Delta（增量）模式，需要通过环境变量进行配置。
在启动 OpenClaw 前设置环境变量：
export OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE=delta

步骤5：重启 OpenClaw

配置修改完成后，执行如下命令重启 OpenClaw，使配置生效。
openclaw gateway restart
如果您采用 Docker 部署 OpenClaw，请在宿主机上执行如下命令：
docker compose restart
注意：
Docker 环境下不要使用 docker compose down && up，否则容器内通过 npm install 安装的插件依赖会丢失（除非已通过 Dockerfile 固化）。使用 docker compose restart 仅重启容器进程，不影响容器内的文件系统。

接入验证

验证插件状态

进入 OpenClaw 运行环境，执行如下命令确认插件已加载：
openclaw plugins list
在输出列表中找到 diagnostics-otel 和 openclaw-tencent-plugin，确认其状态为 loaded。
如果您采用 Docker 部署 OpenClaw，请在宿主机上执行如下命令确认插件已加载：
docker exec -it <Container Name> openclaw plugins list

验证数据上报

请确保 OpenClaw 有正常的业务流量（如发送消息、调用 AI 模型等）。
1. 进入 腾讯云可观测平台 > LLM 可观测 > 应用列表 页面。
2. 在应用列表页面中查看是否出现您配置的应用名（如 my-openclaw）。
3. 单击应用名称进入性能概览，可以看到接入应用实例的指标数据。
说明：
可观测数据的处理存在一定延时。如果接入后在控制台没有查询到应用或实例，请等待约30秒后刷新页面。
中国站