OpenClaw AI助手入门教程-docker版本升级openclaw

说明

• openclaw目前更新的频率很快，基本每天都会出来一个新版本，但是使用docker版本的升级，就比较麻烦。目前总结一下几次升级的注意事项，留一个记录

升级步骤：

• 1.首先备份重要配置，比如:

cd openclaw
mv docker-compose.yml  docker-compose.yml.bk
mv ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bk

• 2.更新代码

git pull origin main

• 可能会有一些冲突文件，导致代码更新失败

• 如果有冲突文件，记得先备份出来，再mv为另外文件，再更新代码

• 3.里面比较麻烦的，你之前按照的软件，也可以逐一安装回来

• 新的升级会导致之前安装的软件都会丢失，这个跟你使用docker compose down一样情况。

• 这里要做好记录，之前怎么安装的，后面也怎么安装回来

• 4.重新编译镜像

./docker-setup.bash

• 这一步编译完成会进行配置，按照简单方式配置就可以，看第一篇的安装教程。

• 一定要记录新的token，使用新token来配置旧的openclaw.json里面的token，要不容易导致token不一致

• 因为配置token，环境token，进程token都要保持一致。新安装环境token和进程token都是一致的，就是旧配置的token是不一样，更改这个更容易让其他保持一致。但是麻烦一点就是你客户端要重新配置一下token。

• 5.恢复配置

• 这时候会有一个新的docker-compose.yml和~/.openclaw/openclaw.json。这个可以再备份

#备份新配置
mv docker-compose.yml  docker-compose.yml.bk.new
mv ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bk.new
#恢复旧配置
mv docker-compose.yml.bk  docker-compose.yml
mv ~/.openclaw/openclaw.json.bk ~/.openclaw/openclaw.json

• 5. 逐一安装相应的依赖或软件

#普通用户进入容器
docker compose exec -it openclaw-gateway bash

#root用户进入容器
docker compose exec --user root  -it  openclaw-gateway bash

#安装qmd
#安装vim，jq

#修改token，新安装后，token发生变化，使用新的token
#保持配置文件Token=环境变量Token=网关进程Token

• 6. 重新启动

#重启
docker compose restart openclaw-gateway

#查看日志，有没出错地方，再一一排查
docker compose logs -f 

• 7. 经过上面的处理，应该大致会恢复之前的状态
• 在web ui chat 里面让openclaw进行自检，恢复其他相应即可。

已经完成升级，检查配置，软件，功能哪些地方有问题，飞书，deepseek ，邮件发送, qmd, 各个助手和配置等