KnownFix — OpenClaw known issues

[OpenClaw] [Bug]: doctor --fix refuses `transcript-directives` while the gateway is running and blocks every later migration step — no online repair path

Wed, 21 Oct 2026 12:41:05 +0000

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…

Workaround (quoted from comment by @clawsweeper[bot]): `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…

Severity (auto): medium · 2 reactions · 11 comments · more OpenClaw issues

[OpenClaw] [Bug]: a parked "plugins reload --wait" holds the plugin-replacement gate with no deadline and blocks the start of every isolated agent run on the Gateway

Thu, 15 Oct 2026 11:05:00 +0000

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…

Severity (auto): high · 2 reactions · 2 comments · more OpenClaw issues

[OpenClaw] Update failure: validating (2026.9.6)

Mon, 12 Oct 2026 16:06:39 +0000

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…

Severity (auto): critical · 2 reactions · 3 comments · more OpenClaw issues

[OpenClaw] [Bug]: Gateway SIGBUS on a live agent SQLite -shm mapping under concurrent agent activity

Fri, 09 Oct 2026 06:58:43 +0000

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…

Severity (auto): critical · 2 reactions · 2 comments · more OpenClaw issues

[OpenClaw] Setup inventory stays retired after a config hot reload: setup-registry, setup-inference, model runtime refresh, subagent announce, and chat.metadata fail until restart

Thu, 08 Oct 2026 22:07:45 +0000

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…

Severity (auto): high · 2 reactions · 2 comments · more OpenClaw issues

[OpenClaw] [Bug]: OpenAI Codex model discovery hardcodes `client_version=0.158.0`, ignoring the configured external Codex app-server

Thu, 01 Oct 2026 14:37:40 +0000

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…

Severity (auto): medium · 2 reactions · 8 comments · more OpenClaw issues

[OpenClaw] WhatsApp: PENDING_DELIVERY_NOTICE silently replaces the real reply instead of supplementing it, recurring far beyond restart boundaries

Thu, 01 Oct 2026 08:38:43 +0000

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…

Severity (auto): high · 3 reactions · 5 comments · more OpenClaw issues

[OpenClaw] [Bug]: Linux desktop app minimize, maximize, and close buttons are overlapping side panel controls

Thu, 01 Oct 2026 05:52:48 +0000

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…

Severity (auto): high · 4 reactions · 6 comments · more OpenClaw issues

[OpenClaw] [Bug]: doctor --fix truncates existing shared-state SQLite DB and then aborts with Existing shared-state database generation changed

Wed, 30 Sep 2026 22:57:26 +0000

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…

Severity (auto): critical · 2 reactions · 5 comments · more OpenClaw issues

[OpenClaw] Codex intermittently returns 403 owner-verification error after an in-place model switch

Wed, 30 Sep 2026 20:44:09 +0000

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…

Severity (auto): critical · 2 reactions · 14 comments · more OpenClaw issues

[OpenClaw] Severe Gateway/SQLite regression across 2026.8→2026.9: after two months of freezes and lock failures we rolled back to 2026.7.35 LTS to get a working assistant

Tue, 29 Sep 2026 20:42:40 +0000

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…

Severity (auto): critical · 2 reactions · 5 comments · more OpenClaw issues

[OpenClaw] [Bug]: 2026.9.6 prepared-model-catalog worker leaks ~1 GiB per 5 min; each memory reclamation supersedes the runtime publication and kills every waiting turn

Mon, 28 Sep 2026 16:26:12 +0000

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…

Severity (auto): critical · 2 reactions · 14 comments · more OpenClaw issues

[OpenClaw] [Bug]: 2026.9.6 Gateway heap grows ~45-100 MiB/h at rest on Linux systemd --user until V8 OOM

Sun, 27 Sep 2026 16:49:30 +0000

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…

Workaround (quoted from issue body): `--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.

Severity (auto): critical · 2 reactions · 3 comments · more OpenClaw issues

[OpenClaw] prepared-model-catalog.worker.js: unbounded memory leak, ~4-5 GB/h, provider-agnostic (reproduced on cold reboot + provider bisect)

Sun, 27 Sep 2026 13:12:30 +0000

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…

Severity (auto): critical · 2 reactions · 24 comments · more OpenClaw issues

[OpenClaw] Gateway boots ~7 short-lived SQLite store/read workers per minute (512 MB each), keeping V8 threads at ~80% CPU

Sun, 27 Sep 2026 11:59:35 +0000

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…

Severity (auto): high · 2 reactions · 7 comments · more OpenClaw issues

[OpenClaw] [Bug]: Gateway memory sawtooth on 2026.9.6 — prepared-model-catalog worker grows to the full heap ceiling; ~200 critical memory-pressure events/day

Sun, 27 Sep 2026 10:40:22 +0000

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…

Severity (auto): critical · 4 reactions · 16 comments · more OpenClaw issues

[OpenClaw] [Bug]: Gateway temp log truncated on every CLI/gateway start destroys crash forensics (Windows)

Sat, 26 Sep 2026 15:42:58 +0000

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…

Severity (auto): critical · 2 reactions · 2 comments · more OpenClaw issues

[OpenClaw] plugin-captures tmp dirs not GC'd after build/catalog operations — disk fills indefinitely

Fri, 25 Sep 2026 22:18:19 +0000

/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…

Workaround (quoted from issue body): Manually delete orphaned dirs where `owner.sqlite` is empty and no process holds a file handle:

Severity (auto): critical · 2 reactions · 18 comments · more OpenClaw issues

[OpenClaw] [Bug]: secrets audit flags a plaintext API key that configure --section model itself writes, with no supported non-Vault way to store a SecretRef in a SQLite auth profile

Fri, 25 Sep 2026 00:21:55 +0000

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…

Severity (auto): critical · 2 reactions · 4 comments · more OpenClaw issues

[OpenClaw] [Bug]: 2026.9.5 model-catalog worker leaks openclaw-plugin-build-* source captures in tmp (1-3 GB/min, fills the disk) — disk side of #155753

Wed, 23 Sep 2026 14:30:34 +0000

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…

Workaround (quoted from issue body): 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).

Severity (auto): critical · 2 reactions · 15 comments · more OpenClaw issues

[OpenClaw] Native memory leak in 2026.9.5 — RSS grows ~1 GiB per 30 s while V8 heap stays stable

Mon, 21 Sep 2026 20:57:37 +0000

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…

Severity (auto): critical · 2 reactions · 8 comments · more OpenClaw issues

[OpenClaw] [Bug]: OpenClaw 2026.9.5 Turned a Stable Environment Into an 8-Hour Failure Recovery Session

Sat, 19 Sep 2026 23:36:16 +0000

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…

Severity (auto): critical · 2 reactions · 41 comments · more OpenClaw issues

[OpenClaw] [Tracking] 2026.9.3 / 2026.9.4 update, upgrade and recovery reliability

Fri, 11 Sep 2026 20:41:52 +0000

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…

Severity (auto): critical · 2 reactions · 13 comments · more OpenClaw issues

[OpenClaw] v2026.7.2 STRICT migration fails on databases with BLOB-stored TEXT values and PRIMARY KEY constraints

Fri, 17 Jul 2026 21:32:03 +0000

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…

Severity (auto): critical · 4 reactions · 1 comments · more OpenClaw issues

[OpenClaw] [Bug]: Codex app-server rewrites prompt on tool-call continuation turns, busting OpenAI prompt cache mid-turn (cache ratio 93% → 47%)

Tue, 19 May 2026 11:36:59 +0000

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…

Severity (auto): medium · 5 reactions · 9 comments · more OpenClaw issues

[OpenClaw] Allow SecretRef objects in `mcp.servers[].env` schema (currently `string|number|boolean` only)

Sun, 03 May 2026 06:10:46 +0000

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…

Workaround (quoted from comment by @davidcittadini): The only documented workaround is the global `$OPENCLAW_STATE_DIR/.env`.

Severity (auto): critical · 5 reactions · 12 comments · more OpenClaw issues

[OpenClaw] [Bug]: Live Docs are ahead of release

Tue, 17 Mar 2026 10:14:14 +0000

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…

Severity (auto): critical · 6 reactions · 11 comments · more OpenClaw issues

[OpenClaw] [Bug] "Cannot convert undefined or null to object" in 2026.3.2 with google-vertex/gemini-3.1-pro-preview

Fri, 06 Mar 2026 20:30:59 +0000

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…

Severity (auto): high · 4 reactions · 18 comments · more OpenClaw issues