🚨 Breaking Changes Alert — March 2026

OpenClaw v2026.3.22 Migration Guide:
Fix Every Breaking Change

March 2026 · 8 min read · Updated as new issues surface
TL;DR: v2026.3.22 shipped 12 breaking changes. Run openclaw doctor --fix first — that handles ~60% of issues automatically. This guide covers the rest.

OpenClaw v2026.3.22 is the biggest release of 2026 — but it shipped with 12 breaking changes that silently broke thousands of existing setups overnight. If your agent stopped working after updating (or you're too scared to update), this guide covers every issue and exactly how to fix it.

⚠️ Before you do anything: Run openclaw doctor --fix. This auto-fixes ~60% of migration issues. Then work through this guide for anything still broken. 
openclaw doctor --fix

The 5 Most Common Breaking Changes

1

Legacy Config Keys Now Fail Validation

Old config keys (ClawdBot, MoltBot environment variables, legacy channel formats) used to be silently ignored. Now they fail validation and prevent your agent from starting — often with no clear error message.

Symptoms:

✅ Fix
# Check which keys are failing
openclaw config validate --verbose

# Let doctor fix what it can
openclaw doctor --fix

# Then restart
openclaw restart

Specific keys to remove from openclaw.json if present:

2

ClawHub is Now the Default Plugin Store

Plugin installs now route through ClawHub natively. Skills installed via npm won't appear in openclaw skills list until re-registered.

Symptoms:

✅ Fix
# Sync all installed skills with ClawHub registry
openclaw skills sync

# Fix Unicode slug issues (known bug)
openclaw skills repair --fix-slugs

# Verify everything registered
openclaw skills list --all

Skills not on ClawHub still work — they just need manual registration after install:

npm install -g @yourorg/your-skill
openclaw skills register @yourorg/your-skill
3

Browser Automation / Chrome Extension Relay Removed

The legacy Chrome extension relay path is completely removed. If you used browser automation, your entire browser workflow needs reconfiguration from scratch.

Symptoms:

✅ Fix
# Remove old extension config
openclaw doctor --fix

# Reconfigure for new CDP approach
openclaw browser setup

# Verify
openclaw browser status

The new CDP approach is actually more stable — no Chrome extension needed. Reconfiguration takes ~10 minutes.

4

Old Config Migrations Dropped (2+ Months Old)

OpenClaw no longer auto-migrates configs older than 2 months. Very old legacy keys that used to be quietly rewritten now fail validation instead.

Who's affected: Anyone running OpenClaw since before January 2026 without a fresh config rebuild.

✅ Fix
openclaw config validate --verbose
openclaw doctor --fix
# Manually remove any remaining flagged keys
5

Skills Commands Restructured

Several skills commands were renamed. Scripts and automations using old commands will fail silently.

Old CommandNew Command
openclaw skill installopenclaw skills install
openclaw skill listopenclaw skills list
openclaw skill updateopenclaw skills update
openclaw plugin installopenclaw skills install
✅ Fix

Update any scripts using old command names. The new skills (plural) format is permanent.

The Complete Migration Checklist

Run through this in order ↓

  1. Step 1: Run doctor 
    openclaw doctor --fix
  2. Step 2: Validate config 
    openclaw config validate --verbose
    Fix any flagged keys manually, then run doctor again.
  3. Step 3: Sync skills 
    openclaw skills sync
openclaw skills list --all
    Verify all your skills appear.
  4. Step 4: Check browser (if you use it) 
    openclaw browser status
    If broken: openclaw browser setup
  5. Step 5: Restart and verify 
    openclaw restart
openclaw status
  6. Step 6: Test your workflows Send a test message. Check heartbeat fired. Verify your most-used skills work.

Should You Update?

💡 Recommendation: If you're on 3.21 or earlier and your setup is working — skip straight to 3.23. It's the stabilization patch with a much smoother migration path. 
# Skip 3.22 entirely — install 3.23 directly
npm install -g openclaw@2026.3.23
openclaw doctor --fix

What 3.22 Actually Adds (Once You're Past the Migration)

🏪
ClawHub Native One-command skill installs from the official marketplace
🔌
Plugin SDK Build and publish your own plugins publicly
🤖
Auto-maps Skills Imports existing Claude, Codex, and Cursor tool configs
🔒
30+ Security Patches Including Windows SMB credential hardening
⚡
Faster Gateway Cold start time cut from minutes to seconds
🔍
Bundled Plugins Web-search and Matrix plugins included by default

Worth it once you're past the migration. The ClawHub integration alone makes skill management dramatically easier going forward.

Still broken after trying all of this?

The 3.22 migration catches most people on corrupt configs, custom skill conflicts, or browser automation rebuilds. A second set of eyes usually finds it in under 30 minutes.

Book a $49 Recovery Session → Or see all ClawReady services