OpenClaw 插件部署

openclaw-bonree-plugin 是一个 OpenClaw 插件，用于通过 OpenTelemetry OTLP 将 AI Agent 的执行链路上报到 Bonree ONE 平台。

插件主要覆盖以下运行过程数据：

Gateway 生命周期
Session 生命周期
用户消息
LLM 请求与响应
工具调用
Agent 执行生命周期

安装前准备

部署前请确认目标主机满足以下条件：

已安装 OpenClaw，且 openclaw 命令已加入 PATH
当前主机可以访问 Bonree ONE 的 OTLP Endpoint
已从部署页面获取必填的 x-br-acid 账号 GUID

使用限制

限制项	说明
上报协议	仅支持 `HTTP/Protobuf`，暂不支持 `HTTP/JSON` 和 `gRPC`。
OpenClaw 版本	仅测试过 OpenClaw `v2026.3.12`、`v2026.3.24`、`v2026.3.31` 和 `v2026.4.9`。

安装命令

可直接执行如下命令进行部署，例如：

curl -fsSL https://one.bonree.com/docs/en/openclaw/install.sh | bash -s -- \
--endpoint "https://oneupload.bonree.com/APM/otel" \
--account "your-accountGUID" \
--set-env-id "your-env-id" \
--set-attr "datacenter=1" \
--serviceName "your-service-name"

安装脚本下载地址：

参数说明

参数	是否必填	说明
`--endpoint`	是	Bonree ONE OTLP 上报地址，必须可从目标主机访问。
`--account`	是	Bonree ONE 账号 GUID，对应请求头 `x-br-acid`。
`--set-env-id`	否	环境 ID，对应请求头 `x-br-envid`，可在 `部署配置` -> `安装部署` 页面查看。
`--set-attr`	否	用于设置数据中心 ID，对应请求头 `x-br-attrs`。示例：`datacenter=1`。
`--serviceName`	否	服务名，默认值为 `openclaw-agent`。
`--install-dir`	否	自定义 OpenClaw 状态根目录。安装脚本会自动在该目录下追加 `extensions/openclaw-bonree-plugin`。
`--plugin-url`	否	自定义插件安装包下载地址。

默认安装目录

未指定 --install-dir 时，安装脚本按以下顺序选择目标目录：

$OPENCLAW_STATE_DIR/extensions/openclaw-bonree-plugin
~/.openclaw/extensions/openclaw-bonree-plugin

写入 OpenClaw 配置

安装完成后，脚本会更新 openclaw.json，并写入以下配置段：

plugins.allow
plugins.load.paths
plugins.entries.openclaw-bonree-plugin

配置示例：

{
  "diagnostics": {
    "enabled": true
  },
  "plugins": {
    "allow": ["openclaw-bonree-plugin"],
    "load": {
      "paths": [
        "/Users/yourname/.openclaw/extensions/openclaw-bonree-plugin"
      ]
    },
    "entries": {
      "openclaw-bonree-plugin": {
        "enabled": true,
        "config": {
          "endpoint": "https://oneupload.bonree.com/APM/otel",
          "headers": {
            "x-br-acid": "your-accountGUID",
            "x-br-envid": "your-env-id",
            "x-br-attrs": "datacenter=1"
          },
          "serviceName": "openclaw-agent"
        }
      }
    }
  }
}

验证部署

部署完成后执行：

openclaw plugins list

如果安装成功，结果中应能看到 openclaw-bonree-plugin，并且状态为已加载或已启用。

也可以手动确认 gateway 是否可以正常重启：

openclaw gateway restart

如果重启仍失败，可进一步执行：

openclaw doctor

卸载

普通卸载：

curl -fsSL https://one.bonree.com/docs/en/openclaw/uninstall.sh | bash

跳过确认直接卸载：

curl -fsSL https://one.bonree.com/docs/en/openclaw/uninstall.sh | bash -s -- --yes

卸载脚本下载地址：

uninstall.sh

如果安装时使用了自定义路径，需要注意安装脚本和卸载脚本对 --install-dir 的含义不同：

install.sh --install-dir 传入的是 OpenClaw 状态根目录。
uninstall.sh --install-dir 传入的是插件实际目录。

例如：

curl -fsSL https://one.bonree.com/docs/en/openclaw/uninstall.sh | bash -s -- \
--install-dir /path/to/extensions/openclaw-bonree-plugin

卸载脚本会清理 openclaw.json 中的插件配置，删除插件目录，并重启 OpenClaw gateway。

常见提示

如果提示 OpenClaw CLI not found，请先安装 OpenClaw，并确认 openclaw 已加入 PATH。
如果提示 Endpoint is unreachable，请优先检查 Endpoint 地址和目标主机的网络连通性。

安装前准备​

使用限制​

安装命令​

参数说明​

默认安装目录​

写入 OpenClaw 配置​

验证部署​

卸载​

常见提示​