← Back to Blogs
GH Release

OpenClaw v2026.5.12-beta.3 Release Summary

321508855 May 12, 2026

OpenClaw v2026.5.12-beta.3 Release Summary

Key Changes

This release focuses on expanding the capabilities of the Plugin SDK, refining the orchestration of subagents, and hardening the stability of various channel integrations. A major highlight is the introduction of new workflow seams in the Plugin SDK, allowing developers to create more complex, host-mediated agent behaviors.

Plugin SDK & Workflow Enhancements

  • New Workflow Seams: 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.
  • Finalize Retry Support: Plugins can now request bounded retries before a reply is finalized, enabling more robust quality control for agent outputs.
  • Priority Queuing: Queued next-turn injections now support priority levels, allowing critical updates to be processed ahead of standard turns.

Agent & Session Orchestration

  • Subagent Session Management: Subagent sessions are now visually nested under their parent sessions in the Control UI using a └– prefix, making complex agent hierarchies easier to navigate.
  • Exec Reference Preservation: Background exec process references are now preserved across session compaction, ensuring that long-running tasks are not orphaned when the context window is refreshed.
  • Subagent Heartbeat Optimization: Redundant heartbeat wake-ups for subagent session completions have been skipped to prevent spurious LLM invocations on parent sessions.

Channel & Provider Updates

  • Slack Integration:
    • Added replyBroadcast support for thread replies, allowing agents to post to both a thread and the parent channel.
    • Implemented allowBots: "mentions" mode to prevent infinite reply loops in multi-agent environments.
    • Improved file attachment handling in DMs by fetching fresh download URLs via files.info.
  • Telegram Integration:
    • Fixed thinking status defaults in the /status and /think menus to correctly reflect model defaults and session overrides.
    • Added support for forcing video media to be sent as documents to avoid compression.
  • iMessage Integration: Added support for tapback reaction forwarding as inbound agent events.
  • Model Providers:
    • llama.cpp: Now supports opportunistic discovery of the actual loaded runtime context (n_ctx) via the /props endpoint, providing more accurate token usage metrics.
    • OpenAI-compatible: Improved streaming transport to drain split frames, preventing stalled sessions during high-latency responses.

Infrastructure & Tooling

  • pnpm 11 Upgrade: The workspace has been upgraded to pnpm 11, aligning project settings and build allowlists within pnpm-workspace.yaml.
  • Memory Management: Introduced a bounded compaction step for MEMORY.md during dreaming promotions to prevent unbounded file growth and potential gateway freezes.
  • Cron Enhancements: Added a direct cron.get path (via CLI and Gateway RPC) for inspecting single stored cron jobs by ID.

Impact

Fixed Issues

  • Memory Leak/Growth: Fixed a critical bug where MEMORY.md could grow unboundedly, leading to bootstrap overflow and gateway freezes (#73691).
  • Subagent Orphanage: Resolved an issue where subagents lost references to running exec processes after session compaction (#79284).
  • Gateway Stability: Fixed a race condition in gateway inflight deduplication for send and poll requests (#68341).
  • TUI Responsiveness: Fixed a hang where the TUI became unresponsive to Ctrl+C/SIGINT after a gateway disconnect (#75379).
  • Security: Redacted sensitive WhatsApp/libsignal session material from raw gateway terminal logs to prevent secret exposure (#76306).

Performance Improvements

  • Streaming Efficiency: Gateway streaming fan-out now shares serialized event envelopes across recipients, reducing redundant JSON serialization on the hot path (#80299).
  • Session Resolution: Scoped sessions.resolve calls now only load the requested agent's store rather than loading all agent stores simultaneously, significantly reducing memory pressure (#51264).

Upgrade Guide

Breaking Changes & Migration

  • pnpm 11: Users performing source installs must upgrade to pnpm 11. The bootstrap process has been updated to handle the new pnpm-workspace.yaml configuration.
  • Memory-Wiki Scopes: The wiki.ingest method now requires operator.admin scope, and wiki.obsidian.search now requires operator.write scope. Users with restricted gateway tokens may need to elevate their permissions to continue using these features.

References

Pull Requests