跳到主要内容

备份、恢复与卸载

完整的应用备份包含配置、认证数据、凭据和受管 Workspace 数据。Linked Workspace 文件夹始终属于外部数据，需要单独备份。浏览器 Cookie，以及已经发送到模型服务或 SaaS 系统的操作，无法通过应用备份恢复。

macOS​

创建备份​

打开 系统设置 → 健康 → 备份与存储，选择 立即备份，等待出现成功状态、时间和非零文件大小。至少把一份近期备份复制到另一块受保护的磁盘。

对应的“终端”命令为：

~/clawuno/bin/restore.sh --list
~/clawuno/bin/backup.sh --type manual

恢复​

  1. 退出 Clawuno，确认 App 和本地 Engine 都已停止。
  2. 运行 ~/clawuno/bin/restore.sh --list，确认要恢复的准确快照。
  3. 运行 ~/clawuno/bin/restore.sh "/备份文件的绝对路径/manual-YYYY-MM-DD.tar.gz"。脚本会先验证归档，并在替换前为当前状态创建安全快照。
  4. 重新打开 Clawuno，检查登录、Agent、Workspace、模型连接和一个代表性文件。在确认无误前，保留原备份和安全快照。

卸载​

使用 Clawuno → 卸载 Clawuno。不勾选“同时删除数据”，只移除 App 并保留本地状态。勾选后会永久删除受管状态，包括本地 Browser Profile；Clawuno 不会沿着 Linked Workspace 删除外部文件夹。

Windows Desktop​

创建备份​

打开 系统设置 → 健康 → 备份与存储，选择 立即备份，等待出现成功状态、时间和非零文件大小。同一页面的备份列表会显示归档名称和当前存储位置。至少把一份近期归档复制到另一块受保护的磁盘。

恢复​

  1. 等待所有 Work 结束，通过托盘菜单退出 Clawuno，并确认 Clawuno Desktop 和本地 Engine 都已停止。
  2. 以安装 Clawuno 的 Windows 用户打开 PowerShell，然后运行：
$engine = "$env:LOCALAPPDATA\ClawunoDesktop\current\engine"
$env:CLAWUNO_DIR = "$env:USERPROFILE\clawuno"
& "$engine\bin\restore.ps1" --list
& "$engine\bin\restore.ps1" "C:\备份文件的绝对路径\manual-YYYY-MM-DD.zip"
Remove-Item Env:CLAWUNO_DIR
  1. 确认交互式警告，重新打开 Clawuno，再核对恢复后的数据。确认完成前不要删除恢复工具生成的安全快照。

卸载​

使用 Windows 设置 → 应用 → 已安装的应用 → Clawuno → 卸载。经过验证的 0.8.1 默认卸载会移除 Desktop 程序，同时保留 %LOCALAPPDATA%\Clawuno 和 %USERPROFILE%\clawuno。

如果要永久清除保留状态，请先确认外部备份可用，卸载 App，确认没有 Clawuno 进程运行，然后只删除上面两个明确的 Clawuno 目录。Linked Workspace 文件夹不在其中，不会被删除。

Linux Docker​

Linux Docker 的备份和恢复必须在宿主机执行，与 Web 备份页显示的应用归档不是同一种机制。如果宿主机有多个实例，请使用目标实例目录里的 CLI，或者明确添加 --instance NAME。

创建备份​

sudo /opt/clawuno-deploy/clawuno backup --confirm-stop
sudo /opt/clawuno-deploy/clawuno start
sudo /opt/clawuno-deploy/clawuno status

备份会停止所选实例，并在结束后保持停止；必须再执行 start。把生成的宿主快照复制到受保护的存储，并单独备份 Linked 文件夹。

恢复中断或失败的升级​

sudo /opt/clawuno-deploy/clawuno recover --confirm-restore
sudo /opt/clawuno-deploy/clawuno status

恢复会把旧镜像、配置及其匹配快照作为整体还原，并单独保留升级失败后的较新状态。它不会撤销 Linked 文件夹里的变化。不要手工让旧镜像读取已经迁移的新数据。

卸载​

只移除容器并保留实例状态、配置和备份：

sudo /opt/clawuno-deploy/clawuno uninstall --confirm-stop

如果确认要永久删除某一个实例，明确指定实例，并按提示输入 DELETE：

sudo clawuno uninstall --instance NAME --purge

purge 不会删除 Linked 文件夹、其他实例、共享镜像、TLS/DNS 配置或外部备份目录。

所有平台共同遵守的恢复规则​

  • 只恢复由同一受支持版本系列创建的完整归档；不要把个别内部 JSON 文件复制进正在运行的 Engine。
  • 先停止所有写入，并保留当前安全快照，直到验收完成。
  • 命令如果拒绝归档、路径或实例身份，应立即停止。保留现场并收集诊断信息，不要强行复制文件。
  • 在隔离安装上做一次恢复演练。没有真正恢复过的备份，还不能证明可以恢复。