什么是OpenClaw Upgrader
OpenClaw Upgrader 是一个专为 OpenClaw 设计的多平台升级工具，其核心理念是将复杂的升级流程委托给本地智能代理（如 Codex 或 Claude Code），而非依赖简单的脚本包装。该工具运行在目标主机上，通过调用本地编码代理执行完整的升级与恢复工作流，确保升级后 OpenClaw 不仅安装完成，而且真正可用。它强调‘端到端’的成功标准：从版本更新、服务定义刷新、服务重启，到最终端点可达性和客户端可访问性验证，每一步都必须成功才算整体完成。OpenClaw Upgrader 不假设特定操作系统或部署模型，而是让代理根据实际环境动态识别并处理 macOS LaunchAgent、Linux systemd 或其他自定义服务管理方式。整个流程具备严格的并发控制机制，同一主机上仅允许一个升级任务活跃运行，避免冲突。同时，若本地代理不可用（未安装、未认证或预检失败），工具会主动报告阻塞状态，而不是盲目降级为原始 shell 操作。
核心功能特点
- 基于本地编码代理（Codex/Claude Code）的跨平台升级委托机制
- 强制要求升级后服务恢复与端点可达性双重验证
- 严格单实例运行锁防止并发冲突
- 结构化结果输出包含版本、状态、修复动作等完整信息
- 支持多种服务模型（LaunchAgent/systemd/manual）而无硬编码假设
适用场景
OpenClaw Upgrader 主要适用于需要安全、可靠地将 OpenClaw 升级到指定或最新版本的所有场景。无论是开发者在本地开发环境中频繁更新测试版本，还是运维人员在生产服务器上执行正式升级，该工具都能自动适配不同操作系统的服务管理方式。例如，在 macOS 系统上使用 launchctl 管理的 OpenClaw 实例，或在 Linux 上使用 systemd 守护进程的场景，均可由同一套逻辑处理。当用户触发升级命令时，工具首先检测当前版本、备份配置、收集环境上下文，然后判断可用的本地代理是否就绪；若 Codex 可用则优先使用，否则回退至 Claude Code。代理接手后，将执行完整的升级路径规划、包安装、服务定义刷新、服务重启及多轮健康检查，包括对受保护端点的认证感知探测，确保即使启用了身份验证也能正确识别服务状态。整个过程结束后，无论成功与否都会生成机器可读的结果文件，供后续监控或审计使用。此设计特别适用于那些无法容忍‘安装成功但服务不可用’这类伪成功的关键业务系统。