💡
原文中文，约7300字，阅读约需18分钟。
📝
内容提要
在升级OpenClaw 4.20版本前，用户需注意22个已知缺陷及其修复措施，以避免系统崩溃。主要问题包括网关重启时会话丢失、身份状态消失、关机异常及编辑提示缺失等。修复方案涉及代码修改和配置调整，用户需逐项核对修复清单，确保升级顺利。
🎯
关键要点
- 在升级OpenClaw 4.20版本前，用户需逐项核对22个已知缺陷及其修复措施，以避免系统崩溃。
- 网关重启时会话和绑定的丢失问题，需添加SIGTERM信号排水机制以确保会话自然结束。
- ACP会话中的身份与状态丢失问题，需将身份和状态数据写入持久化存储并在会话重建时读取。
- 关机时的脏崩溃与AgentDisconnectedError异常，需在进程退出前主动抑制该错误。
- 多轮编辑中的不匹配提示缺失，需扩展不匹配检测以明确失败位置和原因。
- 复合Bash命令的预检查绕过，需递归解析每个子命令并分别做安全检查。
- pkill自匹配导致的SIGKILL循环，需改用fuser命令以避免自我杀死。
- 元数据损坏问题，需在写入元数据前先读取现有副本以防止覆盖。
- 运行环境中显示原始模型ID而不是友好名称，需在运行时注入友好名称字段。
- Codex初始化时的无限挂起，需为初始化请求设置60秒的默认超时。
- OAuth刷新令牌的虚假过期警告，需让健康检查尊重refresh_token的独立生命周期。
- 插件加载器的重复警告噪音，需缓存验证结果以减少重复检查。
- 内联媒体路径在回复中无法附加文件，需验证文件路径并将其作为附件发送。
- ACP流式传输的缓冲延迟，需手动将deliveryMode改为live以改善用户体验。
- 启动时的上下文内存泄漏，需禁用startupContext开关以减少内存使用。
- 长会话的压缩策略过于激进，需提升contextTokens的默认值以减少频繁压缩。
- ACP长会话的超时限制为30分钟，需根据任务需求调整acpLongTurnTimeout。
- Kimi流式调用中工具参数为空，需在配置中切换Kimi的协议以确保正常工作。
- Codex的降级级联错误，需将fallbacks数组设为空以避免错误的降级选项。
- 过期的运行时状态未清理，需添加cron任务定期清理临时文件和重启服务。
- 无限期的前台Bash执行保护缺失，需为每个Bash执行加上超时和输出大小限制。
- Gateway的systemd重启语义不一致，需明确设置重启时的依赖关系和资源释放顺序。
- 受污染的启动会话在开机时未清理，需在启动流程中运行脚本以清理残留会话。
- Claude ACP供应商运行时的上游问题修补，需检查vendor目录下的文件是否被覆盖。
- Claude SDK和CLI注入的系统级提醒，需替换或注释掉不需要的提醒文字。
- Gemini工具与思考逻辑的行为漂移，需在更新后运行热修复脚本以适配新格式。
- Claude CLI的ACP运行时崩溃与自愈，需安装守护脚本以监测CLI进程的健康状态。
- ACP运行时的自愈与绑定持久化组合，需安装扩展以在CLI重启前保存绑定关系。
- 升级后需手动审计每个部分，确保所有修复和配置都已正确应用。
❓
延伸问答
在升级OpenClaw 4.20之前，我需要注意哪些已知缺陷？
用户需注意22个已知缺陷，包括会话丢失、身份状态消失、关机异常等，需逐项核对修复措施。
如何解决网关重启时会话丢失的问题？
需添加SIGTERM信号排水机制，确保会话在重启前自然结束。
为什么在关机时会出现AgentDisconnectedError异常？
该异常发生在关机流程的最后几毫秒，导致日志被截断，需在退出前抑制该错误。
如何处理多轮编辑中的不匹配提示缺失？
需扩展不匹配检测，明确失败位置和原因，避免只提示失败。
如何避免pkill自匹配导致的SIGKILL循环？
应改用fuser命令替代pkill，以避免自我杀死的循环问题。
升级后需要进行哪些审计步骤？
需手动审计已安装的dist文件、配置键、systemd单元、Bash保护脚本、cron任务等。
➡️
