跳到主要内容
版本:0.8.4

升级、备份与恢复

标准变更流程​

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

Linux Docker​

首次升级到 0.8.4 前,所有现有 0.8.1–0.8.3 安装都须先执行一次迁移,更新选定实例和宿主管理工具,并保留数据:

curl -fsSL https://releases.clawuno.com/install.sh | bash

命名实例或自定义目录需在 bash -s -- 后添加 --instance NAME 或 --dir PATH,可加 --version 0.8.4 固定版本。无人值守迁移须先明确授权中断活动工作,再添加 --yes。完整命令见安装示例。

迁移后,宿主管理器在全球使用同一经过验证的 CDN 路径。只有一个实例时执行 sudo clawuno upgrade;多个实例须明确选择目标:

sudo clawuno upgrade --instance NAME

指定已签名版本而不是最新稳定版时,增加 --version TARGET_VERSION;自定义目录使用 --dir PATH。自动化须以 --yes 明确授权中断。验证通过的缓存归档及已加载镜像可复用,不能只信任 tag。已有下载文件可用 --archive PATH 提供,仍须验证签名元数据。管理器会先准备目标版本,再停止写入、创建持久化状态快照,并使用经过验证的镜像重建该实例。同镜像升级不会重启 Engine 或改动数据,即使宿主管理工具发生更新。

从 0.8.4 起不再新增 GHCR 发行,也不按地区选择来源。install-cn.sh 保留为原样传递参数的兼容别名。历史签名文件、归档及已发布镜像保留用于恢复,不删除或改写。Docker 本身仍是独立前置条件,不由 Clawuno CDN 分发。

升级事务完成前,若启动验证失败,管理器会留下恢复信息并保持部署停止。升级成功后会删除该恢复记录,之后才发现的问题不会自动重新生成恢复记录。不要让旧镜像直接读取可能已经迁移的数据;应保留现场,安排将旧镜像和匹配的数据快照一起受控恢复。

创建并验证宿主备份​

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 或协作平台的操作。

应在隔离主机上实际演练恢复。确认备份能够完整恢复数据后,再将其作为日常恢复保障。

平台边界​

  • macOS 可以通过 Clawuno → Check for Updates 更新,也可以用签名的 0.8.4 DMG 覆盖 App。
  • Linux 0.8.1–0.8.3 安装须先用 install.sh 完成一次性迁移,此后才通过 sudo clawuno upgrade 执行 CDN 升级。
  • Windows Desktop 0.8.1–0.8.3 可以通过 Check for Updates 或正式 Setup 升级到 0.8.4。如果使用旧 0.8.0 Engine-only 安装,请先联系 Clawuno 支持确认迁移步骤,不要直接复用原数据。