跳转至

openclaw status

通道与会话的诊断。

任务计数和审计总计使用只读元数据摘要。保留的任务负载和投递历史不会为每个状态请求加载,重叠请求共享待处理摘要读取。数据库操作在共享 SQLite 工作进程上运行;实时任务所有权仍由 Gateway 检查。这些摘要不是完整的物理数据库完整性检查。完整注册表恢复和 Doctor 保留其完整性验证。

openclaw status
openclaw status --all
openclaw status --deep
openclaw status --usage
openclaw status --all --usage
openclaw status --usage --agent work
标志 说明
--all 完整诊断(只读,可粘贴)。包含安全审计、插件兼容性和内存向量检查。
--deep 请求通道健康状态(在受支持时执行实时检查)。同时启用安全审计。
--usage 以 X% left 形式打印归一化的提供商用量窗口。
--agent <id> 为 --usage 选择代理身份验证/配置文件范围。当显式多代理集群没有默认值时必填。
--json 机器可读输出。
--timeout <ms> 检查超时时间(毫秒,默认:60000)。
--verbose / --debug 在报告之前还打印原始的 Gateway 目标解析结果。

status 在命令开始时启动一个单调检查截止时间。本地就绪状态、Gateway 状态、提供商用量和深度健康检查消耗剩余配额。远程目标和显式 Gateway URL 跳过本地就绪状态,但保留相同截止时间。本地检查在等待期间报告观察到的启动阶段。如果预算耗尽时 Gateway 仍在启动,status 会报告“仍在启动”而不是不可达,并跳过深度通道检查。JSON 保留状态报告,并添加 gateway.readiness: "still-starting" 和 gateway.startupPhase。显式 --timeout 会限制该共享配额。

当不存在匹配的 Gateway 服务或实时前台所有者,且其端口空闲时,status 会直接检查,而不是等待 Gateway 启动。因此,仅本地代理环境会及时报告 Gateway 不可用。被明确识别为其他进程的监听器会报告端口冲突并提供诊断指导,而不是等待就绪预算。未知监听器归属保留启动宽限期。观察到的启动迁移在移交到 Gateway 所有权时保留启动宽限期;无法验证的所有权也保留该宽限期。锁和原生进程检查消耗相同的剩余检查配额。

没有检查的通道(例如 WhatsApp)改为报告生命周期健康状态。在 Health 表中,healthy 为 OK;降级的生命周期状态和失败的检查仍为 WARN。生命周期 OK 并不意味着执行了实时检查。

Update run 行保留最后记录的更新结果。当本地 Gateway 通过当前就绪检查和连接检查,且其服务版本与记录的更新目标匹配时,之前的失败会被标记为历史:Last update run failed (post-update-failed) — Gateway is serving 2026.9.7; run openclaw update to clear the record. 当目标和实时检查都公开构建 ID 时,构建 ID 也必须匹配。健康的旧版本、不同的构建或未知身份会保留警告及其记录的失败详情,并在已知时包含服务版本和目标版本。回滚和恢复观察本身无法确定预期的候选身份。当无法验证预期候选构建时,同版本回滚仍会保持警告。status 不会重写失败的运行,也不会声称更新成功。启动中、不可达、降级和远程 Gateway 不符合此说明的条件。使用 openclaw update status 检查已保存的验证失败。

--deep 还会询问正在运行的 Gateway,其仍持有的 Node 可执行文件是否可以启动。Homebrew 升级可能会删除该 Cellar 路径,而 LaunchAgent plist 仍指向有效符号链接,且 Gateway 端口保持可达。此时 status 会发出警告:

Gateway runtime is stale after Node upgrade: child workers are using <path>, which no longer exists. Restart the Gateway.

该检查不会重启 Gateway。警告后请运行 openclaw gateway restart。当旧可执行文件消失时,Exec 和 stdio MCP 命令中继可以使用稳定的 Homebrew Node 路径。需要 Gateway 精确运行时的工作进程仍需要重启;supervisor 或 broker 启动失败会报告相同警告。

--deep 和 --all 还会显示死信消息和受压入站通道的投递队列警告。即使通道连接健康,这些警告也包含待处理、已声明和阻塞的消息计数。参见 队列警告。

普通的 openclaw status 保持在快速只读路径上,当跳过内存检查时,将内存标记为 not checked 而不是不可用。重量级安全审计、插件兼容性和内存向量检查留给 openclaw status --all、openclaw status --deep、openclaw security audit 和 openclaw memory status --deep。

本地代理所有权检查从一个一致的 SQLite 快照读取架构和所有者元数据,包括已提交的 WAL 更改。除非其日志状态需要私有恢复,否则不会复制整个代理数据库。启动和迁移就绪检查保留其完整验证。

CLI 在独立进程中运行,并通过 WebSocket 联系 Gateway,即使目标为本地回环地址也是如此。--timeout 为检查设置上限,而不是整个 status 命令。冷设备令牌 worker 初始化发生在请求准备期间,早于 RPC 超时开始;连接令牌读取保持新鲜。比较 openclaw gateway call status --json 与 openclaw status --json,以区分 Gateway 响应和本地报告收集。Gateway Prometheus RPC 计时 不包括 CLI 启动和连接建立;缓慢的 CLI 可以在没有缓慢 Gateway 处理程序的情况下完成。

当 Gateway 可访问且已授权时,status --json 使用其状态投影,而不是在本地扫描每个 agent 的插件元数据和数据库所有权。Gateway 提供会话计数、心跳和任务状态、运行时关键指标以及 agent 名册事实。该请求保留 operator.read 作用域,包括对会话路径、最近会话、模型默认值和详细准入拒绝的脱敏。在 Gateway 填充物理会话存储后,干净的重复状态读取会复用其常驻物化会话行;只有拓扑变化以及脏的或缺失的精确标识才会回退到现有的只读 SQLite 路径。

JSON 中的 collection.notCollected 会列出未检查的字段并解释原因。在线状态将工作区和 bootstrap 检查保留为未知,包括 agents.bootstrapPendingCount: null。它在不加载 channel 插件的情况下返回 channelSummary: [],并将 channelSummary 记录到 collection.notCollected 中。那里的空列表表示该字段未被收集,而不是没有配置任何 channel。使用 openclaw channels status 查看已配置清单,或使用 openclaw channels status --probe 进行实时账户检查。在线状态会跳过本地配置验证、channel 和 memory 凭据检查,以及通常由 --all 或 --deep 请求的本地插件检查。请求的安全审计和插件兼容性部分报告 collected: false;memory 保持为 null。使用 openclaw security audit、openclaw plugins inspect --all 或 openclaw memory status --deep 执行这些本地检查。--deep 仍会请求 Gateway 健康状态,并且 --usage --agent <id> 保留其凭据作用域。当 Gateway 不可用时,JSON 状态保留本地诊断信息。

对于 Git 安装,普通 status 会比较缓存的远程跟踪引用,而不执行网络 fetch。如果最近一次记录的更新 fetch 失败,并且之后没有更新运行记录一次已完成的 fetch,则 Update 行会显示 update check stale: last update fetch failed 5m ago (network error),而不是 up to date,ahead/behind 计数会标记为 cached。JSON 在 update.git.stale 下公开此信息(reason、failedAtMs、detail 和 runId),并将 update.git.countsCached 设置为 true。如果没有记录的 fetch 失败,则通常的缓存比较保持不变。该历史属于当前状态目录。之后一次完成 fetch 的运行会清除该警告,即使该更新的其余部分被跳过、失败或回滚。手动 git fetch 不会清除已记录的警告。使用 openclaw update status 获取新的检查和最后一次更新运行,或再次运行 openclaw update。openclaw status --deep 也会为该检查执行 fetch;它不会更改台账。参见 发布渠道。

状态计时

使用现有的诊断时间线来定位 Gateway RPC 之外花费的时间:

OPENCLAW_DIAGNOSTICS=timeline \
OPENCLAW_DIAGNOSTICS_TIMELINE_PATH=/tmp/openclaw-status-timeline.jsonl \
  openclaw status --json

时间线包括配置和密钥解析、agent 准入、本地会话读取、Gateway 检查和摘要收集。持续时间包括等待;并行阶段会重叠,不应相加。

技能诊断

status --all 会报告 Skills 行中所示工作区的符合条件的技能以及缺少前置条件的技能。缺少前置条件使用与 openclaw skills check 相同的类别:有意禁用的技能和被捆绑 allowlist 阻止的技能会被排除;agent allowlist 排除项保持独立。未满足的 OS 要求包含在此计数中,尽管 Doctor 不会因 OS 不兼容而禁用技能。使用 openclaw skills check --agent <id> 检查缺失的要求。

会话和模型解析

  • 会话状态输出将 Execution: 与 Runtime: 分开。Execution 是沙箱路径(direct、docker/*),而 Runtime 告诉你会话是否使用 OpenClaw Default、OpenAI Codex、CLI 后端或 ACP 后端,例如 codex (acp/acpx)。有关 provider/model/runtime 的区别,参见 Agent 运行时。
  • /status 聊天命令显示 Endpoint:来自用于选择路由的同一已准备 model/auth 决策的上游基础 URL。它 描述当前选择,而不是之前的请求或计费归属。 该 URL 是 API 基础地址;传输层在发送请求时会添加操作路径,例如 /responses。 未解析端点的路由显示 unknown。显示的 URL 会省略 用户信息、查询参数和片段;自定义路径会被隐藏。
  • 当当前会话快照稀疏时,/status 聊天命令(参见 斜杠命令)可以从最近的 transcript 使用日志回填 token 和缓存计数器。现有的非零实时值仍 优先于 transcript 回退值。
  • 当实时会话条目缺少活动运行时模型标签时,Transcript 回退还可以恢复该标签。如果该 transcript 模型与所选模型不同,status 会针对恢复的运行时模型而不是所选模型解析上下文窗口。
  • 对于 prompt 大小核算,当会话元数据缺失或较小时,transcript 回退会优先选择较大的面向 prompt 的总计,因此自定义 provider 会话不会变成 0 token 显示。
  • 当会话固定到与配置主模型不同的模型时,status 会打印两个值、原因(session override)以及提示 /model default。配置的主模型适用于新会话或未固定会话;现有固定会话会保留其会话选择,直到清除。
  • 当配置了多个 agent 时,输出包括每个 agent 的会话存储。
  • Fleet 状态无需 System Agent 所有者即可工作。待处理事件包括每个 agent 的主队列;共享全局队列只计算一次。--agent 仅为 --usage 选择凭据。

使用与配额

  • --usage 以 X% left 形式打印规范化后的提供商使用窗口。 它还会将使用快照添加到 --all;--agent 保持相同的使用范围。 使用检查会接收剩余的共享检查预算,并在设置 --timeout 时受其上限约束; 超过该限制的提供商会在使用输出中报告 Timeout。 预算耗尽时会报告 Timeout,而不会启动提供商身份验证或使用请求。 超时会取消正在进行的使用请求,并防止迟到的身份验证结果 启动另一个请求;已完成的提供商快照仍可用。
  • 在显式多智能体配置中,--usage 默认读取由 agents.defaults.systemAgent.agentId 拥有的身份验证配置文件。传入 --agent <id> 可 检查另一个智能体;如果没有任一所有者,OpenClaw 不会从模糊的名册中猜测某个 智能体的凭据。
  • MiniMax 的原始 usage_percent / usagePercent 字段表示剩余配额, 因此 OpenClaw 在显示前会反转它们;如果存在基于计数的字段,则优先使用 基于计数的字段。model_remains 响应优先选择聊天模型条目,在需要时从时间戳推导 窗口标签,并在计划标签中包含模型名称。
  • 模型定价刷新失败会显示为可选定价警告。 它们并不意味着 Gateway 或通道不健康。

概览与更新状态

Gateway 服务行将其已安装的包与活动 CLI 进行比较。 如果它们解析到不同的安装,status 会同时列出两个包路径和 版本。当允许服务安装时,它会建议运行 openclaw doctor --fix 或 openclaw gateway install --force, 或者报告安装所有者的拒绝。 当 Gateway 连接失败时,包括协议不匹配,此本地诊断仍可用。 JSON 将该比较暴露为 gatewayService.installationDrift。 如果本地会话状态需要 Doctor,status 会将任何安装漂移连同原始错误一起打印到 stderr,并保留失败退出状态。

  • 会话 概览统计已存储的会话行,包括已归档 行。正在运行的轮次和最近活动与此清单分开。
  • 概览在可用时包括 Gateway + 节点主机服务安装/运行时状态, 以及简明的 Gateway 进程正常运行时间和主机系统正常运行时间。
  • status --all 在 Gateway 自身 中显示返回的主机、IP、版本和平台。 仅当这些字段不可用时才使用 unknown。
  • 在 Linux 上,当服务管理器不可用时,可读的已安装节点服务仍会列出;其运行时状态保持未知。
  • 概览包括更新通道 + git SHA(用于源代码检出)。
  • 更新信息显示在概览中;如果有可用更新,status 会打印运行 openclaw update 的提示(参见 更新)。
  • status 和 status --all 在 更新 中保留当前可用性,并在 更新运行 中单独显示 活动或最近的更新历史。除非它命名了相同的运行 ID,否则单独的 更新重启 报告仍可见。
  • status --all 包括 遥测导出器 诊断,包含最新的 受信任的按信号导出器状态和传输。端点值、标头、 证书、有效负载和原始错误不会显示。

密钥

  • 当正在运行的 Gateway 在启动、重新加载或配置写入时存在任何隔离的 SecretRef 所有者时,status 会在 JSON 中包含 degradedSecretOwners,并在人类可读输出中包含一行 降级密钥 概览。每个条目会指明所有者、降级状态(cold 或 stale)、配置路径以及已脱敏的原因。cold 所有者不可用;stale 所有者继续使用最后已知良好值。
  • 只读 status 界面(status、status --json、status --all) 在可能时解析其目标配置路径所支持的 SecretRef。
  • 如果已配置受支持的通道 SecretRef,但在当前命令路径中不可用,status 会保持只读并报告降级输出, 而不是崩溃。人类可读输出会显示诸如“已配置 token 在此命令路径中不可用”之类的警告,JSON 输出包括 secretDiagnostics。
  • 当命令本地 SecretRef 解析成功时,status 会优先使用 已解析快照,并从最终输出中清除瞬时的“secret 不可用”通道 标记。
  • status --all 包括一行密钥概览和一个诊断部分, 该部分会汇总密钥诊断信息(为便于阅读而截断),而不会 停止报告生成。

内存

status --json --all 报告来自活动内存插件 运行时(由 plugins.slots.memory 选择)的内存详细信息。自定义内存插件可以保持 内置 memory.search.enabled 禁用,并仍然报告 它们自己的文件、块、向量和 FTS 状态。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw