openclaw doctor --fix reported the problems and fixed none of them

说明与用途

升级 OpenClaw 到 2026.8.1 后，网关因旧配置和 Node 不兼容而无法启动。通过手动升级 Node、执行 postinstall、删除/重命名被拒绝的配置键以及禁用不兼容插件，成功启动服务。

问题

After upgrading OpenClaw from 2026.4.1 to 2026.8.1, the gateway failed to start with exit code 78 and the suggested repair command did not resolve the issues.

结果

The gateway started after manual configuration edits, node upgrade, and disabling legacy stores; the upgrade was not fully automated.

工作流

• Upgrade OpenClaw to 2026.8.1
• Run openclaw doctor --fix and note it does not resolve issues
• Check journalctl for detailed errors
• Install Node >=22.22.3 (Node 24) with nvm
• Reinstall openclaw with --allow-scripts to run postinstall
• Run openclaw gateway install again to update systemd unit
• Delete or rename rejected config keys one boot at a time
• Manually change agents.list to agents.entries
• Add agents.ownership: "explicit"
• Rename legacy session stores (agents/*/sessions/sessions.json, exec-approvals.json) to allow new SQLite stores
• Disable third‑party plugins that cannot load
• Restart service, wait 45 seconds, then start once and monitor journal
• Repeat until gateway starts without errors

证据

The gateway did not start. It exited with code 78 (EX_CONFIG), and the log told me to run openclaw doctor --fix.

来源

Node first. 2026.8.1 requires Node >=22.22.3. The box had 22.22.1, two patch versions short, and npm refused at preinstall.

来源

Delete the config keys the new schema rejects, one boot at a time.

来源