Darkhunt 观测性

了解你的 OpenClaw 代理实际执行的操作。告别黑箱。

此插件将实时遥测数据发送至 Darkhunt 观测性，让你可以以追踪形式查看每次代理运行的全过程——包括代理的决策过程、调用的工具、每一步耗时以及成本详情。

你将获得

• 完整的对话追踪：以连续时间线形式展示代理执行的每一步操作，包括大模型调用、工具执行和消息流转
• 工具可见性：明确显示调用了哪些工具、传入了哪些参数、执行结果是成功还是失败
• 用户归属信息：可识别每次对话是由哪个用户触发的
• 多代理支持：每个会话的追踪相互隔离，即使多个代理并发运行也不会混淆
• 成本追踪：精确掌握每次对话的成本，按模型调用进行细分
• Token 使用情况：每次生成的输入、输出、缓存读取和缓存创建所使用的 token 数量
• 性能计时：每一步操作的持续时间，以及大模型响应的首次 token 延迟

设置方法

设置仅需 2 分钟：

1. 安装该插件
2. 运行 openclaw tracehub setup
3. 重启网关

向导将引导你完成与 Darkhunt 的连接配置——只需粘贴你的 API 密钥和工作区 ID 即可。

命令

openclaw tracehub setup    # 交互式设置向导
openclaw tracehub status   # 显示当前配置和状态
openclaw tracehub config   # 以 JSON 格式显示原始插件配置

隐私与数据控制

通过三种数据导出模式控制离开你环境的数据内容：

• metadata（默认）—— 仅导出结构化数据：模型名称、token 数量、成本、持续时间、工具名称、执行成功/失败状态。不导出任何对话内容。
• debug —— metadata + 截断后的对话内容（最多 500 字符）。适用于故障排查。
• full —— 包含完整对话内容，但受大小限制（每字段最多 4 KB，每跨度最多 64 KB）。仅在信任目标接收端时使用。

注意事项

• 免费套餐可在 https://darkhunt.ai 获取
• 支持通过 OTLP/protobuf 格式导出（兼容任意 OpenTelemetry 兼容后端）
• 不会引发代理崩溃——所有导出错误均会被捕获并记录