使用遥测与更新检查

默认情况下，自动更新检查每天发送一次请求。 它会询问是否存在更新版本，并包含 OpenClaw 版本、操作系统、Node.js 版本、CPU 架构和请求来源。 匿名功能统计采用选择加入机制。 本页描述的是更新检查遥测，而非由已配置的提供者、渠道或其他服务发出的请求。

匿名功能统计描述已配置的渠道和提供者、插件清单以及保留的会话创建计数。它们默认关闭。启用后，它们会随同每日更新检查一起发送，而不会额外增加一次请求。

这些报告有助于确定维护优先级。它们不衡量单个插件调用、消息、模型请求或活跃用户。匿名使用聚合数据可在 telemetry.openclaw.ai 查看。

拒绝是完全正常的选择，不会改变 OpenClaw 对你的工作方式。

检查发送的内容¶

在更改偏好设置之前或之后，运行以下命令：

openclaw telemetry show

添加 --json 可以以机器可读文档的形式获得相同的状态和负载。

输出显示匿名功能统计是否已启用、启用或禁用的原因、请求端点和最后一次成功的检查。当匿名功能统计启用时，它会打印由 CLI 进程构建的 JSON 负载预览。它不会从正在运行的 Gateway 检索负载。当仅匿名功能统计被禁用时，它会显示仅更新请求及其 User-Agent 头。当自动化或更新检查策略禁用所有请求时，它会显示 Request: none 及原因（JSON 中为 request: null）。预览只描述客户端请求，无法显示由服务器推导出的位置信息。

每日更新检查¶

默认请求为：

GET https://telemetry.openclaw.ai/api/latest-version
User-Agent: openclaw/2026.8.2 (darwin; node/26.0.1; arm64; gateway)

User-Agent 包含 OpenClaw 版本、操作系统、Node.js 版本、CPU 架构，以及请求来自 Gateway 还是 CLI。它没有请求体、安装标识符、机器标识符或随机跟踪标识符。

服务会响应最新版本，并可选地附带一条面向操作员的简短说明。OpenClaw 通过现有的更新通知显示可用更新及其说明。无法访问的服务、超时、过大或无效的响应以及其他失败的检查不会中断启动或正常操作。

成功的响应及其时间戳会缓存到现有的共享状态数据库中。启动时会在接下来的 24 小时内复用缓存结果；正在运行的 Gateway 会在正常维护期间再次检查，并带有少量随机延迟。失败的检查不计入成功的每日检查。

对于测试或自托管，请将 OPENCLAW_TELEMETRY_ENDPOINT 设置为完整的替代端点 URL。公共服务器源代码可在 openclaw/telemetry 获取。

近似位置¶

Cloudflare 提供近似位置信息：国家/地区、地区代码、城市和时区。我们不会在分析数据中存储原始 IP 地址或精确坐标。

即使匿名功能统计关闭或设置了 DO_NOT_TRACK，记录的更新检查也会包含这些字段。缺失或无效的字段将保持为空。无需额外的客户端负载或提示。

Analytics Engine 会将记录保留三个月。公共聚合数据不包含位置信息。禁用请求不会删除已有的记录。

本节描述的是托管服务 telemetry.openclaw.ai。通过 OPENCLAW_TELEMETRY_ENDPOINT 配置的替代端点可以使用不同的基础设施以及处理或存储策略。

可选的匿名功能统计¶

匿名功能统计默认关闭。交互式设置可能会提供一次性选择加入的选项，并默认选中不，谢谢；引导式快速入门会跳过该提示。OpenClaw 会记录提示响应，因此设置不会再次询问。非交互式和脚本化安装不会自动选择加入，但操作员可以通过 openclaw telemetry on 或 telemetry.enabled: true 显式启用匿名功能统计。控制是否包含匿名功能统计的是启用设置，而不是是否存在提示响应。

当您显式启用匿名功能统计时，同一个每日请求将变为 POST，其 JSON 负载格式如下（值为示例）：

{
  "schema": 1,
  "version": "2026.8.2",
  "platform": "darwin-arm64",
  "node": "26.0.1",
  "surface": "gateway",
  "features": {
    "channels": ["discord", "telegram"],
    "providerFamilies": ["anthropic", "openai"],
    "plugins": ["codex", "diagnostics-otel"],
    "pluginsEnabled": 9,
    "sessionsLast24h": 14
  }
}

在活动插件注册表存在的情况下，清单包含已启用、已加载且其代码已被导入的插件，以及已加载的捆绑格式插件。如果没有该注册表，则回退为根据配置的清单启用状态。这两种路径都不会记录插件是否被调用，或某个已配置的渠道或提供程序是否处理了工作。

被命名的插件必须是捆绑的、受信任的官方安装，或与官方插件目录匹配。私有插件标识不会被命名。名称还会经过过滤和去重，并且服务会独立验证它们。因此，features.pluginsEnabled 与所报告名称数量之间的差值并不能可靠地反映私有插件的数量。

会话数量取决于仍保留在有限事件存储中的本地记录的创建事件。状态缺失或不可读时计为零。它不是活跃会话、消息或当天存在的所有会话的数量。

发送方和 openclaw telemetry show 使用相同的载荷构建器，但它们的插件注册表、配置和收集时间可能不同。CLI 预览并不保证下一个 Gateway 载荷的确切内容。

报告不包含用户、账户、安装或设备标识符。重复的报告并非唯一的安装或用户。服务不会维护每次安装的历史记录或保留措施。

不会发送或存储的内容¶

无论是更新检查的 User-Agent，还是包含匿名功能统计信息的主体，都不包含消息内容、提示词、模型名称、API 密钥、凭据、机密引用、文件路径、主机名、账户标识符、用户标识符，以及安装和机器标识符。OpenClaw 不会为这些请求创建随机 UUID 或其他持久性客户端标识符。

托管服务的 Analytics Engine 数据行不包含上述直接标识符以及原始客户端 IP 地址、坐标、邮政编码和物理设备硬件详细信息。Cloudflare 会处理连接 IP 地址，Worker 仅将其临时用于速率限制，而不会存储在 Analytics Engine 中。Worker 日志已禁用；Cloudflare 独立的基础设施处理不受这些设置约束。

匿名功能统计信息与可选的、由操作员配置的 OpenTelemetry 导出 相互独立。

开启或关闭匿名功能统计信息¶

随时启用或禁用匿名功能统计信息：

openclaw telemetry on
openclaw telemetry off

你也可以直接配置相同的偏好设置：

{
  telemetry: {
    enabled: false,
  },
}

设置 DO_NOT_TRACK=1 或 DO_NOT_TRACK=true 可强制关闭匿名功能统计信息，即使 telemetry.enabled 为 true 也是如此。DO_NOT_TRACK 不会禁用每日更新检查：OpenClaw 会发送仅更新的 GET 请求，且请求体不包含匿名功能统计信息。

自动化环境¶

当 OpenClaw 检测到自动化环境时（即 CI 环境变量被设置为真值），不会发送任何内容。持续集成作业不是安装：它们的数量会超过真实操作者多个数量级，使版本和平台计数失去意义，而且你的流水线不应在每次作业时都向我们上报。

这适用于两种层级，因此 CI 作业不会发送更新检查，也不会发送匿名功能统计信息。设置 OPENCLAW_TELEMETRY_ENDPOINT 会覆盖此抑制行为，因为配置了端点即表示本次运行是在有意执行此路径。

禁用所有自动更新请求¶

要实现完全静默，请禁用现有的启动更新检查：

{
  update: {
    checkOnStart: false,
  },
}

这会停止两种层级和所有自动更新请求：不再有更新请求、匿名功能统计信息或更新通知，即使 update.auto.enabled 为 true 也是如此。设置 OPENCLAW_NO_AUTO_UPDATE=1 同样会阻止自动更新请求。当你选择运行时，显式更新命令仍然可用。

有关完整的 telemetry 配置，请参阅 配置参考；有关自动更新检查控件，请参阅 更新配置。