Repolode
comet-ml

comet-ml/opik-openclaw

OpenClaw 官方插件,将智能体调用链、工具调用、Token 用量与成本导出到 Opik 进行监控。

Star
726
Fork
87
未关闭 Issue
17
最近提交
17天前

这是什么?

opik-openclaw 是 OpenClaw 的官方插件,用于把智能体运行数据发送到 Opik。Opik 是开源的 LLM 可观测与评估平台。插件会记录 LLM 请求与响应的 span、子智能体 span、带输入、输出和错误信息的工具调用 span,以及包含用量和成本的运行级元数据。

插件运行在 OpenClaw Gateway 进程内,如果 Gateway 部署在远程主机上,需要在该主机上安装和配置。可通过交互式命令 openclaw opik configure 完成设置,也支持 OPIK_API_KEY、OPIK_PROJECT_NAME 等环境变量。

插件将 llm_input、llm_output、before_tool_call、after_tool_call、subagent_spawned、agent_end 等 OpenClaw 生命周期事件映射为 Opik 的 trace 与 span,并在运行结束时关闭未完成的 span。

核心功能

  • 01将 LLM 请求与响应记录为 Opik span。
  • 02捕获工具调用的输入、输出、错误和耗时。
  • 03在请求方 trace 上记录子智能体的生命周期 span。
  • 04为每次运行上报 Token 用量与成本元数据。
  • 05提供交互式配置向导和状态查看命令。

适用场景

  • 监控 OpenClaw 智能体的成本与 Token 消耗。
  • 排查多步智能体运行中失败的工具调用。
  • 在同一条会话 trace 中查看子智能体的执行过程。

快速上手

  1. 1

    在 OpenClaw 中安装插件

    openclaw plugins install clawhub:@opik/opik-openclaw
  2. 2

    使用设置向导配置插件

    openclaw opik configure
  3. 3

    启动网关并发送测试消息

    openclaw gateway run

使用前须知

  • 需要 OpenClaw 2026.9.7 或更高版本、Node.js 24.16 或更高版本以及 npm 10 或更高版本。
  • 需要 Opik 账户或自托管的 Opik 实例,并配置 API 密钥。
  • 必须安装在运行 OpenClaw 网关的主机上,远程网关尤其需要注意。

收录于专题

标签

常见问题

opik-openclaw 是什么?
OpenClaw 官方插件,将智能体调用链、工具调用、Token 用量与成本导出到 Opik 进行监控。 opik-openclaw 是 OpenClaw 的官方插件,用于把智能体运行数据发送到 Opik。Opik 是开源的 LLM 可观测与评估平台。插件会记录 LLM 请求与响应的 span、子智能体 span、带输入、输出和错误信息的工具调用 span,以及包含用量和成本的运行级元数据。
opik-openclaw 可以免费使用吗?用的什么许可证?
opik-openclaw 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
opik-openclaw 还在维护吗?
活跃维护中。opik-openclaw 最近一次提交是在 2026年10月5日。
opik-openclaw 适合用来做什么?
监控 OpenClaw 智能体的成本与 Token 消耗。 排查多步智能体运行中失败的工具调用。 在同一条会话 trace 中查看子智能体的执行过程。
opik-openclaw 怎么安装和运行?
在 OpenClaw 中安装插件: openclaw plugins install clawhub:@opik/opik-openclaw 使用设置向导配置插件: openclaw opik configure 启动网关并发送测试消息: openclaw gateway run
在哪里获取 opik-openclaw?
源代码和安装说明在 GitHub 上:https://github.com/comet-ml/opik-openclaw

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目