OpenClaw v2026.3.22 Release Guide: 45 New Features + 13 Breaking Changes You Need to Know
OpenClaw v2026.3.22 ships 45+ new features, 13 breaking changes, and 82 bug fixes. This guide covers ClawHub skills marketplace, multi-model support, pluggable sandboxes, and a complete upgrade walkthrough.
OpenClaw v2026.3.22 Release Guide: 45 New Features + 13 Breaking Changes You Need to Know
Last updated: April 16, 2026
Should you upgrade to OpenClaw v2026.3.22? Short answer: yes, but run openclaw doctor --fix immediately after. This release ships native ClawHub skills marketplace, 48-hour agent timeout (up from 10 minutes), and pluggable sandboxes (SSH + OpenShell), while removing the legacy .moltbot directory and CLAWDBOT_* / MOLTBOT_* env vars — doctor --fix handles most of the 13 breaking-change migrations automatically.
"They used to ship every 1-2 days — the community was totally spoiled." After a 10-day gap, the lobster just dropped its biggest update ever.
OpenClaw v2026.3.22, released on March 23, 2026, brings 45+ new features, 13 breaking changes, 82 bug fixes, 20 security patches, and 15 performance improvements — earning 294 reactions on GitHub. The Chinese tech community called it "the most powerful update in history," while Linux DO helpfully tagged it "update with caution."
This guide helps you understand: what changed, whether it affects you, and how to upgrade safely.
Related reading: OpenClaw + bibigpt-skill Complete Guide (March 2026 Update) | OpenClaw 250K Stars: How BibiGPT Wins in the Agent Era | bibigpt-skill: give Claude / OpenClaw video understanding
Five Major New Features: The Highlights
1. ClawHub Skills Marketplace Goes Native
The single biggest change in this release. openclaw plugins install now prioritizes ClawHub over npm, falling back to npm only when a package isn't found on ClawHub. Full skill management commands are now available:
# Search for skills
openclaw skills search <keyword>
# One-click install
openclaw skills install <skill-name>
# Check for updates
openclaw skills update
Even more notable: cross-ecosystem compatibility. ClawHub can discover and import skill packages from Claude, Codex, and Cursor, automatically mapping them into OpenClaw format. That's 4,000+ community skills at your fingertips.
2. Agent Timeout Jumps to 48 Hours
Default agent timeout goes from 10 minutes to 48 hours with zero configuration changes. Batch jobs, long documents, complex workflows — no more mid-task disconnections.
3. Pluggable Sandbox Backends (OpenShell + SSH)
The sandbox execution environment now supports pluggable backends. The first two: SSH and OpenShell, with mirror and remote workspace modes.
In practice: your agent can now SSH into remote machines and execute tasks directly. No more workarounds for running jobs on servers.
4. Massive Model Ecosystem Expansion
This release covers virtually every major LLM provider:
- Anthropic Vertex AI: Call Claude through Google Vertex AI (no longer limited to direct Anthropic API)
- OpenAI: Default model upgraded to gpt-5.4, with forward-compat for gpt-5.4-mini and gpt-5.4-nano
- MiniMax: Default upgraded from M2.5 to M2.7, with high-speed mode
- xAI Grok: Synced to latest Pi-backed Grok model family
- Z.AI: Added GLM 4.5/4.6 series
- Xiaomi: Switched to v1 API, added MiMo V2 Pro and MiMo V2 Omni
- Mistral: Updated pricing and model metadata
- GitHub Copilot: Forward-compatible dynamic model IDs
Bottom line: use whatever LLM you want — OpenClaw handles the integration.
5. Built-in Web Search Triple Pack
Exa, Tavily, and Firecrawl ship as first-party built-in plugins. Your agent finally has reliable native search capabilities without third-party configuration headaches.
Try pasting your video link
Supports YouTube, Bilibili, TikTok, Xiaohongshu and 30+ platforms
13 Breaking Changes Explained — Read Before Upgrading
If you're wondering "should I update?", this table has your answer:
| # | Change | Who's Affected | What to Do |
|---|---|---|---|
| 1 | ClawHub over npm | Plugin installs | Usually transparent; npm fallback still works |
| 2 | Chrome MCP legacy path removed | Browser integration users | Run openclaw doctor --fix |
| 3 | Plugin SDK → openclaw/plugin-sdk/* | Skill developers | Follow migration docs |
| 4 | nano-banana-pro removed | Image generation users | Switch to agents.defaults.imageGenerationModel |
| 5 | CLAWDBOT_* / MOLTBOT_* env vars removed | All legacy config users | Rename to OPENCLAW_* |
| 6 | .moltbot directory removed | Early adopters | Migrate to ~/.openclaw |
| 7 | Matrix plugin rewritten | Matrix users | Follow migration guide |
| 8 | Discord command deployment change | Discord users | Usually transparent |
| 9 | Sandbox env var injection blocked | Developers | MAVEN_OPTS/SBT_OPTS/GRADLE_OPTS no longer pass through |
| 10 | Message discovery API change | Plugin developers | Use describeMessageTool(...) |
| 11 | Image generation tool standardized | Image generation users | Use image_generate tool |
| 12 | Voice-call webhook hardened | Voice call users | Ensure provider signature headers are correct |
| 13 | Agent media reply refactor | Plugin developers | Use details.media path |
Recommended Upgrade Path
# 1. Update OpenClaw
openclaw update
# 2. Auto-fix most breaking changes
openclaw doctor --fix
# 3. Verify everything works
openclaw status
Important: If you're still using the
.moltbotdirectory orCLAWDBOT_*/MOLTBOT_*environment variables, you must migrate now — there's no fallback path.
20+ Messaging Platform Enhancements
Nearly every major platform got improvements:
- Matrix (new): Official
matrix-js-sdkplugin with bot conversations, mention gating, bot-to-bot chat, and private networks - Telegram: Custom Bot API endpoints, auto topic labels, topic editing, silent error replies
- Feishu/Lark: Structured approval cards, ACP support, reasoning stream rendering
- Discord: Carbon reconcile command deployment, component auth fixes
- Slack:
@slack/boltstartup stability fixes - WhatsApp: Reconnect mechanism fixes, credential handling improvements
- Android: System-aware dark theme, call log search, SMS search, camera memory optimization
- Mattermost: Thread reply mode
offsupport, DM retry mechanism - WeChat/WeCom/QQ/DingTalk: Community plugins listed in official docs
Security + Performance Highlights
Security (20+ Fixes)
The largest security release in OpenClaw history:
- Windows SMB credential protection: Blocks remote
file://URLs and UNC paths - Unicode hidden text detection: Escapes blank Hangul filler in exec approval prompts
- Nostr DM security: Enforces DM policy before decryption with rate/size guards
- Device pairing hardening: Binds iOS setup codes to intended node profiles
- SSRF policy enforcement: Comprehensive hardening across browser and network layers
Performance (15+ Improvements)
- Gateway startup: Loads from compiled
dist, WhatsApp cold-start drops from tens of seconds to seconds - Provider discovery lazy-loading: No more preloading all providers at startup
- Model catalog caching: Caches by config state to avoid repeated startup work
- Telegram message latency: Normal replies no longer rebuild the full model catalog
- CLI startup optimization: Lazy-loading for help and channel-add paths
Top 5 ClawHub Skills to Install After Upgrading
With ClawHub now built in, discovering and installing skills has never been easier. Here are 5 worth grabbing right after your v2026.3.22 upgrade:
1. bibigpt-skill — AI Video Summary
Supports 30+ platforms including Bilibili, YouTube, TikTok, Xiaohongshu, and podcasts. OpenClaw's native summarize only covers YouTube — bibigpt-skill fills the gap for everything else. Trusted by over 1 million users with over 5 million AI summaries generated.
openclaw skills install bibigpt-skill
# Use it right away
@OpenClaw summarize this video with bibi https://www.youtube.com/watch?v=xxx
2. Context7 — Live Library Docs
Fetches up-to-date documentation and code examples while you code. No more outdated APIs.
3. web-search — Enhanced Search
Works alongside built-in Exa/Tavily/Firecrawl for deeper information retrieval.
4. notion-connector — Bidirectional Notion Sync
Sync your agent's work directly to Notion for seamless knowledge management.
5. github-pr-review — Automated PR Review
Let your agent review code and catch issues before they ship.
See BibiGPT's AI Summary in Action
Bilibili: GPT-4 & Workflow Revolution
A deep-dive explainer on how GPT-4 transforms work, covering model internals, training stages, and the societal shift ahead.
Want to summarize your own videos?
BibiGPT supports YouTube, Bilibili, TikTok and 30+ platforms with one-click AI summaries
Try BibiGPT FreeFrequently Asked Questions
OpenClaw v2026.3.22 upgrade FAQ: compatibility, breaking-change handling, and ClawHub integration tips.
Q: Can I jump from an older release (e.g. v2026.3.10) straight to v2026.3.22?
A: Yes — but always run openclaw doctor --fix immediately afterward. The doctor migrates .moltbot to ~/.openclaw, rewrites legacy env vars to the OPENCLAW_* prefix, and removes Chrome MCP's old paths. If you're skipping multiple versions, scan the 13-row breaking-change table first.
Q: Do Claude / Codex / Cursor plugins from ClawHub really work out of the box?
A: Yes. ClawHub ships with an automatic format-mapping layer — most pure-logic plugins (search, translation, format conversion) run unchanged; plugins that depend on host-native APIs are flagged with a "compatibility" badge. bibigpt-skill, Context7, and notion-connector are all fully verified through ClawHub.
Q: Does the 48-hour agent timeout cost more? A: No. The timeout only allows tasks to run longer — billing is still based on model token usage. The 48-hour window is ideal for long video processing, batch translations, or continuous scraping — workflows that previously needed manual chunking can now run end-to-end.
Q: How do I make OpenClaw summarize Bilibili / Douyin / YouTube videos automatically?
A: Install bibigpt-skill: openclaw skills install bibigpt-skill, then prompt with @OpenClaw use bibi to summarize this video <URL>. OpenClaw's built-in summarize only handles YouTube — bibigpt-skill extends AI video summarization to Bilibili, Douyin, Xiaohongshu, podcasts, and 30+ other platforms.
Q: I'm seeing "Cannot find .moltbot directory" after upgrading — what now?
A: That's Breaking Change #6. Run openclaw doctor --fix to migrate ~/.moltbot to ~/.openclaw (configs, skill cache, and session history). If doctor fails, the manual fallback is mv ~/.moltbot ~/.openclaw.
Wrapping Up
OpenClaw v2026.3.22 is the biggest update to date. ClawHub transforms the skill ecosystem, 48-hour agent timeout unlocks long-running tasks, pluggable sandboxes with SSH open up remote execution, and full multi-model coverage means you're never locked into a single provider.
Yes, 13 breaking changes sounds scary — but openclaw doctor --fix handles most of them. If you've been putting off migrating from .moltbot and legacy env vars, now's the time.
After upgrading, take ClawHub for a spin — 4,000+ skills are waiting. bibigpt-skill is the canonical pick for adding video understanding to OpenClaw.
Related reading:
Pair OpenClaw with BibiGPT video skills
One-line install for bibigpt-skill — let OpenClaw understand Bilibili, YouTube, Douyin, and 30+ video platforms
Experience BibiGPT now
Ready to try these powerful features? Visit BibiGPT and start your intelligent audio/video summarization journey!
Get started