SuperAPI AI 工具集

opik-openclaw-observability

部署与运维

查看项目

更新于 10-16 07:27

技能介绍

用途:@opik/opik-openclaw 是 OpenClaw AI 智能体的官方插件,为其添加原生 Opik 可观测性,自动追踪 LLM 请求/响应、子智能体生成与生命周期、工具调用(输入、输出、错误、耗时)、运行级收尾元数据以及成本与 token 用量,追踪数据导出到 Comet 的开源 LLM 可观测平台 Opik,用于可视化、调试和评估。

主要能力:自动生成 LLM Span(模型名、提示词、参数、补全、token、成本、耗时)、工具 Span、子智能体 Span,并在 agent_end 时收尾所有待处理 Span;支持自定义标签、多项目切换、自托管 Opik 端点。

使用方式:前置要求 OpenClaw >=2026.3.2、Node.js >=22.12.0、npm >=10。安装:openclaw plugins install clawhub:@opik/opik-openclaw(2026.3.23 及以上)或 openclaw plugins install @opik/opik-openclaw(旧版本),安装后重启 OpenClaw Gateway。配置可运行 openclaw opik configure 向导,或用 openclaw opik status 检查;也可在 openclaw.json 中手动配置 apiKey、apiUrl、projectName、workspaceName、tags 等,并需在 plugins.allow 中加入 opik-openclaw、开启 hooks.allowConversationAccess。敏感凭据可用环境变量 OPIK_API_KEY、OPIK_URL_OVERRIDE、OPIK_PROJECT_NAME、OPIK_WORKSPACE,环境变量优先于配置文件。配置完成后追踪自动生效,启动 openclaw gateway run 并发送消息即可在 Opik 项目面板查看。

适用场景:生产智能体的成本追踪、开发/预发/生产多环境隔离、自托管 Opik 的本地实验、错误 Span 监控。

限制:需显式信任社区插件;远程 Gateway 需在网关主机安装并配置;追踪不出现时可检查状态、API Key 与网关日志;陈旧追踪可通过 staleTraceCleanupEnabled 等参数自动清理。具体收费与价格资料暂未提供。