Opik-OpenClaw — OpenClaw 官方可观测性插件

> 一句话版本:Comet.ml 做的 OpenClaw 插件,把 Agent 的每一步操作(LLM 调用、工具执行、子 Agent 生命周期)导出到 Opik 平台,可视化监控成本、token、错误。

项目信息
来源[github.com/comet-ml/opik-openclaw](https://github.com/comet-ml/opik-openclaw)
公司Comet.ml(ML 可观测性平台)
Stars554Forks60
创建2026-03-02语言TypeScript
协议Apache 2.0依赖OpenClaw >=2026.3.2

它是什么

OpenClaw 的官方可观测性插件,运行在 Gateway 进程内,通过 OpenClaw 原生 hooks 捕获所有事件,导出到 Opik 平台。

安装


openclaw plugins install clawhub:@opik/opik-openclaw
openclaw opik configure   # 交互式配置向导
openclaw opik status      # 查看配置状态
openclaw gateway run      # 启动

支持 Opik Cloud(免费注册)和自托管。

追踪的事件

OpenClaw 事件Opik 实体说明
`llm_input`trace + llm span开始 trace,记录 LLM 输入
`llm_output`llm span update/end记录 usage/output,关闭 span
`before_tool_call`tool span start工具名 + 输入
`after_tool_call`tool span update/end输出/错误 + 耗时
`subagent_spawning`subagent span start子 Agent 生命周期开始
`subagent_spawned`subagent span update丰富元数据
`subagent_ended`subagent span update/end结果/错误
`agent_end`trace finalize关闭所有 span 和 trace

高级配置


{
  "plugins": {
    "entries": {
      "opik-openclaw": {
        "enabled": true,
        "config": {
          "apiKey": "your-api-key",
          "apiUrl": "https://www.comet.com/opik/api",
          "projectName": "openclaw",
          "workspaceName": "default",
          "tags": ["openclaw"],
          "toolResultPersistSanitizeEnabled": false,
          "staleTraceCleanupEnabled": true,
          "staleTraceTimeoutMs": 300000,
          "staleSweepIntervalMs": 60000,
          "flushRetryCount": 2,
          "flushRetryBaseDelayMs": 250
        }
      }
    }
  }
}

支持环境变量覆盖:OPIK_API_KEYOPIK_URL_OVERRIDEOPIK_PROJECT_NAMEOPIK_WORKSPACE

Opik 平台

Opik 是开源的 LLM/Agent 可观测性、追踪、评估和优化平台,由 Comet.ml 维护。

分析

优势

风险

与 Jay 的关联

评分

维度评分 (1-10)说明
实用性9OpenClaw 用户必备的可观测性工具
易用性9一条命令安装,交互式配置
代码质量8TypeScript,Apache 2.0,测试覆盖
创新性6标准可观测性方案,无特别创新
通用性8Opik Cloud + 自托管,灵活
与 Jay 的关联9直接可用,监控 researcher agent
**总分****8.2**OpenClaw 生态的重要基础设施