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
execprocess 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
replyBroadcastsupport 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.
- Added
- Telegram Integration:
- Fixed thinking status defaults in the
/statusand/thinkmenus to correctly reflect model defaults and session overrides. - Added support for forcing video media to be sent as documents to avoid compression.
- Fixed thinking status defaults in the
- 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/propsendpoint, providing more accurate token usage metrics. - OpenAI-compatible: Improved streaming transport to drain split frames, preventing stalled sessions during high-latency responses.
- llama.cpp: Now supports opportunistic discovery of the actual loaded runtime context (
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.mdduring dreaming promotions to prevent unbounded file growth and potential gateway freezes. - Cron Enhancements: Added a direct
cron.getpath (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.mdcould grow unboundedly, leading to bootstrap overflow and gateway freezes (#73691). - Subagent Orphanage: Resolved an issue where subagents lost references to running
execprocesses after session compaction (#79284). - Gateway Stability: Fixed a race condition in gateway inflight deduplication for
sendandpollrequests (#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.resolvecalls 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.yamlconfiguration. - Memory-Wiki Scopes: The
wiki.ingestmethod now requiresoperator.adminscope, andwiki.obsidian.searchnow requiresoperator.writescope. Users with restricted gateway tokens may need to elevate their permissions to continue using these features.