openclaw.troubleshoot()

// Root cause: v2026.3.2 security rewrite — tools.profile defaults changed to session-only read

// Root cause: Fraudulent GitHub repos distribute infostealers (GhostSocks, Atomic macOS Stealer) disguised as OpenClaw

// Root cause: Both sudo npm install -g and user npm install -g exist — wrong binary wins in PATH

// Root cause: Ubuntu server / root: systemctl --user not available, Homebrew missing

// Root cause: Provider RPM/TPM limit hit — OpenAI, Anthropic, Gemini all affected

// Root cause: Gateway restart re-creates sessions instead of restoring from sessions.json

// Root cause: QR code session expires / Baileys auth file corrupted

// Root cause: API key missing, expired, or no billing — sk-ant- prefix required

// Root cause: Node.js <22.14 causes syntax errors, native module build failures, and tsx crashes

// Root cause: Stale OPENCLAW_GATEWAY_TOKEN in systemd/.env overrides openclaw.json — device token mismatch after upgrade

// Root cause: Message Content Intent not enabled in Discord Developer Portal — bot reads no messages

// Root cause: Third-party plugins (e.g. lossless-claw) incompatible with ContextEngine v2 after v2026.4.14

// Root cause: Dreaming leaves thousands of orphaned temp sessions in ~/.openclaw/agents/main/sessions/

// Root cause: npm tries to install globally into C:\Program Files\nodejs — EACCES / EPERM

// Root cause: Post-upgrade gateway crash — sourcePath/installPath point to old directory structure

// Root cause: Install and permission errors confined to one OS — Linux Homebrew, Windows tsx, Raspberry Pi permissions, macOS screen recording, Windows Control UI toggles

// Root cause: Gateway re-registers channel state on restart without clearing it — duplicate commands, heartbeat DM leaks, merged streaming replies

// Root cause: Running on CPU only, wrong context length, wrong quantization

// Root cause: Model loaded fully in RAM, large context window, no swap

// Root cause: launchd plist missing or not loaded — gateway not auto-starting on Mac

// Root cause: Another process or old container is holding the port

// Root cause: Browser: WebSocket disconnect loop — stale auth token / missing origin header