OpenClaw 的 Latitude 可观测性支持

[Latitude](https://latitude.so) 是一个开源的 LLM 可观测性与评估平台。它能够接收 OpenTelemetry 跟踪数据，使 OpenClaw 的活动以跨度（spans）的形式呈现，您可以在其中进行查看、搜索和评估，并在跟踪的每一层级上聚合 token 使用量、成本和延迟信息。

OpenClaw 已通过内置的 diagnostics-otel 插件导出 OTLP/HTTP protobuf 格式的数据。本技能将该导出器配置为向 Latitude 发送追踪数据，无需额外安装代码。

适用场景

当您希望 OpenClaw 的模型调用、运行、工具调用和消息跨度能够进入 Latitude，或有人询问如何将 OpenClaw 的遥测数据接入 Latitude 时，可使用此功能。

前置条件

• 一个 Latitude 账户及 API 密钥。注册请访问 [console.latitude.so](https://console.latitude.so/login)，或选择自托管。
• 一个 Latitude 项目标识符（slug）。
• 在环境变量中设置凭证：

export LATITUDE_API_KEY=<your-api-key>
export LATITUDE_PROJECT=<your-project-slug>

配置方法

启用 diagnostics-otel 插件，并将 diagnostics.otel 指向 Latitude 的数据摄入端点，使用两个头部进行身份验证。将以下内容添加至您的 OpenClaw 配置文件（~/.openclaw/openclaw.json）：

{
  plugins: {
    allow: ["diagnostics-otel"],
    entries: {
      "diagnostics-otel": { enabled: true },
    },
  },
  diagnostics: {
    enabled: true,
    otel: {
      enabled: true,
      endpoint: "https://ingest.latitude.so",
      protocol: "http/protobuf",
      serviceName: "openclaw-gateway",
      headers: {
        Authorization: "Bearer ${LATITUDE_API_KEY}",
        "X-Latitude-Project": "${LATITUDE_PROJECT}",
      },
      traces: true,
      metrics: false,
      logs: false,
    },
  },
}

对于打包安装版本，请先安装插件：

openclaw plugins install clawhub:@openclaw/diagnostics-otel

注意事项

• OpenClaw 会自动在基础 endpoint 后追加 /v1/traces，因此请将 endpoint 设置为 https://ingest.latitude.so（不包含路径）。若自托管 Latitude，请指向您自己的数据摄入主机。
• protocol 必须设置为 http/protobuf。目前 OpenClaw 忽略 grpc，而 Latitude 仅支持接收 OTLP/HTTP protobuf 格式。
• Latitude 接收 OTLP 跟踪数据，因此本配置关闭了 metrics 和 logs。如需处理这些信号，请将其路由至独立的指标或日志后端。
• 默认情况下不会导出原始提示和响应内容。仅在符合保留策略的前提下，才启用 diagnostics.otel.captureContent.*。

验证

运行一次调用模型和工具的 OpenClaw 代理回合，然后打开 [Latitude 控制台](https://console.latitude.so/login)。您应能看到一条包含嵌套跨度的跟踪记录，涵盖运行、模型调用和工具调用，且每条跟踪均聚合了 token 使用量、成本和延迟信息。