跳到主要内容

升级、备份与恢复

标准变更流程​

  1. 公告维护窗口，停止发起新的 Agent 和 Work 任务。
  2. 记录版本号、镜像/安装包身份和部署配置。
  3. 创建并验证完整备份；Linked Folder 单独备份。
  4. 在停止当前部署之前下载并校验候选版本。
  5. 使用当前平台规定的管理入口升级。
  6. 验证登录、数据、模型、文件、Agent Run、Scheduler、Office 与 Browser Runtime。
  7. 验收完成前保留旧安装包及匹配的备份。

Linux Docker​

升级由宿主机管理器执行。只有一个实例或升级默认实例时运行：

sudo clawuno upgrade --confirm-stop

如果同一宿主机有多个实例，必须明确选择目标：

sudo clawuno upgrade --instance NAME --confirm-stop

如果要安装指定的已签名版本而不是最新可用版本，增加 --version TARGET_VERSION。直接提供镜像摘要属于高级部署方式，使用前需要独立确认该摘要确实属于目标 Clawuno 版本。管理器会先下载候选版本，再停止写入、创建持久化状态快照，并使用不可变镜像引用重建该实例。

新版本已经启动后又失败时，部署会保持停止并留下恢复信息。不要让旧镜像直接读取可能已经迁移的数据，必须把旧镜像和匹配的旧快照一起恢复。

创建并验证宿主备份​

sudo clawuno backup --confirm-stop
sudo clawuno start
sudo clawuno status

命名实例需要在每条命令上增加 --instance NAME。备份命令会停止选中的实例，并故意在结束后保持停止；start 是必需的独立步骤。Web 备份列表不代表这些宿主快照。

恢复失败的升级​

sudo clawuno recover --confirm-restore
sudo clawuno status

命名实例需要在两条命令上都增加 --instance NAME。只使用同一个实例留下的恢复记录；不要复制其他实例的快照，也不要让旧镜像读取已经迁移的状态。

macOS 与 Windows 应用备份​

macOS 可在 系统设置 → 健康 → 备份与存储 创建手工归档，或运行 ~/clawuno/bin/backup.sh --type manual。恢复前退出 App，执行 ~/clawuno/bin/restore.sh 备份文件，然后重新打开并核对数据。

Windows Desktop 可在 系统设置 → 健康 → 备份与存储 创建手工归档。恢复时应彻底退出 Clawuno，在 PowerShell 中设置 $engine = "$env:LOCALAPPDATA\ClawunoDesktop\current\engine" 和 $env:CLAWUNO_DIR = "$env:USERPROFILE\clawuno"，然后运行 & "$engine\bin\restore.ps1" 备份文件。清除临时环境变量后重新打开 Clawuno并核对数据，同时保留替换前自动生成的安全快照。

备份责任​

Docker 备份由宿主机管理，可能短暂停止目标实例。备份不包含外部 Linked Folder，也不能撤销已经发给模型、SaaS 或协作平台的操作。

应在隔离主机上实际演练恢复。一次从未恢复过的备份，不能充分证明恢复能力。

0.8.1 平台边界​

  • macOS 可以通过 Clawuno → Check for Updates 更新，也可以用签名的 0.8.1 DMG 覆盖 App。
  • Linux 支持通过宿主管理器从公开 0.8.0 Docker 版本升级到 0.8.1。
  • Windows 0.8.1 只支持全新安装 Desktop。不要把保留的 0.8.0 Engine-only 或内部测试版数据当作已经验证的迁移路径。