Known breaks in OpenClaw from github.com/openclaw/openclaw, with quoted workarounds and fixed-in versions where they exist.
Type the version you're about to install (or just upgraded to). Lists tracked issues that mention it. Same data as /api/issues/openclaw.json.
Pulled from public GitHub issues updated in the last 45 days and filtered for always-on problems: install and update breakage, crashes and hangs, gateway/daemon trouble, auth, and headless setups. Ranked by engagement, weighted toward always-on, self-hosting, install/update, crash, auth, MCP and daemon problems (cosmetic desktop-UI issues are down-weighted). Workarounds and "fixed in" versions are quoted only when the issue or its top comments state them. Severity is an automatic estimate from labels, keywords, and engagement, not an official rating. Last refresh: Oct 26, 2026 6:18 AM ET.
The schema for mcp.servers[].env (and mcp.servers[].headers) is: This means SecretRef objects are rejected — operators following security best practices around secret indirection (openclaw config set --ref-source env --ref-id ...) hit a…
The only documented workaround is the global `$OPENCLAW_STATE_DIR/.env`.
Regression / performance On OpenClaw 2026.9.6 the Gateway exhibits a repeating memory "sawtooth": process RSS climbs steadily for several minutes, trips a memory pressure: level=critical event, an idle worker is retired under pressure, RSS…
Crash (process/app exits or hangs) I genuinely regret upgrading to OpenClaw 2026.9.5. Before this update, my environment was stable. After installing 9.5, I spent approximately 8 continuous hours investigating problems that simply did not…
After a recovery that moved the old session store aside, openclaw doctor stops at: The only holder of the agent DB is the running gateway itself. Deterministic on our host: Run OpenClaw 2026.10.5 as a systemd user service (gateway…
`P2`: A large legacy-history installation cannot reliably complete offline repair at default limits, with an advanced-operator workaround and a focused repair already proposed. - `impact:ux-friction`: Repeated offline repair failures require downtime and manual runtime tuning before the operator…
Regression (worked before, now fails) After updating to 2026.3.2, any message causes embedded agent to fail with "Cannot convert undefined or null to object". Update to 2026.3.2 (npm install -g openclaw@latest) Set model to…
/home/ /.openclaw/tmp/plugin-captures/ accumulates multi-GB session directories from plugin-build and model-catalog operations. These directories are never cleaned up after the operation completes, so disk usage grows permanently with each…
Manually delete orphaned dirs where `owner.sqlite` is empty and no process holds a file handle:
Regression (worked before, now fails) Since OC v2026.5.12 + codex-cli 0.130.0 (first observed 2026-05-15), the Codex app-server rewrites the full prompt between a user turn and its tool-call continuation turn instead of appending only the…
The gateway's prepared-model-catalog.worker.js worker thread leaks memory continuously and monotonically, independent of workload volume, model provider, or plugin configuration. On an idle-to-light-traffic single-user install, RSS grows…
Regression (worked before, now fails) On 2026.9.5 the prepared model-catalog worker keeps creating plugin source captures under $OPENCLAWHOME/tmp/openclaw-model-catalog-/openclaw-plugin-build- and never deletes them. On our gateway this…
a cron every minute that, inside each `openclaw-model-catalog-` folder, keeps the 10 oldest captures (the ones created at worker start) and deletes the rest older than 1 minute, by creation time (mtime keeps changing).
extensions/openai/openai-provider.ts always queries the Codex models endpoint with the managed runtime's version: However, the codex plugin officially supports external app-server binaries via plugins.entries.codex.config.appServer.command…
Track update, upgrade, Doctor, migration, rollback and restart reliability around OpenClaw 2026.9.3 / 2026.9.4. This coordination index does not replace the linked reports or their evidence, and does not authorize closing, merging or…
Since upgrading to 2026.9.6 (eb377ac) the prepared-model-catalog.worker.js thread grows by roughly 1 GiB every 5 minutes with no user action, reaches 8 to 13 GiB, and the gateway's memory-pressure reclamation then resets it to under 2 GiB…
Regression (worked before, now fails) Heartbeat IsolatedSessions is in the live docs but not in the latest version 2026.3.13 Add IsolatedSessions to your heartbeat config as per the docs…
On OpenClaw 2026.9.7 (c074824), an existing Codex-backed conversation intermittently fails before a reply with: The first failure followed an in-place session model switch from openai/gpt-6-astra to openai/gpt-6-sol. A…
Regression (worked before, now fails) The buttons are overlapping and you can't use the sidebar buttons Start v2026.9.7 on Linux, I'm using Ubuntu 26.04, installed as a .deb Do something to open the side panel See the icons all…
Regression (worked before, now fails) On the Codex app-server (ChatGPT Plus sub), a multi-tool agent turn reliably fails with Codex stopped before confirming the turn was complete starting in 2026.5.27; 2026.5.26 completes the same turns…
Only found workaround is pinning 5.26.
We use OpenClaw daily — multiple agents, scheduled cron jobs, and a long-lived state directory on Windows. We just spent two months fighting it, and only after rolling back from 2026.9.6 to 2026.7.35 (Extended-Stable LTS) did we get a…
openclaw-2026-07-15.log Regression (worked before, now fails) gateway doesn't start with manual launch Error: gateway did not start on 127.0.0.1:18789 Pls have a look! update to openclaw 2026.7.1 openclaw gateway run --force CLI is…
Regression (worked before, now fails) OpenClaw: 2026.9.7 (c074824) Node.js: v24.21.0 Linux [vps].de 5.2.0 #1 SMP Mon Sep 30 15:36:27 MSK 2024 x8664 GNU/Linux Gateway: system-wide systemd service Service file…
openclaw plugins reload --wait parks indefinitely when the named plugins hold long-lived retained work. While it is parked, no isolated agent run on the Gateway can start — automations for every agent fail with cron: isolated agent setup…
Regression (worked before, now fails) After upgrading from 2026.7.2-beta.1 to 2026.7.2-beta.2, the shared SQLite migration creates indexes referencing managedoutgoingimagerecords.agentid before adding that column, so doctor --fix fails…
The Gateway exits with SIGBUS (code=dumped, status=7/BUS) when a read-only session worker shrinks an agent SQLite WAL-index file (openclaw-agent.sqlite-shm) to 3 bytes while the Gateway still has it memory-mapped, during concurrent agent…
On OpenClaw 2026.9.5 (build ec9c1a1, installed via npm on 2026-09-18), the gateway node process exhibits a sawtooth RSS pattern: process RSS jumps by 1–2 GiB within 30-second windows while V8 heapUsed stays between 786 MB and 1 GB. The…
After upgrading to OpenClaw 2026.7.2-beta.2, openclaw gateway restart (or openclaw doctor --fix) fails with: followed by a chain of noncanonical X schema that cannot be repaired errors. Gateway cannot start, systemd enters a failed state…
On an idle-ish 2026.9.6 gateway, SQLite store/read workers are created and torn down about 7 times per minute. Each one boots the full worker runtime (about 2,000 module files, all plugin manifests) with a 512 MB heap limit and exits after…
After a config hot reload of an agents.entries. change, the plugin setup inventory was retired but several callers kept using it. For about 1.5 hours, until a Gateway restart, they failed with Plugin setup inventory has retired / Plugin…
Behavior bug (incorrect output/state without crash) MCP tool schemas registered via mcp.servers are not injected into sessions spawned by sessionsspawn, regardless of how the documented exposure mechanism is configured. The documented…
Crash (process/app exits or hangs) On a macOS npm-global installation, updating Gateway 2026.10.5 to 2026.10.6 stalls in candidate Doctor before activation, with a waiting Doctor process and a waiting SQLite read-only worker; interrupting…
This report was explicitly reviewed and confirmed in OpenClaw. OpenClaw version: 2026.9.6 Node version: 24.18.0 Update action: Gateway RPC: update.run (control-ui) Installation method: npm-global Update target: 2026.10.2 Failed phase…
On Windows, the daily gateway log at %TEMP%\openclaw\openclaw- .log is truncated and rebuilt every time a CLI command or the gateway itself starts. After a gateway crash, the first thing that destroys the crash evidence is the operator's…
Behavior bug (incorrect output/state without crash) On an npm-global 2026.9.7 Gateway running inside an unprivileged Proxmox LXC container, openclaw update to the next candidate (2026.9.8) fails deterministically in phase validating at…
On 2026.9.6 the Gateway's main-isolate heap grows steadily at rest, about 45–100 MiB/h, until it reaches Node's default V8 ceiling (~4.2 GiB on this host) and aborts with Ineffective mark-compacts near heap limit. It happened once…
`--max-old-space-size=10240` as a direct `node` argument in the service's `ExecStart` (not `NODE_OPTIONS`). That buys days; it does not stop the growth.
Behavior bug (incorrect output/state without crash) When running the Gateway inside a Docker container and using Docker-outside-of-Docker for Sandboxing, /workspace can't binds properly. The Gateway containder attempts to mount the agent…
`"sandbox": { ; "mode": "all",`
OpenClaw: 2026.9.9 (bcfc888) → target 2026.10.3 Install: npm global package (installKind: package, npm 11.14.1) Node: v24.21.0 Gateway: systemd user service, channel stable openclaw update --tag 2026.10.3 --yes --timeout 600 installs the…
Behavior bug (incorrect output/state without crash) openclaw secrets audit reports PLAINTEXTFOUND for a provider API key held in a SQLite auth profile, but that plaintext is written by the official openclaw configure --section model flow…
This report was explicitly reviewed and confirmed in OpenClaw. OpenClaw version: 2026.10.3 Node version: 24.21.0 Update action: CLI command: openclaw update Update target: exact target unavailable; mode: pnpm Failed phase…
Behavior bug (incorrect output/state without crash) The stock signed macOS app cannot inspect a managed Bun Gateway command containing --no-install because installedServiceCLI only skips memory flags; the native update/recovery screen…
PENDINGDELIVERYNOTICE ("I couldn't confirm whether my previous reply reached this chat...") is being sent in place of the real agent reply, repeatedly, across many separate turns over 24+ hours — not just once after a restart as the…
After upgrading, the gateway crash-looped (5+ boots). The SQLite store worker hit its V8 heap cap during startup maintenance and took the gateway down each time. Observed on a long-running install; not yet reproduced on a clean install…
On 2026.9.8, a ChatGPT Responses WebSocket that closes with code 1000 after dispatch ends the run with "Agent run failed". Neither the same-model retry nor the settled-batch continuation from #130721 runs, and the session idles until the…
No issues match those filters.