升级 Clawuno
版本类型(从 0.8.4 起)
0.8.4 这样的三段版本是功能版;0.8.4.1 这样的四段版本用于修复对应功能版,并沿用同一套帮助文档。同一基础版本的正式版高于内部测试版。安装器内部编号可能不同,请以 Clawuno 显示的产品版本为准。较旧 Windows App 可能先提示升级到 0.8.4,完成后再检查更新即可获取后续版本。
每次升级前都要做的事
- 等待正在运行的 Agent 和 Work 完成,或主动停止它们。
- 手工创建一次备份,并确认备份文件存在于程序目录之外。
- 记录当前版本号和安装方式。
- 确认升级后能正常使用之前,保留旧安装包和备份。
- 新版本一旦使用过当前数据,不要只换回旧程序。恢复时必须让程序版本和数据快照相互匹配。
macOS
Apple Silicon Mac 可以使用 Clawuno → Check for Updates,也可以用签名的 0.8.4 DMG 覆盖现有 App。App 会同步升级内嵌 Engine,并保留位于应用包之外的用户数据。
Intel Mac 无法安装 0.8.4。
Windows
Windows Desktop 0.8.1–0.8.3 可通过 Check for Updates 或正式签名的 0.8.4 Setup 升级。先备份,使用 Setup 时先退出 App。如果使用旧 0.8.0 Engine-only 安装,请先联系 Clawuno 支持确认迁移步骤,不要直接复用原数据。
卸载 Clawuno Desktop 默认保留 %LOCALAPPDATA%\Clawuno 和 %USERPROFILE%\clawuno。重新安装前仍应单独备份。改用其他安装方式时,请先向 Clawuno 支持确认迁移步骤,不要直接复用原数据。
Linux
从 0.8.4 起,Clawuno 在全球统一使用发布 CDN,不按地区选择来源,也不再新增 GHCR 发行。所有现有 0.8.1–0.8.3 安装都须先执行一次官方安装器,迁移选定实例及宿主管理工具,并保留数据:
curl -fsSL https://releases.clawuno.com/install.sh | bash
命名实例使用 --instance NAME,自定义部署目录使用 --dir PATH。固定迁移目标时,将参数放在 bash -s -- 后,例如 bash -s -- --version 0.8.4 --instance NAME。无人值守迁移须先明确授权中断正在执行的工作,再添加 --yes。完整示例见安装指南。
完成迁移后,后续升级使用:
sudo clawuno upgrade
可添加 --version VERSION,以及 --instance NAME 或 --dir PATH。自动化升级须以 --yes 授权中断。管理器会先准备并验证目标版本,再停止写入、备份数据并启用新版本。如果无法完成,请保留 recovery journal,并使用输出的恢复命令。
验证通过的缓存归档及已加载镜像可复用,不能只信任 tag。已有下载文件可用 --archive PATH 指定,仍须验证签名元数据。同镜像升级不会重启 Engine 或改动数据,即使本次更新管理工具。install-cn.sh 保留为参数相同的兼容别名。历史签名文件、归档及已发布镜像保留用于匹配镜像/数据恢复。Docker 本身仍是独立前置条件,不由 Clawuno CDN 提供。
升级后检查
检查版本号和登录,打开已有 Workspace,抽查代表性文件,并运行一个小型 Agent 任务。同时确认模型连接、定时 Work 和 Linked Folder 仍指向预期资源。
如果 Linux 升级尚未完成且留下 recovery journal,请按管理器输出的指令恢复。成功完成的升级会删除该记录,之后才发现的问题不能直接使用此恢复命令;请保留当前状态并联系支持人员安排匹配旧镜像与数据快照的恢复。不要让旧程序直接读取可能已经迁移的数据。