重装整个 U 盘系统
如果你 U 盘里的系统版本比较旧，可以按本页重装一遍。 授权和个人数据都能完整保留。
什么时候需要这么做
Section titled “什么时候需要这么做”重装整个系统是最彻底但也最麻烦的办法。先确认你是不是真的需要：
| 你遇到的情况 | 该怎么办 |
|---|---|
| 只是面板界面显示异常、版本落后 | 单独更新管理面板就够了，三步搞定 |
| 引擎版本旧，想升到最新 | 软件里「检查更新」点一下即可，不用重装 |
| 版本差太多，更新按钮点了没反应 | 需要本页的完整重装 |
| 文件缺失、目录被误删、反复启动失败 | 需要本页的完整重装 |
先认一下 U 盘目录
Section titled “先认一下 U 盘目录”不同版本的发布包在启动脚本上可能略有差异，但核心目录结构是固定的。 升级前先搞清楚哪些要保、哪些会被替换：
文件夹base/ 系统默认预设文件 —— 会被新版覆盖
- …
文件夹data/ 你的全部身家 —— 授权、聊天记录、模型配置，必须保留
- …
文件夹openclaw/ 核心服务引擎与官方插件 —— 会被新版覆盖
- …
文件夹panel/ 管理面板程序 —— 会被新版覆盖
- …
文件夹runtime/ 内置 Node.js 运行环境 —— 会被新版覆盖
- …
- Windows.bat Windows 启动脚本
- Mac.command macOS 启动脚本
- 软件使用说明.html 本地版帮助手册
- 扫码联系售后人员.jpg 售后企微二维码
一句话记住：data 要保，其它都会被新版覆盖。
-
第一步：彻底关掉软件
Section titled “第一步：彻底关掉软件”在开始之前确认三件事：
- 如果服务正在运行，先到 「仪表板」 点击 「停止服务」
- 完全退出管理面板（Windows 检查右下角托盘图标，Mac 在 Dock 上右键退出）
- 如果还有黑色终端窗口开着，一并关掉
-
第二步：备份，把授权文件复制出来
Section titled “第二步：备份，把授权文件复制出来”必做：把 U 盘里的
data/license/config.json复制到电脑桌面。建议顺手做：把整个
data文件夹也复制一份到桌面留底。 它占不了多少空间，万一之后想找回旧的聊天记录还来得及。
-
第三步：清空 U 盘
Section titled “第三步：清空 U 盘”确认备份好了之后，删除 U 盘根目录下的所有文件和文件夹，清空到一个文件都不剩。
-
第四步：下载并解压新版
Section titled “第四步：下载并解压新版”点下面的按钮前往官方下载页，获取最新版系统压缩包：
下载完成后先解压，再把解压出来的所有文件和文件夹复制进空 U 盘的根目录。
-
第五步：恢复你的数据
Section titled “第五步：恢复你的数据”这一步有两种选法，按你的需要挑一个：
在 U 盘里依次进入
data→license文件夹（不存在就手动建一个）， 把桌面备份的config.json复制进去覆盖。结果：系统以全新的默认配置启动，能拿到新版所有的优化默认值。 代价是需要重新填一次 AI 模型的 API Key。
把桌面备份的整个
data文件夹复制到 U 盘根目录，覆盖新系统里的同名文件夹。结果：模型配置、聊天记录、数字员工、个人偏好全部回来，装完就能接着用。 代价是可能带着一些旧版遗留的配置项。
-
第六步：启动
Section titled “第六步：启动”双击 U 盘根目录下的启动脚本：
- Windows：
Windows.bat - Mac：
Mac.command
系统会以最新版本启动。首次启动仍然要走一遍安全放行， 步骤见安装与上手。
- Windows：
文件删不掉，提示「正在使用中」
说明还有进程没退干净。回到第一步再检查一遍：管理面板、黑色终端窗口、
以及浏览器里打开的 127.0.0.1:18789 页面都要关。
还不行就把 U 盘弹出后重新插一次，或者重启电脑再删。
忘了备份授权文件，已经把 U 盘清空了
别慌，授权本身在我们服务器上有记录。
扫 U 盘里那张 扫码联系售后人员.jpg（或者用远程服务页里的二维码）
联系售后，报上订单编号就能补发。
重装后要重新激活吗
不用。授权是跟着 U 盘走的，恢复了 config.json 就还是原来那份授权，
不消耗换绑次数。
重装后模型配置没了
如果你在第五步选的是「只恢复授权」，这是预期结果—— 到模型配置重新填一次 API Key 即可。
想找回旧配置的话，桌面上那份 data 备份里就有，
把整个文件夹覆盖回 U 盘就能全部恢复。
启动后提示缺少文件
多半是第四步复制不完整（大文件复制中途被中断，或者压缩包没解压干净）。 把 U 盘再清空一次，重新解压、重新复制，复制过程中不要拔盘。