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 可观测性平台) | ||
| Stars | 554 | Forks | 60 |
| 创建 | 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_KEY、OPIK_URL_OVERRIDE、OPIK_PROJECT_NAME、OPIK_WORKSPACE。
Opik 平台
Opik 是开源的 LLM/Agent 可观测性、追踪、评估和优化平台,由 Comet.ml 维护。
分析
优势:
- 🔥 官方插件——Comet.ml 和 OpenClaw 官方合作,不是社区野路子
- 🔥 零侵入——通过 OpenClaw 原生 hooks,不需要改核心代码
- 🔥 完整覆盖——LLM 调用、工具执行、子 Agent 全链路追踪
- 🔥 ClawHub 分发——
clawhub:@opik/opik-openclaw一键安装 - 📊 554 stars——1.5 个月,增长健康
风险:
- ⚠️ 依赖 Comet.ml SaaS——Opik Cloud 数据在他们的服务器上(也可以自托管)
- ⚠️ 0 open issues——可能社区参与度不够,或问题在 Discord 解决
- 🟡 性能开销——每次 LLM/工具调用都要发 HTTP 请求到 Opik
与 Jay 的关联:
- 🔥 直接可用——Jay 的 OpenClaw 可以立即安装,监控 researcher agent 的行为
- 成本追踪——可以看到每个报告的 token 消耗和成本
- 错误诊断——之前 cron lint 超时等问题可以可视化追踪
- 子 Agent 监控——sessions_spawn 的 sub-agent 生命周期可见
评分
| 维度 | 评分 (1-10) | 说明 |
|---|---|---|
| 实用性 | 9 | OpenClaw 用户必备的可观测性工具 |
| 易用性 | 9 | 一条命令安装,交互式配置 |
| 代码质量 | 8 | TypeScript,Apache 2.0,测试覆盖 |
| 创新性 | 6 | 标准可观测性方案,无特别创新 |
| 通用性 | 8 | Opik Cloud + 自托管,灵活 |
| 与 Jay 的关联 | 9 | 直接可用,监控 researcher agent |
| **总分** | **8.2** | OpenClaw 生态的重要基础设施 |