Fix Any OpenClaw Error

Resolve 32s request hangs caused by broken IPv6 DNS resolution in Node.js.

Fix SingletonLock permission denied errors when using Snap-based browsers on Ubuntu.

Handle "insufficient balance" errors and fix model fallback for Venice AI.

Fix model verification timeouts when using custom proxies or local LLM servers.

Fix a bug where file-like text in replies triggers a fatal directory error.

Fix the "message.channels is not a valid event type" error after updating Slack dependencies.

Resolve incorrect "API rate limit reached" warnings caused by misclassified 5xx errors.

Fix "network request for deleteWebhook failed" when OpenClaw cannot reach the Telegram API at startup.

Fix "unauthorized: gateway token missing" by pasting your auth token into Control UI settings.

Fix MCP server spawn failures, connection refused errors, tool call timeouts, and protocol mismatches.

Fix BOT_COMMANDS_TOO_MUCH error when registering multiple OpenClaw skills.

Fix linked-but-disconnected WhatsApp state: logging in loop, timeout, then logged out.

Fix startAccount exits that cause immediate channel restart loops.

Fix Anthropic overloaded retries, 529/503 bursts, and stabilize fallback behavior.

Fix Tahoe permission denials that block OpenClaw/Gateway access to local files and tools.

Guide to controlling Windows browsers from an OpenClaw instance running in WSL2.

Resolve directory creation and permission errors inside Docker containers.

Fix the common "exit code 3221225477" crash during OpenClaw installation on Windows.

Resolve communication timeouts between the browser extension and OpenClaw gateway.

Fix the regression in OpenClaw v2026.3.1 affecting Vertex embedded runs, Telegram bots, and cron tasks.

Fix recurring 400 Bad Request errors with GPT-5.2 reasoning blocks in session history.

One decision tree for gateway token mismatch/missing, control UI device identity required, and pairing required (1008).

Single runbook for gateway closed (1006), gateway already running lock timeout, service missing/install, and docker ENOENT.

Fix "disconnected (1008): unauthorized: device token mismatch". Rotate tokens, kill zombie processes.

Fix "gateway token mismatch (set gateway.remote.token to match gateway.auth.token)". Docker, remote CLI, env var override.

Fix "disconnected (1008): pairing required". Approve devices, fix Docker NAT, configure LAN access.

Fix "device identity required". LAN access needs HTTPS or token URL. Secure context requirement for Control UI.

Full Windows troubleshooting: npm install failures, zombie processes, port conflicts, crash loops.

Agent not responding on localhost:3000. Fix IPv4/IPv6 binding and port issues.

Fix trailing commas, unescaped backslashes, and invalid JSON in config files.

Invalid key, rate limits exceeded, or model not found. Debug provider authentication.

Fix MiniMax 401 by enabling authHeader=true with verified upstream release notes.

EACCES permission denied, token mismatch in containers, Chrome not found in Docker.

Generation cuts at exactly 300 seconds. Fix the undici headersTimeout and retry loop.

Bot goes silent or shows "Message ordering conflict". Fix unsupported developer role.

Fix false anthropic API-key missing errors caused by session-memory hook mismatch.

Recover from Telegram channel lockups on medium file uploads; includes safe workaround.

Fix stuck health-check and websocket reconnect failures after reboot.

Break recurring pairing-required loops after npm update by resyncing device token state.

Git not installed or not in PATH. One-command fix for Windows, macOS, and Linux.

Fix PSSecurityException "running scripts is disabled". Use npm.cmd or set execution policy.

Path escaping, firewall rules, Node.js PATH issues, and Docker WSL2 setup.

Fix "Can't reach browser control service (timed out after 20000ms)". Hung CDP, stray Chromium, port 18800 conflicts.

Fix "gateway already running; lock timeout". Stale lock files in Docker, PID reuse, manual cleanup.

Docker not installed or not in PATH. Install Docker or disable sandbox mode to fix immediately.

resolveControlUiDistIndexPath fails after npm install -g. Assets exist but resolver can't find them.

Remote CDP profiles rejected with false "port in use but not by openclaw" error.

systemctl --user unavailable on EC2/headless servers. Enable linger or use system-level service.

@openclaw/feishu not on npm registry. Use local install or build from source.

allowInsecureAuth ignored behind reverse proxy. Fix: add trustedProxies to config.

setGlobalDispatcher breaks all proxy-dependent connections. Downgrade to 2.23 or upgrade to patched version.

Persistent 400 error loop when using OpenAI reasoning models. Orphaned rs_... item in conversation history.

Fix npm install failures: Node.js version too old, corrupted cache, permissions, or network issues.

Fix "unsafe plugin manifest path" when using pnpm to install OpenClaw globally.

Fix spawn EINVAL when running openclaw plugins install on Windows. PowerShell policy, PATH, and Node.js fixes.

Fix OpenRouter 403 model not allowed and 429 rate limit errors. Configure fallback models and add credits.

Fix "Gemini CLI OAuth failed" — add gemini to PATH, re-authenticate, or switch to API key auth.

Fix Discord gateway close code 4014 crash loop. Enable MESSAGE_CONTENT intent in Discord Developer Portal.

Fix skill install failures in Docker containers where Homebrew is unavailable. Pre-install deps with apt-get.

Fix "channels.discord.modelByChannel: Unrecognized key" in OpenClaw 2026.2.21+. Update config to array format.

Fix intermittent act() timeouts when open/snapshot succeed. Kill zombie Chrome process and clear isolated profile.

Fix minimax-portal OAuth 401 introduced in OpenClaw 2026.2.26. Regenerate API key and update credentials.

Fix "DBUS_SESSION_BUS_ADDRESS not defined" when OpenClaw onboarding fails to install systemd user service on Ubuntu 22.04. Enable linger and install manually.

Fix macOS "launchctl bootstrap failed: Could not find domain for user gui: 1000" when installing OpenClaw gateway via SSH or headless. Use brew services or LaunchDaemon.

Fix browser control server hanging indefinitely on POST /start on Ubuntu x64. Chromium sandbox, Xvfb, and headless mode fixes.

Fix Telegram bot showing "typing..." indefinitely after OpenClaw sends a response. Missing sendChatAction cancellation on completion.

Fix Telegram plugin "Network request failed" (Node HTTPS timeout) after upgrading from v2026.2.23 to v2026.2.26. Node dispatcher regression fix.

Fix "embedded run timeout" when connecting to a local LLM (LM Studio, llama.cpp, vLLM) that responds fine to curl. Binding, timeout, and provider config fixes.

Fix OpenClaw v2026.2.26 failing on Intel Macs ("not supported on this Mac"). Regressed from universal binary. Use npm CLI workaround.

Fix 400 errors from Gemini models when OpenClaw sends OpenAI-format requests. Add google/ prefix to model name and configure provider.

Fix HTTP 421 errors with GitHub Copilot Enterprise. Enterprise accounts require org-specific endpoints and enterprise-scoped PATs.

Fix Browser Relay Chrome extension 401 token rejection after upgrade. Extension now expects a derived token from /json/version, not the raw gateway token.

Stuck with LLM request timed out errors in OpenClaw? Learn how to fix the idleTimeoutSettings to stop requests from dropping during inference.

Agent crashes on OpenClaw 2026.3.23 with missing light-runtime-api error. Remove the WhatsApp plugin or remove it from configuration to fix.

Troubleshoot 'refresh_token_reused' errors in OpenClaw. Learn how to resolve OAuth race conditions causing model failovers.

Stuck with Matrix Plugin API Version Mismatch in OpenClaw? Learn how to resolve the config validation error caused by the v2026.3.22 upgrade.

Troubleshooting the 'device identity required' error in OpenClaw v2026.3.12 and v2026.3.13 when using LAN token-only access.

Struggling with Qwen-Portal OAuth in OpenClaw? Learn how to handle the token refresh failure error causing frequent forced re-authentications.

Stuck with the "Reasoning is required" error in OpenClaw v2026.3.28? Quickly resolve it by updating your agent thinking default in dashboard settings.

Troubleshoot OpenClaw connection errors in Docker. Learn how to fix the ECONNREFUSED gateway unreachable issue by modifying your network configuration.

Resolving the 423 VirusTotal scan pending error in OpenClaw. This is a local file path bug, not a server security issue. Follow the steps for a workaround.

Troubleshoot the OpenClaw Control UI 'device identity required' WebSocket error caused by browser navigation resets in version 2026.3.7.

Resolving the Control UI assets not found error in OpenClaw v2026.3.22 caused by missing production bundles in the npm package.

Stop OpenClaw from batching progress updates. Learn why your messages arrive all at once and how to handle agent turn completion.

The v2026.3.22 OpenClaw npm package is missing critical UI assets. Fix the 503 error by manually restoring the directory from the previous version.

Resolving EADDRINUSE port conflicts in the OpenClaw voice-call plugin. Learn how to clear hung runtime promises and fix webhook server binding.

Resolving the OpenClaw 2026.3.12 gateway handshake timeout error after the 3s default timer reduction. Quick fixes for CLI connection issues.

Stuck with Kimi exec(...) literal text in OpenClaw 2026.3.7? Learn why this regression happens and how to roll back to 2026.3.2.

Stuck in an OpenClaw crash loop with EADDRINUSE? Learn why the nextcloud-talk plugin fails to bind port 8788 and how to fix it by downgrading.

Stuck in lane wait exceeded on OpenClaw 2026.3.8? Manual cron triggers are failing due to a regression. Downgrade to 2026.3.7 to resolve immediately.

Stuck with 'Model openai-codex/gpt-5.4 is not allowed' in OpenClaw? Learn how to refresh your OAuth session to access the latest model updates.

Troubleshooting silent iMessage failures and FDA propagation issues in OpenClaw on macOS 26. Learn how to resolve gateway startup errors.

Troubleshooting the OpenClaw browser bridge timeout when running inside Docker. Learn how to force the bridge to listen on 0.0.0.0 for container access.

Struggling with slow Telegram responses in OpenClaw 2026.2.15? Learn why the new 1000ms throttle impacts UX and how to revert to 2026.2.14.

Stuck on 'device identity required' in OpenClaw LAN mode? Learn why insecure contexts drop auth tokens and how to resolve it.

Cron jobs timing out in isolated sessions after OpenClaw 2026.3.8? This guide explains the tool-call regression and how to diagnose it.

Fix OpenClaw JavaScript heap out of memory errors on 4GB servers after v2026.3.7. Roll back OpenClaw or switch Node.js versions.

Fix the OpenClaw Control UI error triangle and missing input box when switching to the main session. Resolve unusable main session in version 2026.3.12.

Fix Mistral provider 422 (no body) errors in OpenClaw. Occurs in v2026.3.8+, resolved by downgrading or waiting for update.

Fix the 'node command not allowed: the node does not support "system.run.prepare"' error on macOS nodes in OpenClaw. Learn why it happens and the current workaround.

Fix severe 60s hangs in OpenClaw's google-gemini-cli tool calls. Learn why it happens and the workaround using an API proxy or updated settings.

Fix OpenClaw tool invocation failures where agents claim to execute but no calls are made. Resolve silent errors withkimi-coding/k2p5 models.

Fix OpenClaw's `sessions_spawn` blocked by config schema mismatch. The runtime expects 'agents.defaults.subagents.allowAgents', but the schema rejects it. Update your schema.

Fix session lock timeout errors in OpenClaw. When agents take too long, handlers fail. Learn the cause and how to prevent it.

Troubleshoot intermittent 'API provider billing error' in OpenClaw. Learn the fix for misleading messages and lost responses, often related to regex issues.

Fix OpenClaw 2026.3.2 error where openai-codex/gpt-5.4 is listed but fails with Unknown model/HTTP 404. This is a release gap; update to a newer version.

Fix OpenClaw "Tool not found" or timeout errors in Telegram. Learn why restricted tool profiles cause this and how to set the 'coding' profile.

Fix OpenClaw 2026.2.21 Control UI error: 'allowInsecureAuth' no longer works for token-only HTTP. Use HTTPS with Nginx.

Fix OpenClaw Kimi K2.5 config validation errors related to 'requiresOpenAiAnthropicToolPayload'. Upgrade to the latest version.

Fix OpenClaw config error 'Unrecognized key: requiresOpenAiAnthropicToolPayload'. Temporary workaround: edit openclaw.json or use clawaid.

Resolving the "Cannot find module @larksuiteoapi/node-sdk" error during Feishu onboarding with OpenClaw v2026.3.7. Fix involves installing dependencies.

Fix OpenClaw model fallback errors when primary LLM hits a 429 rate limit. Learn why it happens and how to ensure your agents retry with fallback models.

Fixes for the 'systemctl is-enabled unavailable' error in OpenClaw 2026.3.2 on Ubuntu 24.04. Learn the cause and how to resolve it.

Troubleshoot "401 missing authentication headers" errors in OpenClaw after a VM reinstall. Switch to the 'coding' tools profile for a quick fix.

Fix 'Unknown model: google-gemini-cli/gemini-3.1-pro-preview' in OpenClaw. Add gemini-3.1-pro-preview to provider model catalog.

Troubleshoot OpenClaw's google-gemini-cli 429 errors. Learn how model-specific rate limits kill fallbacks and get the workaround.