[Release] openclaw/openclaw v2026.5.25-beta.1: openclaw 2026.5.25-beta.1

OpenClaw v2026.5.25-beta.1 is a maintenance release focusing on bug fixes and platform compatibility improvements. Key fixes address iMessage attachment handling, Windows native support for package scripts, Alpine Linux installer compatibility, and MCP server timeout issues. The release includes numerous test infrastructure improvements and configuration enhancements to ensure stability across Linux, macOS, and Windows platforms.

Key Points

• •iMessage attachment handling now threads current channel/account inbound attachment roots through the image tool, allowing attachments under ~/Library/Messages/Attachments to be read via existing inbound path policy instead of being rejected
• •Fixed iMessage watcher startup deduplication when channels.imessage.accounts lists both default and named accounts pointing to the same local Messages source, preventing duplicate imsg rpc processes
• •Alpine Linux installer now uses apk Node.js, npm, and Git packages instead of downloading glibc Node tarballs that fail with node:sqlite
• •Windows native support improved by routing Node package scripts through cross-platform launcher for gateway, TUI, Docker, and formatting entrypoints
• •MCP server timeout issue resolved by bounding bundled MCP tools/list catalog discovery to prevent hung servers from blocking session tool materialization
• •Plugin development restored on native Windows by allowing linked local plugin paths to probe TypeScript source entries without requiring compiled package output
• •CLI output integrity fixed by routing source-checkout build output to stderr before launching OpenClaw commands to prevent stale builds from corrupting --json stdout
• •Provider fallback performance improved through caching manifest-backed CLI provider descriptors and fallback provider resolution to avoid repeated bundled provider runtime scans
• •Test infrastructure enhanced with Windows compatibility fixes for Vitest, Docker E2E harness containers, and credential helper operations
• •Configuration validation improved to allow exec SecretRef ids with # selectors for AWS-style secret#json_key identifiers

Workflow Diagram

Concepts