跳转至

openclaw triage

收集已脱敏的诊断信息,并在本机打开一个编码代理,以诊断、修复并验证此 OpenClaw 安装。

openclaw triage

在交互式终端中,triage 会按以下检测顺序启动 PATH 上第一个可直接启动的代理:Codex(codex)、Claude Code(claude)、Pi(pi)、OpenCode(opencode)、Muse Code(muse)、Grok Build(grok)、Cursor(cursor-agent)、Kimi Code(kimi)、Qwen Code(qwen),然后是 Google Antigravity CLI(agy)。当 Codex 和 Claude Code 均可用时,除非你使用 --agent 选择代理,否则 Codex 优先。显式调用 openclaw triage 会打印所选代理,并直接传递一个有界修复提示,不经过选择器或启动确认。该代理使用其现有身份验证和原生执行策略。

Google Antigravity CLI 使用 agy --prompt-interactive 以修复提示启动并保持会话打开。请先安装并登录官方 CLI。triage 使用 Antigravity 的现有身份验证和权限设置;它不会导入 Google 凭据或绕过工具审批。

选择 Cursor 时使用 --agent cursor,并且需要 Cursor 的 CLI 安装程序安装的 cursor-agent 别名。triage 不使用 cursor 编辑器命令,也不使用通用 agent 别名,Grok 也会安装该别名。

Kimi Code 使用 kimi --prompt 执行单个修复回合。其原生提示模式使用自动权限,无需审批提示;triage 会在启动或手动交接前打印此策略。Kimi Code 未提供交互式初始提示标志。Qwen Code 使用 qwen --prompt-interactive 以修复提示启动并保持交互式会话打开,包括其常规工具审批。

当受支持时,Claude Code 会以 --safe-mode 启动,这会禁用自定义钩子、插件、技能、MCP 服务器和项目指令,同时保留身份验证和内置工具。这可防止项目启动钩子(例如依赖安装)延迟修复提示。当已安装的 CLI 未声明支持 safe-mode 时,triage 会打印通知,并以常规自定义设置运行 claude -p。打印的手动命令也使用 Claude 的常规自定义设置,包括插件和 MCP 服务器。

使用 --agent 选择特定代理,或使用 --json 或 --non-interactive 仅收集诊断信息而不启动代理:

openclaw triage --agent agy
openclaw triage --agent codex
openclaw triage --agent cursor
openclaw triage --agent grok
openclaw triage --agent kimi
openclaw triage --agent muse
openclaw triage --agent qwen
openclaw triage --json
openclaw triage --non-interactive

提示包含 OpenClaw 版本、平台、Node.js 版本、按优先级排序的 Doctor 发现(带修复提示),以及诊断归档路径。归档包含已脱敏的配置、尽力而为的 Gateway 状态和健康快照、操作日志摘要以及可用的稳定性诊断。如果 Gateway 不可达,triage 仍会写入包含可用本地诊断的归档,并在其中记录快照失败。Doctor 或导出失败会记录在提示中,以便代理仍可进行排查。

诊断归档会排除密钥、令牌、原始聊天载荷和原始日志。失败更新提示包含有界且已脱敏的诊断摘录,并在截断前对密钥和本地路径进行脱敏。提示中的路径以相对于 ~ 或 $OPENCLAW_STATE_DIR 的形式显示。保存的提示路径、归档路径以及打印的交接命令会保留 shell 所需的真实绝对路径。诊断信息收集为只读。启动的代理会被要求在其现有权限内自主修复,并保留配置、历史记录和数据库。

归档中的配置摘要统计保存文件中声明的代理、插件和通道条目。共享通道设置和 $include 指令不计入这些统计。诊断信息不会展开包含的文件。

失败更新恢复

在失败更新到达 triage 之前,更新器可能会运行 有界无人值守修复 以处理候选验证失败或激活后验证失败,前提是回滚不安全或失败。这些尝试使用已配置的推理,并显示在更新运行报告中。更新器负责任何服务重启,并根据验证结果判定成功。当恢复无法完成时,triage 仍是交接点。

交互式更新恢复在更新器释放其维护状态后使用相同的交接。它从捕获的更新失败开始。它将新的 Doctor 检查和归档收集推迟给修复代理,因此针对损坏安装的检查不会延迟交接。代理在操作者捕获的工作目录中启动;如果该目录已被删除或变得不可访问,则在其操作系统主目录中启动。绝对安装选择器仍会标识要修复的状态、配置和默认工作区,即使状态目录无法访问或创建。

在自动交互式启动之前,OpenClaw 会显示它将运行的内容。它会显示所选二进制文件,或使用你已配置模型的嵌入式 OpenClaw 代理。如果可用,它还会显示保存的提示路径,以及一条通知,说明它使用你自己的账户或令牌。然后 OpenClaw 会请求确认。只有肯定的 Yes 才会启动代理。按 Enter、n、取消,或 30 秒内无响应都会跳过启动,打印所选代理的一个手动下一步,并保留诊断信息和失败更新的退出状态。若要选择另一个外部代理,请运行 openclaw triage --agent codex 或其他受支持的 --agent 值。这取代了之前超时视为 Yes 的默认行为;显式独立 triage 和无人值守自有恢复保持其现有行为。

提示会保留原始错误、更新前后版本以及记录在案的恢复状态,并优先于当前 Doctor 发现。它最多包含三个失败或中断的步骤,排除建议性 Doctor 结果,并包含来自 stderr 和 stdout 的有界摘录。它还会保留有界的插件失败和终端 Doctor 警告。失败记录限制为 4 KiB,整个提示限制为 8 KiB。健康的 Doctor 检查不会清除失败尝试,缺失的重启安全性判定仍保持未知。

使用 --yes、JSON 输出或非交互式会话的更新,在符合条件的变更或重启失败后,可以启动一次由所属方管理的自动修复,如下所述。其他失败会报告其正在准备 triage 诊断,并保留一个人工后续步骤;它们不会声称已启动修复代理。初始参数、所有权和安装拒绝仍不属于自动修复范围。对于无法接纳由所属方管理的恢复的后台或 Control UI 失败,请使用 Gateway 主机上打印的特定于该安装的命令,或在那里运行 openclaw triage。独立诊断会将待处理的更新失败通知保留为上下文。嵌入式验证通过解析所有者选择当前账本历史。这些读取不会消费该通知或创建状态数据库。投递路由和继续指令被排除。

使用 --update-result <path> 包含更新器保存的失败工件。Triage 最多读取 8 KiB 的有效 UTF-8 JSON,并验证失败记录。其打印的嵌入式交接命令使用经过清理的支持导出,因此在临时更新器输入被删除后仍可使用。带有已捕获失败的交互式交接会推迟新的诊断。JSON 和强制非交互式运行仍会收集它们。

修复提示指示代理保留已迁移的状态,在回滚或重启之前进行调查,并在修复后验证目标安装以及 Gateway 健康状况和 RPC 连接性。代理成功退出不会将原始更新器失败变为更新成功。

安装目标与嵌入式交接

Triage 会捕获被诊断安装的已解析状态目录、精确配置路径和默认工作区,包括自定义路径和命名配置文件。本地 shell 命令会以 OPENCLAW_STATE_DIR、OPENCLAW_CONFIG_PATH 和 OPENCLAW_WORKSPACE_DIR 接收这些值。因此,归档引用和默认工作区检查会针对被诊断的安装进行解析,即使其选择器是隐式的。安装配置中显式编写的工作区仍优先于其默认工作区。嵌入式代理将其自身的配置快照、会话、执行 cwd 和临时运行状态保持分离。进程内配置和会话工具引用该临时运行。使用本地 shell 命令检查或修复被诊断的安装。

openclaw triage --run 在交互式终端中请求至多一次有界的嵌入式修复轮次。推理使用 system-agent 所有者的默认模型,然后使用其配置的 model.fallbacks,再使用其他已配置代理的已认证路由。明确不支持工具的模型以及没有可用认证的路由会被跳过。如果没有可用路由,triage 会报告嵌入式修复不可用。使用已保存的交接命令,或使用 openclaw onboard 修复模型配置。

对于独立安装 triage,循环会在轮次前后运行 Doctor lint,并使用错误发现数量来衡量改进。初始健康的安装会打印 already resolved,而不启动推理。Triage 允许一轮、总计十分钟、轮次五分钟以及 40 次工具调用。轮次后出现更多错误发现会将安装报告为未修复。

对于已记录的更新失败(包括 Doctor 最终化),干净的 Doctor lint 并不足够。Triage 要求一个已完成的更新器结果,并验证已安装的包或 Git 运行时、Doctor 发现以及受管 Gateway 的安装和就绪状态。显式提供的失败工件会针对其记录的目标保持严格检查。普通 triage 接受之后到相同或更新版本的更新成功,并验证该当前完成项的安装,因此历史失败不会将安装固定到旧版本。插件失败还要求插件健康。之后经过验证的回滚到相同或更新版本也会保留该恢复:普通 triage 会检查回滚运行自身的先前身份和恢复身份、记录的包恢复以及当前安装。显式工件仍要求回滚到其原始版本。Triage 会保留历史失败运行;它从不将失败结果中幸存的 after.version 视为请求的目标。

包更新会记录其已解析的注册表版本。Git 更新会在目标检查期间记录所选 commit 和可用的 manifest 版本,早于候选验证或激活。Triage 可以使用任一已记录身份验证 Git 目标;它会检查所有存在的身份。仅包含 dev/latest 等通道/标签选择器的旧版 Git 记录不会确立已解析目标。

普通 triage --run 会通过解析所有者验证更新历史,即使没有剩余的重启通知或出现更新的预览。修复确认会清除历史废弃运行的阻塞项,但仍需要新的 Doctor 检查;它们不能隐藏当前配置错误。之后的预览和已确认的废弃运行也不能替代已完成的更新。Doctor/配置失败需要与其他更新失败相同的更新器记录完成。待处理的插件状态迁移保持未解决,并会出现在判定中,直到其迁移所有者记录完成,包括在更新的更新成功之后以及没有剩余重启通知时。

显式 --update-result 工件或没有运行身份或记录目标的待处理通知仍保持 unrepaired,包括 Doctor/配置失败。Triage 会报告其无法确定更新目标,并指导你检查 openclaw update status --json,然后运行 openclaw update repair。对于不相关的更新失败,它从不回退到健康的 Doctor 判定。有意停止或未受管的 Gateway 无法提供受管服务验证。当初始检查证明已解决时,人类输出会显示 already resolved;在修复轮次后,只有当相同检查通过时,它才会显示 repaired。worker 协议保留其现有的 repaired 和 unrepaired 状态。代理成功退出或声称已修复问题并不是已解决的证据。

待处理的包激活还会阻止 triage 报告已解决,即使 Doctor 通过、上次运行成功,且未列出任何恢复集。对于重启后缺失或已更改的交接租约数据库,triage 会引导你在重试更新之前执行 openclaw update repair。请从包含租约恢复修复的 CLI 中运行 repair;较旧的被阻止的 CLI 可能需要该文档中描述的手动安装步骤。如果 triage 对已记录的失败没有解决条件,它会说明这一点,并将 openclaw update repair 指定为下一步。

回合后的 Doctor 检查仅在执行器确认清理完成后运行。如果清理失败或超时,repair 会报告失败,保留执行状态,并拒绝在该 CLI 进程中再次执行 repair。检查诊断信息,并在从新进程重试前停止所有剩余工作。

更新或显式 --run 请求由操作员负责。因此,嵌入式 repair 会用无需提示的运行替代交互式 exec 审批,其范围限定在安装目录或暂存候选根目录(fs.workspaceOnly: true)。它会保留 safe-bin 和工具允许列表。它绝不会覆盖显式的 exec 或 repair-tool 拒绝。它会拒绝已配置的 sandbox、node 和远程执行路由,而不是将它们重定向到主机,也不会启动外部编码代理 CLI。显式拒绝会报告 exec-denied-by-policy。使用 openclaw triage 进行外部交接。已保存的执行策略保持不变。

repair 提示词指示代理仅修改安装目录或暂存候选根目录,并使用固定的 OpenClaw 状态进行诊断。它禁止编辑凭据或身份验证存储、删除状态或数据库、在目标根目录之外进行包管理器写入,以及启动、停止或重启服务或 Gateway。文件系统工具会强制工作区边界。主机命令遵循提示词的范围约定,而不是操作系统沙箱。允许的检査包括 openclaw doctor --lint --json、openclaw doctor --fix 和 openclaw health --json。repair 循环不会激活更新、重启服务、创建快照或撤销文件。

每个回合都被要求以一行机器可读内容结尾:

REPAIR_RESULT: {"status":"fixed","summary":"Repaired the installation and checked Doctor lint."}

状态可以是 fixed、partial 或 not-fixed。如果该行缺失或格式错误,则回退为最终文本的有界摘要。所有者验证仍具有权威性。失败上下文和 repair 指令共享 8 KiB 提示词限制。

在 Windows 上,已识别的 npm .cmd 和 .bat shim 会直接启动其 Node.js 或原生可执行入口点,并保留交互式终端。Node.js 入口点要求正在运行的 Node.js 运行时或 PATH 上的 node.exe。需要 shell 的自定义包装器仍保持为手动交接。如果显式 --agent 缺失或仅限手动,则会以非零状态退出,而不会选择其他代理。

手动交接

非交互式会话会保存诊断信息,而不会启动代理。人类可读输出会为显式选择或首个检测到的编码代理打印一个下一步。如果未检测到编码代理,它会说明如何安装一个并重新运行 triage。需要 shell 的 Windows 包装器仍可作为手动命令使用。JSON 输出会保留所有外部交接命令和显式嵌入式路由。保存的外部提示词从 stdin 读取,或者对于 Grok 和 Muse,使用 --prompt-file 读取。Kimi Code 和 Antigravity CLI 会收到一条简短指令,用于读取保存的提示词,而不是将其通过管道传入 stdin。在 macOS 和 Linux 上,命令如下:

env OPENCLAW_STATE_DIR='<state-dir>' OPENCLAW_CONFIG_PATH='<config-path>' OPENCLAW_WORKSPACE_DIR='<default-workspace-dir>' agy --prompt-interactive 'Read the debugging prompt at <prompt-path> and follow its repair and verification instructions.'
env OPENCLAW_STATE_DIR='<state-dir>' OPENCLAW_CONFIG_PATH='<config-path>' OPENCLAW_WORKSPACE_DIR='<default-workspace-dir>' claude -p < '<prompt-path>'
env OPENCLAW_STATE_DIR='<state-dir>' OPENCLAW_CONFIG_PATH='<config-path>' OPENCLAW_WORKSPACE_DIR='<default-workspace-dir>' codex exec --skip-git-repo-check - < '<prompt-path>'
env OPENCLAW_STATE_DIR='<state-dir>' OPENCLAW_CONFIG_PATH='<config-path>' OPENCLAW_WORKSPACE_DIR='<default-workspace-dir>' cursor-agent --print < '<prompt-path>'
env OPENCLAW_STATE_DIR='<state-dir>' OPENCLAW_CONFIG_PATH='<config-path>' OPENCLAW_WORKSPACE_DIR='<default-workspace-dir>' grok --prompt-file '<prompt-path>'
env OPENCLAW_STATE_DIR='<state-dir>' OPENCLAW_CONFIG_PATH='<config-path>' OPENCLAW_WORKSPACE_DIR='<default-workspace-dir>' kimi --prompt 'Read the debugging prompt at <prompt-path> and follow its repair and verification instructions.'
env OPENCLAW_STATE_DIR='<state-dir>' OPENCLAW_CONFIG_PATH='<config-path>' OPENCLAW_WORKSPACE_DIR='<default-workspace-dir>' muse exec --prompt-file '<prompt-path>'
env OPENCLAW_STATE_DIR='<state-dir>' OPENCLAW_CONFIG_PATH='<config-path>' OPENCLAW_WORKSPACE_DIR='<default-workspace-dir>' opencode run < '<prompt-path>'
env OPENCLAW_STATE_DIR='<state-dir>' OPENCLAW_CONFIG_PATH='<config-path>' OPENCLAW_WORKSPACE_DIR='<default-workspace-dir>' pi --print < '<prompt-path>'
env OPENCLAW_STATE_DIR='<state-dir>' OPENCLAW_CONFIG_PATH='<config-path>' OPENCLAW_WORKSPACE_DIR='<default-workspace-dir>' qwen < '<prompt-path>'
env OPENCLAW_STATE_DIR='<state-dir>' OPENCLAW_CONFIG_PATH='<config-path>' OPENCLAW_WORKSPACE_DIR='<default-workspace-dir>' openclaw triage --run

捕获的更新失败会为嵌入式命令添加 --update-result <saved-failure-path>。外部命令使用其代理的原生工具策略,包括 Kimi Code 的自动权限。Antigravity 的保存命令会启动交互式会话。Triage 不会添加权限覆盖。使用 openclaw triage --agent <name> 启动会话;Kimi Code 仍保持为单次提示词运行。

打印的 Windows 命令面向 PowerShell,包括 Windows PowerShell 5.1。它们以 UTF-8 读取保存的提示词,保留字面路径,并在命令完成后恢复你的安装选择器。WSL 使用 POSIX shell 命令。

JSON 输出还包括 detectedAgents,列出在 PATH 上找到的外部智能体。使用 JSON 输出的独立 triage、非 TTY 会话或 --non-interactive 永远不会启动智能体,即使使用 --agent。Codex 命令可以在 Git 检出之外工作。它不会更改 Codex 沙箱或审批设置。

自动故障移交

已达到安装更改的失败更新、不健康的更新重启以及已记录的 Gateway 服务器启动失败可以自动调用相同的 triage 流程。现有更新结算先运行。恢复要求更新所有者验证重启是安全的。包替换后,已安装的 CLI 负责 triage。不可用或不兼容的 CLI 文件会保留已保存的故障诊断和手动指导。受监督的 Gateway 仅在其现有崩溃循环断路器首次触发时尝试 triage。同一 Gateway 进程中的后续失败不会启动另一个智能体。

自动移交首先选择已配置的嵌入式智能体,否则按顺序选择可直接启动的 Codex 或 Claude Code CLI。外部智能体以非交互方式运行,并使用其现有身份验证和权限。Claude Code 在受支持时使用 --safe-mode 以禁用自定义 hooks、插件和项目说明,同时保留身份验证和内置工具;否则,triage 会打印通知并以正常自定义设置运行 claude -p。找到可执行文件并不建立身份验证。所选路由失败时会报告,而不会尝试另一个智能体。私有提示和手动移交命令仍然可用。

自动嵌入式恢复会保留已配置的运行时,因为它必须调查原始故障,包括 Doctor lint 无法检测的症状。其修复提示可以在需要运行健康验证时允许拥有的原子 Gateway 重启。有意停止的安装保持停止。这与手动 triage --run 不同,后者的 Doctor 验证修复循环从不负责服务生命周期更改。

进程内重启失败后,当前台 triage 完成且清理已确认时,Gateway 会重试启动一次。新的启动会读取修复后的配置并记录其自身的启动结果;仅智能体成功并不能建立恢复。如果 triage 拒绝或不可用,进程保持存活以进行手动恢复。它会记录启动拒绝,包括报告时的问题配置键,并打印后续步骤:修复该拒绝,运行 openclaw doctor --fix,然后使用打印的 kill -USR2 <pid> 命令发送 SIGUSR2。

已接受的 triage 失败或启动重试失败仅在当前运行具有已记录的重生监督者(launchd、systemd、Scheduled Task 或显式外部监督)时以非零退出。未管理的前台运行和没有已记录监督的容器保持存活,并提供相同的手动恢复指导。它们在启动成功之前不会处理请求。在 triage 期间收到的停止会取消恢复并等待清理,而不会启动另一个 Gateway。初始启动拒绝和不安全的启动清理保留其现有退出行为。

Windows 不支持 SIGUSR2。修复拒绝后,使用 openclaw gateway restart 重启 Scheduled Task Gateway。对于未管理的前台运行,按 Ctrl+C 并重新运行原始 Gateway 命令。具有显式外部监督的运行会引导你使用该监督者的重启工作流。进程会打印适用的说明。

有针对性的自动 Codex 修复需要一个拥有的 stdio app-server 进程。Unix-socket 和 WebSocket 连接会被拒绝。套接字服务器具有独立的生命周期,断开连接不会停止其活动轮次。WebSocket URL 也无法确定原生命令在哪里执行。使用现有的 plugins.entries.codex.config.appServer.transport 设置并设为 "stdio",或使用本机保存的外部/手动移交。Triage 永远不会静默地将已配置的套接字路由切换到 stdio。没有安装目标的普通 Codex 运行保留套接字和 WebSocket 支持。ACP、预置沙箱、远程/节点执行以及具有 remoteWorkspaceRoot 的 Codex app-server 仍不支持自动本地目标修复。原生沙箱和审批策略保持不变。

修复智能体会收到原始故障和一个验证目标:使用 openclaw health --json 以及 openclaw status --all 或 openclaw gateway status --deep 检查目标安装,在已知时确认更新后预期的运行版本,并验证原始症状。仅 PID、有效配置或成功的修复命令并不能证明恢复。报告必须包括更改、验证证据以及任何剩余阻塞项。

跳过或阻止的更新、能力审批拒绝、所有权和模式拒绝、清理未确认的启动失败、现有 Gateway 锁冲突、外部监督者以及已在修复智能体内运行的命令不会触发另一个自动智能体。自动 triage 遵循 --no-restart,并让有意停止的服务保持停止。终止信号会取消前台 triage。诊断和智能体输出发送到 stderr。原始故障结果和退出状态保持不变,即使智能体报告成功。

从旧版 managed-update helper 升级时,遗留的临时声明仅在 其记录的过程实例被明确判定为已死亡时,才会在下一次接纳时被回收。 这包括已退出的 updater runner 或已验证的复用 PID,而不仅仅是 已死亡的 helper。存活的、无法验证的、格式错误的或同时被替换的声明会被 保留。此清理不会将存活的旧 helper 纳入自动 triage: 不兼容的存活移交仍需要已保存的诊断和手动指导。

自动修复对每个规范安装是单飞的,包括前台更新和未监督的 Gateway 启动。竞争失败会报告 triage 已被拥有,保留其原始输出和退出状态,并保留正在运行的尝试。在确认清理后,后续独立故障可以启动新的尝试。

Foreground triage stays attached to its caller. Cancellation or loss of that connection stops new work and gives registered OpenClaw resources their existing cleanup deadlines. The CLI gets the existing 30-second handoff grace to exit after cancellation or terminal disconnect. A stuck CLI is then terminated, and its generation remains fenced. External coding CLIs manage native commands in separate process groups, so even a normal or cooperative CLI exit leaves foreground automatic cleanup uncertain. Their result and manual handoffs remain available. A failed embedded agent can still finish cleanup normally.

如果修复进程突然消失、需要强制终止或拆除失败,则在该操作系统启动期间,自动准入保持阻止。在协作式取消后确认清理的已注册嵌入式资源允许再次尝试。强制或结果不确定的终端结果无法证明该关闭。检查已保存的诊断信息,并手动使用 openclaw triage。在先前工作可能仍在运行时,不要删除该声明。经过验证的不同操作系统启动允许全新尝试。分诊从不发起重启。不可用的启动标识或不兼容的私有交接数据会留下诊断信息和手动指导。

嵌入式 OpenClaw 修复在 macOS 和 Linux 上,将本地非 PTY 命令和 stdio LSP/MCP 服务器置于进程组所有者之下。清理必须确认所拥有的进程组已消失。管道关闭、进程列表或根命令完成都不足以确认。从该组分离并关闭继承描述符的命令仍在此清理保证之外。带有 pty: true 的 OpenClaw exec 请求会回退到非 PTY 子进程,而不启动原生 PTY,并报告警告。需要终端的命令可能会失败。Windows stdio 工具仍缺少清理确认,因此其使用会使自动清理不确定。

对于嵌入式 Codex 修复,清理必须观察其拥有的后代停止,然后 app-server 才能优雅退出。检查失败、未确认的原生终端终止、仍被拥有的共享客户端,或收到信号的 app-server 退出,即使传输已关闭,也会使自动恢复保持阻止。故意从 Codex 终端所有权 分离的命令仍在那项清理保证之外。

对于 Linux user-systemd Gateway,自动托管恢复会在附加到 Gateway 服务的原生作用域中重用现有更新交接。取消在该原生作用域附加经过验证时开始,在就绪公告或修复代理启动之前。更早的更新停放、恢复和准备保留其现有更新行为。在附加之前完成的停止不被视为对未来恢复的取消。失败的更新恢复可能使已安装服务处于非活动状态,并且分诊仍可能被准入。不安全的安装或保留激活请求允许在保持主服务停止的情况下进行离线诊断和修复。运行健康验证被推迟。

在托管更新后,更新器暂存其修复请求,并且仅在确认和最终取消检查之后才显式转移它。从未被转移的已取消或断开连接请求无法启动代理。原生作用域仍对其内部的所有进程组负责。只要 systemd 仍在跟踪其 cgroup,失败或非活动的作用域就不被视为已关闭。

当托管分诊需要重启时,使用原子 openclaw gateway restart 命令。显式停止会取消恢复及其后代,包括当主服务已经非活动或重启待处理时的 systemctl --user stop <gateway-unit>。在恢复期间不要使用先停止后启动。丢失辅助进程、修复子进程或当前交接声明也会关闭恢复。更新器之后无法恢复 Gateway。必须报告取消或不可行性,并且仅凭代理退出代码或文本不是健康证明。

当目标离线且所有权、架构和维护锁允许修复时,诸如 openclaw doctor --fix 之类的修复命令仍然可用。如果维护需要停止托管 Gateway,它会在发出停止之前从该 Gateway 的自动修复子树内部拒绝。继续只读诊断,或进行安全的离线工件修复,然后进行原子重启。否则报告阻塞项,以便独立操作员可以从分诊之外的 shell 运行维护。

自动托管执行仅限于经过验证的 Linux user-systemd 所有权。Launchd、Windows、system-scope systemd 和无法验证的托管所有权保留诊断/手动指导。前台恢复仍然可用。不暗示更广泛的原生取消支持。

此连接需要一个可用的 CLI。缺少 Node 或 CLI 文件、Gateway 服务器启动前或记录其启动期间的故障,以及保留现有 Doctor 恢复流程的无效配置路径,可能仍需要手动 openclaw triage。它不会安装单独的恢复服务。

输出和退出代码

提示被写入状态目录内的 logs/support/,具有仅所有者权限,并与诊断归档以及(如果可用时)已清理的更新失败一起保存。会打印提示和归档路径,并且 --json 会返回它们以及按严重程度分类的发现计数和交接命令。

如果支持工件无法保存,分诊会报告存储错误。它仍会将内存中的提示传递给可用的交互式代理,包括明确请求的嵌入式轮次。对于失败的写入,它不会报告已保存的提示路径。独立 JSON 输出、非交互式会话以及没有可启动交接的会话保留非零工件失败。这些显式诊断运行从不自动启动代理。

启动的外部代理继承当前环境,并固定捕获的安装的状态、配置和默认工作区选择器。打印的命令固定相同的选择器并保留 shell 引号。外部代理仍控制其自身的 shell 环境和执行策略。保持交接在本机上。分诊以启动的代理的退出代码退出。如果代理无法启动,分诊会打印其手动命令并以非零退出。它不会尝试另一个提供商。失败的嵌入式推理检查、不支持的执行路由,或没有交互式终端的 --run 也以非零退出。已保存的提示和手动交接命令仍然可用。

嵌入式修复在其验证证明已解决时以 0 退出,当时间预算停止运行时以 2 退出,对于其他未完成或不可用的修复以 1 退出。仍留下错误或未经验证的更新的改进仍视为未完成。

选项

选项 效果
--json 输出 Prompt 和归档路径、发现计数、检测到的代理以及命令。
--no-export 跳过诊断归档;仍会准备 Prompt 并使用所选的交接路由。
--agent <name> 选择 agy、claude、codex、cursor、grok、kimi、muse、opencode、pi 或 qwen,而不是自动检测。
--run 运行一次有界的嵌入式修复回合,并带有安装或更新解决验证。
--non-interactive 准备诊断,而不提示或启动代理,包括在终端上。
--update-result <path> 包含由更新器写入的有界更新失败 JSON 诊断工件。

--run 不能与 --json、--non-interactive 或 --agent 组合使用。

相关:Doctor、Gateway 和 Troubleshooting。

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