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 会话不会变成
0token 显示。 - 当会话固定到与配置主模型不同的模型时,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 状态。
相关¶
- CLI 参考
- Doctor
openclaw health— 通过 RPC 的 Gateway 健康快照
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw