Summary
OpenClaw updates consistently cause the gateway service to enter a crash loop when plugin validation rules change between versions. The service cannot start because the existing config becomes invalid, but openclaw doctor --fix is not automatically executed during updates.
Environment
- Host: Raspberry Pi (arm64)
- OS: Linux 6.12.62+rpt-rpi-v8
- Node: v22.22.0
- OpenClaw: 2.21 (2026.1.29)
Steps to Reproduce
- Have OpenClaw running via systemd (
openclaw-gateway.service)
- Update OpenClaw (
npm update -g openclaw or auto-update)
- Service restarts → crash loop begins
Error Logs
Config invalid
File: ~/.openclaw/openclaw.json
Problem:
- plugins: plugin: extension entry escapes package directory: ./index.ts (x31)
- plugins.entries.telegram: plugin not found: telegram
- plugins.entries.slack: plugin not found: slack
- plugins.entries.voice-call: plugin not found: voice-call
- plugins.slots.memory: plugin not found: memory-core
Run: openclaw doctor --fix
Service then crash-looped 3320 times before manual intervention.
Expected Behavior
The update process should:
- Run
openclaw doctor --fix automatically before restarting, OR
- Run it as part of the systemd
ExecStartPre, OR
- Auto-migrate configs when validation rules change
Current Workaround
Reinstall OpenClaw entirely (npm install -g openclaw), which regenerates a fresh config.
Impact
Every update requires manual reinstall to recover from crash loop. Users running headless (Pi, VPS) may lose access until they SSH in and fix manually.
Summary
OpenClaw updates consistently cause the gateway service to enter a crash loop when plugin validation rules change between versions. The service cannot start because the existing config becomes invalid, but
openclaw doctor --fixis not automatically executed during updates.Environment
Steps to Reproduce
openclaw-gateway.service)npm update -g openclawor auto-update)Error Logs
Service then crash-looped 3320 times before manual intervention.
Expected Behavior
The update process should:
openclaw doctor --fixautomatically before restarting, ORExecStartPre, ORCurrent Workaround
Reinstall OpenClaw entirely (
npm install -g openclaw), which regenerates a fresh config.Impact
Every update requires manual reinstall to recover from crash loop. Users running headless (Pi, VPS) may lose access until they SSH in and fix manually.