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.

Источник