Clawdbot 升级 OpenClaw 踩坑记：一个命令顺序的教训

Clawdbot 升级 OpenClaw 踩坑记：一个命令顺序的教训

给Clawdbot升级OpenClaw，一个以为会轻松加愉快的过程，结果结结实实踩了个坑。这事儿挺有代表性，顺手记录下来，也许能帮你省下一些折腾的时间。

原本预估五分钟搞定，没想到在命令执行的顺序上栽了跟头。下面就来复盘一下整个过程，特别是那个关键的顺序问题。

正确的升级步骤

想顺利升级，不走弯路，其实按部就班遵循下面几步就行：

首先，停下旧服务。这很好理解，给新版本腾出位置。

clawdbot gateway stop

接着，安装最新的OpenClaw包。

npm i -g openclaw@latest

然后，就是整个升级过程中最核心的一步——数据迁移。

openclaw doctor

这个命令堪称“智能搬家工”，它会自动识别并迁移你旧版本中的所有数据和配置，完全无需手动备份操作，省心又安全。

最后，启动全新的服务。

openclaw gateway start

至此，升级完成。你会发现之前的历史记录、各项配置都完好无损地转移了过来。

我踩的坑

问题就出在一种急于求成的心态上。安装完OpenClaw之后，千万别急着去执行 openclaw gateway start。

当时手太快，安装命令一结束，顺手就启动了新服务。结果呢？系统直接创建了一个全新的、空白的配置目录，旧数据自然没有被自动迁移过来，等于白忙活一场。

补救方法：

如果不幸先启动了怎么办？也别慌，补救措施还算简单：

rm -rf ~/.openclaw
openclaw doctor

先把那个新建的空目录清理掉，然后老老实实重新运行一遍 doctor 命令，让它重新执行迁移工作，问题就能解决。

总结

所以，关键的升级顺序务必铭记于心：stop（停旧）→ install（装新）→ doctor（迁移）→ start（启动）。

核心教训就是，在启动新服务之前，一定要让 openclaw doctor 这个“数据搬运工”先上场。记住这个顺序，就能轻松避坑了。