[Release] openclaw/openclaw v2026.5.12-beta.4: openclaw 2026.5.12-beta.4

OpenClaw v2026.5.12-beta.4 is a maintenance release addressing runtime issues, authentication flows, and provider integrations. Key fixes include resolving MODULE_NOT_FOUND errors in Codex migrations, improving WhatsApp/Telegram message handling, and normalizing Google Gemini model IDs. The release also enhances session management, adds per-agent tool policies, and improves error messaging across multiple channels and providers.

Key Points

• •Fixed Codex runtime MODULE_NOT_FOUND errors by allowing official @openclaw/codex package to use private task-runtime SDK helpers
• •Improved Codex migration UX: Enter key now activates highlighted checkbox rows, enabling Skip/bulk-selection functionality
• •Resolved auth-profile-backed media tools (image_generate) availability when OpenAI auth is stored in agent's auth-profile instead of environment variables
• •Fixed WhatsApp/Telegram message handling: Baileys libsignal compatibility under pnpm 11, HTML tag preservation in Telegram replies, and pending message debouncing before socket closure
• •Enhanced session management: nested subagent sessions under parent sessions with visual prefix (└─) in session picker dropdown
• •Added per-sender tool policies with channel-scoped sender keys to restrict dangerous tools by requester identity across all tool surfaces
• •Normalized Google Gemini 3 Pro Preview model IDs to google/gemini-3.1-pro-preview across SDK OAuth, CLI auth, and provider catalog flows
• •Improved error handling: surface visible errors when model backend fails with fallback, rewrite generic provider errors with support request IDs
• •Added cron job inspection support: direct cron.get command and agent-tool get for inspecting stored cron jobs by ID
• •Enhanced Gateway/OpenAI HTTP compatibility: honor max_completion_tokens and max_tokens on inbound /v1/chat/completions requests

Workflow Diagram

Concepts