这篇解决什么：配置备份与换机，不是更新通道
搜「OpeClaw 配置备份」「换机迁移」的人，通常已经有一套能用的工作流，担心重装或换电脑后 Provider、提示词路径、Skills 来源说明全丢。
本文只讲：本机配置目录里该留什么、怎么安全拷贝或按当前版本入口导出/导入、换机重装后如何按顺序找回工作流。更新失败、半截更新、版本号对不上 → 走更新失败排查；本地目录读不到 → 走工作区文。
不编造未公开的「一键云同步全配置」能力。能否导出、导入按钮叫什么、目录字段如何命名，一律以你当前版本设置页与关于页为准。
备份前先列清单：什么必须带走
最小清单通常包括：API / Provider 相关密钥或占位说明（可手抄到密码管理器，勿明文发聊天群）、自定义提示词或模板路径说明、已启用 Skills 的来源与版本备注、工作区绝对路径列表（方便新机对照重建）、以及关于页记下的当前版本号。
配置目录常见位置与更新残留处理一致：Windows 多为 `%AppData%/OpeClaw`，macOS 多为 `~/Library/Application Support/OpeClaw`；若你机器上名称不同，以当前版本文档或设置页「打开配置目录」类入口为准，不要猜第三方脚本写死的路径。
发布包从哪下、该装哪一构建，先看下载页。备份目的是「可恢复」，不是「带一份不明安装包走」。
- 先完全退出客户端，再复制配置目录，避免半写文件。
- 密钥与配置目录打包分开放；U 盘丢失时至少密钥不在同一压缩包。
- 记下旧机工作区真实路径，换机后大概率要重选，不能假设路径一字不差。
导出 / 拷贝：以当前版本入口为准
若设置里提供导出、备份、迁移向导一类入口，按对话框逐步操作，导出完成后再关机或卸载。没有该入口时，用系统文件管理器复制整份配置目录到加密介质即可——这是本机备份，不是宣称存在云端账号同步。
拷贝后做一次抽查：打开备份里是否有设置文件、是否体积异常偏小（可能只拷了空壳）。不要在运行中的客户端上边改边拷。
公司机若禁止访问 Application Support / AppData，先问 IT 或改用允许的用户目录导出；关掉安全软件硬拷不属于本文推荐步骤。
换机或重装后：恢复顺序比「整包覆盖」更重要
固定顺序：从下载页安装与旧机同平台的当前可用构建 → 首次启动先不要急着接长工作流 → 若有导入入口则导入备份，否则退出客户端后把配置目录放回对应位置 → 再启动，核关于页版本与 Provider 是否回来。
恢复后做最小验证：一条短对话或一条只读本地文件步骤。通了再逐步加回 Skills 与完整工作流。整包覆盖到仍在运行的异常目录，容易把新旧字段搅在一起。
若恢复后客户端根本打不开，先分清是配置损坏还是安装/杀毒问题：打不开走专项排查；若能开但更新通道异常，再并读更新失败文——迁移流程里不要反复点「检查更新」当修复手段。
工作流找回：路径、权限与分流
配置回来了，项目文件仍读不到——多半是新机路径变了或权限未重新授予。按本地文件夹与工作区文重新选择目录并完成权限对话框，而不是删掉刚恢复的配置重来。
Skills 显示已装却无效：核对来源与权限是否在新机被系统拦截，细节见 Skills 文。模型 401/429 仍走 API Key 文；代理环境连不上走代理排查。
场景是否适合本机助手、权限边界与使用范围 → FAQ。迁移成功与否以「短测通过」为准，不以「文件都拷过去了」为准。
和更新失败 / 干净卸载 / 工作区怎么分流
主动换机、重装前备份、导出后再装 → 留在本文。
检查更新失败、更新后闪退、半截包、版本对不上 → 更新失败与干净重装；清残留前仍建议先按本文做一份备份。
只想卸干净、确认 AppData / Application Support 残留、重装前清场且不带走配置 → 干净卸载与残留清理。只是某文件夹读不到、权限弹窗 → 本地文件夹与工作区。安装包入口 → 下载页；场景与边界 → FAQ。
配置备份迁移对照表（不新增结论）
下表只归纳上文顺序；不改变「以本机配置目录与当前版本入口为准」「不编造云同步」，以及更新通道问题仍走更新失败文的分流。
| 现象 | 优先动作 | 常见误操作 |
|---|---|---|
| 换机怕丢工作流 | 先列清单并拷配置目录 / 走导出入口 | 假设存在未说明的云同步 |
| 重装后 Provider 全空 | 确认已退出再放回配置目录 | 客户端开着直接覆盖半截文件 |
| 配置在、文件读不到 | 按工作区文重选路径与权限 | 删掉备份配置指望「重置能找回文件」 |
| 恢复后更新一直失败 | 转更新失败排查 | 把迁移备份反复当更新补丁覆盖 |
| 不知装哪一版 | 对照下载页发布状态 | 用聊天群「迁移专用破解包」 |
菜单名、导出入口与配置目录实际路径以当前客户端为准；本文不承诺未公开同步能力或人工客服时效。
配置备份与换机迁移常见问题
OpeClaw 有没有官方云同步，换机自动找回配置？
本文不假设未公开的云同步能力。换机与重装应以本机配置目录拷贝、设置页导出/导入入口（若当前版本提供）以及手抄关键信息为准；具体菜单以当前版本为准。
备份配置和「更新失败要清残留」是一回事吗？
不是。清残留是更新后异常时的修复动作；备份迁移是换机或重装前主动保存。更新通道卡死、半截包、版本对不上，走更新失败排查；只想卸干净、重装前清场，走干净卸载文——不要把「先删配置再碰运气」当成迁移流程。
只拷了配置目录，工作区文件却读不到？
配置里往往只有路径引用，不会把整份项目文件一起带走。新机器要重新选真实目录并完成权限对话框；路径与授权细节见本地文件夹与工作区文。
换机后从哪里装客户端？
回本站下载页核对当前平台发布状态与安装包，避免聊天群短链。装完先恢复配置再跑短测；场景边界见 FAQ。