进程恢复
OpenClaw 如何在模型发现超时或 Gateway 停止后清理 Codex app-server 子进程。这是 Codex harness runtime 指南的一部分;每个章节迁移位置 列出了所有章节。
超时的模型发现¶
如果已写入的发现请求在截止时间前没有收到响应,OpenClaw 会退役该共享客户端。其他活动租约会在其进程关闭前完成; 后续发现会使用新客户端。成功的发现仍可复用。
Gateway 硬停止后的恢复¶
在 POSIX 系统上,OpenClaw 在生成每个新的 stdio 子进程之前,
会检查已注册的孤立 Codex app-server
进程。Gateway 启动时还会运行一次
尽力而为的后台清扫;生成前检查仍具有权威性。
OpenClaw 会在发送 Codex initialize 之前,将父进程和子进程身份记录到当前状态
目录中的 SQLite 插件存储
中,因此子进程无法在其注册持久化之前
开始原生回合。
清理仅针对其原始 OpenClaw 父进程已不再运行的已注册子进程。它会检查进程 ID、启动时间和进程组,然后 终止孤立进程及其可发现的子孙进程。如果已记录, 子进程命令行的指纹也必须与活动进程匹配,然后才能 发送信号;持久化注册仅存储该摘要,从不存储原始 参数。另一个活动 OpenClaw 实例、注册在另一个状态目录下的进程,以及外部管理的 WebSocket 或 Unix-socket app-server 均保持不动。这些可移植的 进程检查不提供操作系统所有权的原子性保证, 也无法发现检查前已独立重新指定父进程的子孙进程。
Linux 直接从 /proc 读取进程身份,包括启动 ID
和进程启动 tick,因此 Alpine/BusyBox 安装无需 procps。
启动身份和命令检查共享 10 秒截止时间。在 Linux
启动期间,空命令行会在该截止时间内等待,只要同一活动
进程身份仍然有效。注册仍
需要可用的命令指纹;无法读取或已更改的身份会失败。
macOS 使用其原生 ps,并固定区域设置和时区。注册检查
仅检查观察者和相关的父进程与子进程;无关的
不可读进程不会阻塞这些检查。破坏性清理
在发送信号前仍需要完整的进程树检查和新的身份检查。
如果无法检查必需进程,或有界清理无法确认已注册的
孤立进程已消失,则新的 stdio 连接会失败,而不是生成
另一个子进程。按照报告的原因处理:截止时间失败需要检查
主机负载和 Gateway 日志,而访问被拒绝失败需要检查
Linux 上的 /proc 访问权限或 macOS 上的 ps 权限。其他检查失败
需要确认进程检查设施可用并返回
可用数据。不要通过扩大权限来解决超时问题。如果清理无法
停止已验证的孤立进程,请在重试前检查并停止该进程。如果
清理预算过期,请重试以完成剩余注册。
此恢复需要生成时注册。它不会发现 旧版 OpenClaw 遗留的未注册子进程,也不会扫描命令名称 来推断所有权。Windows 没有等效的孤立进程注册或 恢复机制。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw