OpenClaw v2026.5.12-beta.2 Release Summary

Key Changes

This release focuses on expanding the extensibility of the Plugin SDK, improving the observability of agent sessions, and hardening the core runtime against memory leaks and streaming stalls.

Plugin SDK & Workflow Enhancements

One of the most significant additions is the introduction of workflow seams in the Plugin SDK. Plugins can now register typed session actions, send session-bound attachments through host-owned delivery, and schedule future session turns via the existing cron-compatible scheduler. This allows for the creation of complex plugin archetypes, such as deploy approvers, budget guards, and SLA watchers, without requiring deep access to the runner internals.

Session & Gateway Observability

• ACP Lineage Metadata: The Agent Client Protocol (ACP) now exposes Gateway session lineage (parent/child relationships) under _meta. This enables ACP clients to render subagent graphs without requiring private Gateway side channels.
• Session Management: The Control UI now nests subagent sessions under their parent sessions using a visual └– prefix, making the hierarchy clear in the session picker.
• Context Mapping: A new /context map command provides a WinDirStat-style treemap image of current session context contributors, offering a visual representation of what is occupying the model's context window.

Provider & Model Improvements

• Llama.cpp Integration: Self-hosted OpenAI-compatible providers now opportunistically discover the actual loaded runtime context window via the /props endpoint, ensuring that session budgeting reflects the server's current configuration rather than just the training ceiling.
• Streaming Stability: A critical fix was implemented to drain split provider response chunks in the sanitizer. This prevents sessions from stalling when the OpenAI SDK receives partial SSE events or JSON bodies.
• Model Fallbacks: The auto-reply runner now surfaces visible operational errors when a configured model backend fails and the fallback produces no visible reply, eliminating "silent" failures.

Memory & Core Stability

• Memory Budgeting: To prevent unbounded growth of MEMORY.md during dreaming promotions, a bounded compaction step has been introduced. Older auto-promoted sections are now dropped by date to keep the file under a default 10,000-character budget, while user-authored content remains untouched.
• System Event Deduplication: The enqueueSystemEvent logic now dedupes keyed events across the entire queue based on text and context keys. This prevents the "approval cascade" where repeated failovers trigger duplicate exec approval prompts.

Impact

Fixed Issues

• Memory Leaks: Fixed a memory leak in the Gateway where unregistered node IDs leaked permanent throttle entries in the nodeWakeById map (#68847).
• OOM Prevention: Resolved a high-severity issue where loadCombinedSessionStoreForGateway eagerly loaded all agent session stores, causing OOM crashes in environments with many agents (#51264).
• TUI Responsiveness: Fixed a bug where the TUI became unresponsive to Ctrl+C/SIGINT after a gateway WebSocket disconnect (#75379).
• Tooling Reliability: Fixed a crash in the read tool when offsets exceeded the end of the file (#62466).
• Slack Integration: Resolved an issue where file attachments in Slack DMs were silently dropped due to missing download URLs (#50129).

Security Hardening

• Log Redaction: The Gateway now installs console capture before command parsing to prevent sensitive WhatsApp/libsignal session material from leaking into raw terminal logs.
• Administrative Scoping: The wiki.ingest method now requires operator.admin scope to prevent unauthorized local file imports.
• Safe-Bin Matching: Trust checks for safe-bin directories are now case-insensitive on macOS and Windows, preventing false-positive warnings on those platforms.

Upgrade Guide

Breaking Changes & Migration

• pnpm 11 Upgrade: The workspace has been upgraded to pnpm 11. Users performing source installs or using custom Docker workflows should ensure they are using pnpm 11. Project settings have moved to pnpm-workspace.yaml.
• Memory Compaction: Users with dreaming.enabled: true may notice a one-time compaction of their MEMORY.md file upon the first run after upgrading, as the system brings the file under the 10KB budget. User-authored notes are preserved.
• GitHub CLI Auth: If you are running the Gateway as a service (e.g., via systemd) and the gh CLI is authenticated under a different user's HOME, you may need to set the GH_CONFIG_DIR environment variable in your service configuration to point to the authenticated config directory.