问题现象

修改 openclaw.json 配置文件后,Bot完全无响应。查看终端,显示 gateway disconnected——网关直接断开,说明配置文件写坏了,OpenClaw无法正常解析。

恢复流程

OpenClaw每次修改 openclaw.json 时会自动生成备份文件,这是它的一个实用设计。出问题时,只需要把上一个可用的备份覆盖回去即可。

具体操作:

  1. 打开终端,进入OpenClaw目录:
cd ~/.openclaw
  1. 查看目录下的文件,确认有哪些备份:
ls
  1. 先把当前损坏的配置文件另存一份,方便后续排查问题:
cp -p openclaw.json openclaw.json_bad_20260220
  1. 用最近一个可用的备份文件覆盖当前配置:
cat openclaw.json.bak > openclaw.json
  1. 重启网关:
openclaw gateway restart

到这里就恢复了。

一个值得注意的点

这个修复过程本身没什么技术含量,但它暴露了一个更重要的问题:对于非技术背景的用户来说,openclaw.json 是整个系统的命脉,在没有真正理解各项配置含义之前,不要随手改动这个文件。

OpenClaw的自动备份机制算是一层安全网,但它只能兜住"改错了"的情况,兜不住"改对了但不知道改了什么"带来的后续连锁问题。更稳妥的做法是:每次修改前手动做一次快照,记录改了什么、为什么改,这样即使出问题也能快速定位,而不是盲目回滚到上一个版本然后不知道丢了哪些有效配置。

对于正在摸索OpenClaw的人来说,踩坑是必经之路,但每个坑的价值在于你是否记录了完整的上下文——不只是怎么修好的,还有为什么会坏。