OpenClaw TLS 日志上报插件

把 OpenClaw 的运行期日志 / 审计 / cache-trace / trace 上报到火山引擎 TLS。

安装

方式一：使用一键安装 CLI（推荐）

npm exec -y --package=@volcengine/diagnostics-tls-install -- diagnostics-tls-install

方式二：手动安装插件

openclaw plugins install "@volcengine/diagnostics-tls" --pin
openclaw plugins enable diagnostics-tls
# 进行下面的配置后然后重启 gateway
openclaw gateway restart

配置

插件配置从 OpenClaw 的插件配置读取（plugins.entries.diagnostics-tls.config）

配置示例（~/.openclaw/openclaw.json）：

使用 AK SK 方式

{
  "plugins": {
    "enabled": true,
    "entries": {
      "diagnostics-tls": {
        "enabled": true,
        "config": {
          "ak": "xxx",
          "sk": "xxx",
          "endpoint": "tls-cn-beijing.volces.com",
          "region": "cn-beijing",
          "debug": false,
          "logConfig": {
            "appLogTopicId": "xxx",
            "auditLogTopicId": "xxx",
            "cacheTraceTopicId": "xxx",
            "sessionTopicId": "xxx"
          },
          "traceConfig": {
            "traceTopicId": "xxx",
            "authMode": "header"
          }
        }
      }
    }
  }
}

使用 apiKey 方式

{
  "plugins": {
    "enabled": true,
    "allow": ["diagnostics-tls"],
    "entries": {
      "diagnostics-tls": {
        "enabled": true,
        "config": {
          "apiKey": "xxx",
          "endpoint": "tls-cn-beijing.volces.com",
          "region": "cn-beijing",
          "debug": false,
          "logConfig": {
            "appLogTopicId": "xxx",
            "auditLogTopicId": "xxx",
            "cacheTraceTopicId": "xxx",
            "sessionTopicId": "xxx"
          },
          "traceConfig": {
            "traceTopicId": "xxx",
            "authMode": "header"
          }
        }
      }
    }
  }
}

构建与分发

构建会生成单文件产物 dist/index.cjs，并 external openclaw/plugin-sdk*。

# 生成 dist/index.cjs（默认 external 依赖，安装时由 openclaw 自动 npm install dependencies）
yarn build

# 生成可直接打包发给用户的最小目录：release/diagnostics-tls/
yarn build:release