OpenClaw 生命周期

这一页讲的是 OpenClaw 本体如何被 Guard 管理，而不是 Guard 自己的 UI 状态。

你可以在这里做什么

检查当前是否已安装
诊断安装来源和更新方式
安装或修复 OpenClaw
更新到推荐版本
选择某个版本或执行回退
彻底卸载 OpenClaw

首屏为什么只保留一个主动作

Guard 在 OpenClaw 页面里故意把首屏动作做得更克制：

如果还没安装，就显示“安装 / 修复 OpenClaw”
如果已经安装，就显示“更新到推荐版本”

这是为了避免普通用户一上来就面对版本、渠道、来源、历史回退这些复杂概念。

安装 / 修复

推荐优先用这两种方式：

命令行

bash

openclaw-guard openclaw status
openclaw-guard init-machine --install-openclaw --start-web --port 18088

工作台

在 OpenClaw 页面里直接执行“安装 / 修复 OpenClaw”。

Guard 会优先检查：

当前是否已经存在可用的 OpenClaw
当前来源是否可沿原方式更新
是否需要进入 Guard 托管安装或修复路径

更新到推荐版本

默认的更新行为是“官方能力优先，同源执行”：

如果当前 OpenClaw 可以正常运行，Guard 会优先调用官方更新能力
如果当前二进制缺失、损坏或无法执行，Guard 才会回退到安装 / 修复流程

这意味着：

已有 package 安装会尽量沿 package 路径升级
已有 PATH 检测到的安装会尽量沿原来源升级
只有无法正常升级时，才进入 Guard 的补救逻辑

高级区：版本与回退

高级区承接更复杂的生命周期能力：

指定版本

适合你明确知道目标版本时使用。Guard 会把动作结果和前后状态展示清楚，而不是只显示一个“成功”。

快速回退

如果你最近一次更新就是通过 Guard 发起的，Guard 可以基于历史记录提供“回到上一版本”的快捷入口。

高级回退

这部分面向更技术向的用户，可能涉及：

指定历史版本
使用某个已知 tag
结合源码检出场景回到某个引用点

普通用户不需要先理解这些操作，再去使用 Guard。

卸载

Guard 支持彻底卸载 OpenClaw，但会要求二次确认，并明确说明风险：

会移除当前安装的 OpenClaw 二进制
不等于自动清理所有工作区和历史资产
卸载前建议先保存一个恢复点或导出诊断信息

如果你只是想修复异常，不建议第一反应就卸载。优先顺序通常应是：

看状态与诊断
执行安装 / 修复
再考虑更新或回退
最后才是彻底卸载

OpenClaw 生命周期 ​

你可以在这里做什么 ​

首屏为什么只保留一个主动作 ​

安装 / 修复 ​

命令行 ​

工作台 ​

更新到推荐版本 ​

高级区：版本与回退 ​

指定版本 ​

快速回退 ​

高级回退 ​

卸载 ​

推荐排查顺序 ​