Releases & Changelog

What's new in OpenClawβ€”and what it means for you

Upgrade to the latest with openclaw update, then run openclaw doctor to verify. If you hit breaking config moves, follow Upgrading / Migrating and run openclaw doctor --fix. Here's what you'll get in each releaseβ€”written for how you'll actually use it. For the full technical changelog, see GitHub Releases.

Page scope (release-history niche): This page focuses on chronological release history and highlights. For actionable upgrade steps and migration checklists use Upgrading / Migrating. For first-time setup use Installation.

Operating in production? Use Deployment Upgrade Runbook for rollout, smoke tests, and rollback.

Breaking changes (latest: v2026.4.5)

If an upgrade breaks your setup, the quickest path is almost always:

Commands
openclaw doctor --fix
  • Legacy public config aliases (v2026.4.5) β€” removed in favor of canonical public paths and enabled, including legacy keys such as talk.voiceId / talk.apiKey, agents.*.sandbox.perSession, browser.ssrfPolicy.allowPrivateNetwork, hooks.internal.handlers, and channel/group/room allow toggles. Load-time compatibility and openclaw doctor --fix migrate existing configs where supportedβ€”re-open openclaw.json after --fix and confirm paths.
  • xAI x_search (v2026.4.2) β€” move from legacy core tools.web.x_search.* to plugins.entries.xai.config.xSearch.*; auth standardizes on plugins.entries.xai.config.webSearch.apiKey / XAI_API_KEY. xAI migration guide.
  • Firecrawl web_fetch (v2026.4.2) β€” move from tools.web.fetch.firecrawl.* to plugins.entries.firecrawl.config.webFetch.*. Firecrawl migration guide.
  • Matrix DM policy (v2026.4.9) β€” legacy channels.matrix.dm.policy: "trusted" is rewritten to compatible DM policies during openclaw doctor --fix (explicit allowFrom becomes allowlist; empty legacy configs default to pairing).

Full β€œwhat changed” context and a post-upgrade checklist: Upgrading / Migrating.

v2026.4.10 β€” What's new for you

Released April 11, 2026. Full release notes on GitHub Β· Source (ZIP)

  • Models / Codex β€” Bundled Codex provider and plugin-owned app-server harness: codex/gpt-* models use Codex-managed auth, threads, discovery, and compaction; openai/gpt-* stays on the normal OpenAI provider path.
  • Memory β€” Optional Active Memory plugin: a dedicated memory sub-agent before the main reply (modes, /verbose inspection, optional transcript persistence). Official docs: Active Memory.
  • macOS / Talk β€” Experimental local MLX speech provider for Talk Mode with explicit selection, local playback, interruption, and system-voice fallback.
  • Video β€” Seedance 2.0 model refs on the bundled fal provider with duration, resolution, audio, and seed metadata.
  • Microsoft Teams β€” Message actions: pin, unpin, read, react, list reactions; broad fixes for media in personal DMs, Bot Framework chats, Graph IDs, SSO callbacks, cron to conversation IDs, and more.
  • Matrix β€” MSC4357 live markers on draft preview sends/edits for typewriter-style UX in supporting clients.
  • CLI β€” openclaw exec-policy with show, preset, and set to align tools.exec.* with local exec approvals (sync conflicts, rollback safety).
  • Gateway β€” commands.list RPC for remote clients; Tailscale/update check earlier so stalled sidecars do not lock out remote operators; WebSocket RPC during channel startup; stricter pre-auth upgrade budget.
  • Providers β€” Per-provider models.providers.*.request.allowPrivateNetwork for trusted self-hosted OpenAI-compatible endpoints.
  • QA β€” Live openclaw qa matrix and openclaw qa telegram lanes; openclaw qa suite --runner multipass for disposable Linux VM runs.
  • Security / fixes β€” Tighter browser and sandbox navigation (SSRF, allowlists, subframes, CDP, noVNC); exec preflight, env denylists, WhatsApp --media gateway sends, thread routing across Slack/Telegram/Matrix/Mattermost, extended default LLM idle window (120s), and many channel stability fixes.

v2026.4.9 β€” What's new for you

Released April 9, 2026. Full release notes on GitHub Β· Source (ZIP)

  • Memory / dreaming β€” Grounded REM backfill with rem-harness --path, diary commit/reset, cleaner durable-fact extraction, and short-term promotion tied to old daily notes.
  • Control UI / dreaming β€” Structured diary view, timeline navigation, backfill/reset controls, grounded Scene lane, and safe clear-grounded for staged signals.
  • Plugins / auth β€” Provider manifests can declare providerAuthAliases so variants share env vars, auth profiles, and onboarding choices.
  • iOS releases β€” CalVer pin in apps/ios/version.json and documented pnpm ios:version:pin -- --from-gateway workflow for TestFlight trains.
  • Security β€” Re-check blocked destinations after browser interactions; block risky vars from untrusted workspace .env; sanitize remote node exec.* summaries; dependency fixes (basic-ftp, Hono); prevent untrusted workspace plugins from colliding with bundled provider auth-choice IDs.
  • Matrix β€” Wait for sync readiness before β€œstartup OK”; contain background handler failures; channel-level restart on fatal sync stop instead of gateway crash.
  • Slack β€” Bearer auth preserved on same-origin files.slack.com redirects; ACP block replies count as delivered; improved partial-stream dedupe.
  • Android β€” Clear stale setup-code auth on new QR scans; more reliable pairing when backgrounded.
  • Doctor / replies β€” OAuth reauth surfaced with exact commands; legacy Matrix DM trusted policy migrated via openclaw doctor --fix.
  • Packaging β€” Mirrored/staged bundled runtime deps and tarball tests so fresh npm installs fail fast on missing plugin deps.

v2026.4.8 β€” What's new for you

Released April 8, 2026. Full release notes on GitHub Β· Source (ZIP)

  • npm installs β€” Telegram and bundled channels (BlueBubbles, Feishu, Google Chat, IRC, Matrix, Mattermost, Teams, Nextcloud Talk, Slack, Zalo) load setup/secret contracts from packaged sidecarsβ€”fixes missing dist/extensions/.../src imports at gateway startup.
  • Compatibility β€” Bundled plugin metadata aligned with the release version so channels/providers load on 2026.4.8.
  • Agents β€” update_plan stays available for OpenAI-family runs with compact payloads; tools.experimental.planTool=false opts out. /exec current-default reporting matches real host=auto behavior.
  • Slack / network β€” Socket Mode honors HTTP(S) proxy settings (incl. NO_PROXY); trusted env-proxy mode skips DNS pinning so proxy-only sandboxes resolve outbound hosts.

v2026.4.7 β€” What's new for you

Released April 8, 2026. Full release notes on GitHub Β· Source (ZIP)

  • CLI β€” openclaw infer ... hub for provider-backed model, media, web, and embedding workflows.
  • Media generation β€” Auto-fallback across auth-backed image/music/video providers; smarter hint remapping and capability surfacing.
  • Memory β€” Bundled memory-wiki stack restored (plugin, CLI, sync/query, digests, claim health).
  • Plugins β€” Bundled webhook ingress plugin to drive bound TaskFlows via shared-secret routes.
  • Sessions / compaction β€” Persisted compaction checkpoints and Sessions UI branch/restore; pluggable compaction providers via agents.defaults.compaction.provider.
  • Providers β€” Gemma 4 on Google paths; bundled Arcee AI plugin; Claude CLI preferred again in Anthropic onboarding; Ollama vision from /api/show.
  • Security / exec β€” Many hardening fixes (allowlist owner checks, Feishu workspace paths, redirect SSRF fetch guard, host env sanitization, gateway config.apply guardrails).

v2026.4.5 β€” What's new for you

Released April 6, 2026. Full release notes on GitHub Β· Source (ZIP)

  • Breaking β€” config cleanup β€” Legacy public aliases (see breaking changes) consolidate onto canonical paths and enabled; use openclaw doctor --fix after upgrade.
  • Agents / media β€” Built-in video_generate and music_generate tools; bundled ComfyUI (comfy) workflow plugin for local or Comfy Cloud workflows with shared image/video/music generation paths.
  • Providers β€” Bundled Qwen, Fireworks AI, and StepFun; MiniMax TTS; Ollama Web Search and MiniMax Search; Bedrock Mantle support with inference-profile discovery and automatic request-region injection; Bedrock embeddings for Titan, Cohere, Nova, and TwelveLabs.
  • Control UI β€” Localized UI (Simplified/Traditional Chinese, Brazilian Portuguese, German, Spanish, Japanese, Korean, French, Turkish, Indonesian, Polish, Ukrainian); ClawHub search, detail, and install from the Skills panel; plugin-config prompts in guided onboarding.
  • Plugins β€” openclaw plugins install --force to replace existing plugin/hook targets without the dangerous-code override flag.
  • Exec approvals β€” iOS APNs notifications opening in-app approval modals; Matrix-native approval prompts with account-scoped approvers and thread-aware resolution.
  • Channels β€” Configurable per-channel contextVisibility (all, allowlist, allowlist_quote) to filter supplemental quote/thread/history context by sender allowlists.
  • Providers / transport β€” Shared model and media request overrides (headers, auth, proxy, TLS) across OpenAI-, Anthropic-, Google-, and compatible paths; OpenAI forward-compat catalog entries and prompt-caching improvements.
  • Memory (experimental) β€” Dreaming phases, /dreaming command, Dreams UI, dreams.md trail, and related doctor/status repairβ€”tune with aging controls when enabled.
  • Security fixes β€” Stricter plugin tool allowlists, owner-only /allowlist mutations, fail-closed before_tool_call hook crashes, earlier SSRF redirect blocking, and safer non-interactive auth inference for bundled/trusted plugins.

v2026.4.2 β€” What's new for you

Released April 2, 2026. Full release notes on GitHub Β· Source (ZIP)

  • Breaking β€” xAI x_search β€” Settings move from legacy core tools.web.x_search.* to plugins.entries.xai.config.xSearch.*; auth standardizes on plugins.entries.xai.config.webSearch.apiKey / XAI_API_KEY. Run openclaw doctor --fix.
  • Breaking β€” Firecrawl web_fetch β€” Config moves from tools.web.fetch.firecrawl.* to plugins.entries.firecrawl.config.webFetch.*. Run openclaw doctor --fix.
  • Task Flow β€” Core substrate returns with managed vs mirrored sync, durable flow state/revisions, and openclaw flows for inspection and recovery; managed child tasks with sticky cancel intent. Operations guide: Task Flow Operations.
  • Plugins β€” api.runtime.taskFlow for host-resolved flows; before_agent_reply hook to short-circuit the LLM after inline actions.
  • Android β€” Assistant-role entrypoints and Google Assistant App Actions to launch OpenClaw and hand prompts into the composer.
  • Exec β€” Gateway/node host exec defaults request full security with prompts off; doctor reports real exec-approvals.json paths; malformed policy enums normalized.
  • Channels & providers β€” Matrix m.mentions on text/media/edits; Feishu Drive comment threads; MS Teams streaming dedupe; centralized provider HTTP auth, proxy, TLS, and streaming headers across many code paths.
  • Agents β€” Consistent agents.defaults.compaction.model; optional agents.defaults.compaction.notifyUser for the compacting notice.

v2026.4.1 β€” What's new for you

Released April 1, 2026. Full release notes on GitHub Β· Source (ZIP)

  • Chat /tasks β€” Session task board with recent task detail and sensible fallbacks when nothing is linked.
  • Web search β€” Bundled SearXNG provider plugin for web_search with configurable host.
  • AWS Bedrock β€” Guardrails support in the bundled Bedrock provider.
  • macOS β€” Voice Wake can trigger Talk Mode.
  • Gateway webchat β€” Configurable gateway.webchat.chatHistoryMaxChars and per-request maxChars.
  • Agents β€” agents.defaults.params for global default provider parameters; improved rate-limit retry caps before cross-provider failover (auth.cooldowns.rateLimitedProfileRotations).
  • Cron β€” openclaw cron --tools for per-job tool allowlists.
  • Exec approvals β€” Major fixes: allow-always durability, Slack/Discord/native routing, cron isolated jobs, webchat approval UX, doctor warnings when CLI exec policy is broader than host approvals file. Reference: Exec Approvals Guide.

Breaking changes (v2026.3.31)

Key upgrades that often require config or workflow adjustments:

  • Nodes exec behavior β€” node shell wrappers consolidated so node execution goes through exec host=node; pairing/trust changes affect which requests become allowed.
  • Installs fail closed β€” dangerous-code critical scan findings and install failures block by default; use --dangerously-force-unsafe-install only if you accept the risk.
  • Gateway trust hardening β€” trusted-proxy rejects mixed shared-token configs; local-direct requires the configured token.
  • Background tasks β†’ flows β€” unified SQLite ledger and controllable flow surface: openclaw flows list|show|cancel.

After upgrading: follow Upgrading / Migrating and run openclaw doctor --fix.

v2026.3.31 β€” What's new for you

Released March 31, 2026. Full release notes on GitHub Β· Source (ZIP)

  • Breaking β€” Nodes β€” Remove duplicated nodes.run; shell on nodes goes through exec host=node; nodes invoke and media/location/notify actions stay for node-specific work.
  • Breaking β€” Installs β€” Dangerous-code critical scan findings and install failures fail closed by default; may need --dangerously-force-unsafe-install when you accept the risk.
  • Breaking β€” Gateway β€” Stricter trusted-proxy shared-token rules; local-direct requires the configured token; node commands stay off until node pairing is approved; reduced trust surface for node-originated runs.
  • Background tasks β€” SQLite-backed ledger unifying ACP, subagent, cron, and CLI background work; openclaw flows list|show|cancel; better cleanup and status.
  • Channels β€” QQ Bot bundled plugin; Matrix history limit, proxy, draft streaming, thread replies; LINE outbound video/audio; Nostr inbound DM signature verification.
  • MCP β€” Remote HTTP/SSE mcp.servers URL configs with auth headers and safer redaction.

Breaking changes (v2026.3.28)

Two common β€œit used to work” causes:

  • Qwen portal OAuth removed β€” deprecated qwen-portal-auth OAuth integration for portal.qwen.ai; migrate to Model Studio.
  • Doctor migration cutoff β€” automatic config migrations older than about two months are dropped; very old legacy keys may fail validation.

For the practical steps: Upgrading / Migrating + openclaw doctor --fix.

v2026.3.28 β€” What's new for you

Released March 29, 2026. Full release notes on GitHub Β· Source (ZIP)

  • Breaking β€” Qwen β€” Deprecated qwen-portal-auth OAuth for portal.qwen.ai is removed. Migrate to Alibaba Model Studio with openclaw onboard --auth-choice modelstudio-api-key.
  • Breaking β€” Doctor β€” Automatic config migrations older than about two months are dropped; very old legacy keys may fail validation instead of being rewritten.
  • xAI / Grok β€” Bundled xAI provider moves to the Responses API, adds first-class x_search, and can auto-enable the xAI plugin from web-search config.
  • Plugin hooks β€” Async requireApproval in before_tool_call lets plugins pause tools for user approval (exec overlay, Telegram, Discord, /approve).
  • ACP β€” Current-conversation ACP binds for Discord, BlueBubbles, and iMessage (e.g. /acp spawn codex --bind here).
  • OpenAI / Codex β€” apply_patch on by default; bundled CLI backends (Claude, Codex, Gemini CLIs) live on the plugin surface; gateway run --cli-backend-logs (replaces --claude-cli-logs as the generic flag).
  • MiniMax β€” Image generation for image-01 (generate and image-to-image with aspect ratio); model catalog trimmed toward current M2.7 line.
  • Channels & files β€” Explicit Slack upload-file; upload-file support for Microsoft Teams, Google Chat, and BlueBubbles file sends.
  • CLI β€” openclaw config schema prints the JSON Schema for openclaw.json.
  • Podman β€” Simpler rootless container setup and documented openclaw --container <name> ... host workflow.
  • Fixes β€” Notable patches across WhatsApp, Telegram, Discord, iMessage, BlueBubbles, Google Gemini resolution, Anthropic stop reasons, Control UI raw config editing, and more.

v2026.3.24 β€” What's new for you

Released March 25, 2026. Full release notes on GitHub Β· Source (ZIP)

  • OpenAI-compatible gateway surface β€” Adds /v1/models and /v1/embeddings, and forwards explicit model overrides through /v1/chat/completions and /v1/responses for broader client and RAG compatibility.
  • See tools before you ask β€” /tools reflects what the current agent can use (compact by default, optional detail mode), and Control UI shows a live "Available Right Now" section.
  • Microsoft Teams upgrade β€” Migrates to the official Teams SDK with streaming 1:1 replies, welcome cards with prompt starters, feedback, status updates, typing indicators, native AI labeling, plus message edit/delete (including in-thread fallbacks).
  • Skills you can actually install β€” One-click install recipes for bundled skills (coding-agent, gh-issues, openai-whisper-api, session-logs, tmux, trello, weather); Control UI skills get status tabs (All / Ready / Needs Setup / Disabled) and a detail dialog with requirements, toggles, install, and API key entry.
  • Slack interactive replies β€” Richer reply parity for direct deliveries; simple trailing Options: lines can render as buttons/selects; safer isolation between reply controls and plugin interactives.
  • CLI in your container β€” --container and OPENCLAW_CONTAINER run openclaw commands inside a running Docker or Podman OpenClaw container.
  • Discord thread naming β€” Optional autoThreadName: "generated" can rename new auto-threads with concise LLM titles (message-based naming stays the default).
  • Plugins and Control UI polish β€” before_dispatch hook with canonical inbound metadata; expandable workspace file rows with lazy markdown preview; refreshed preview dialog and macOS app config navigation (tree sidebar).
  • Install/runtime ergonomics β€” Supported Node 22 floor lowered to 22.14+ (Node 24 still recommended); openclaw update preflights the target package engines.node so outdated runtimes get a clear upgrade message.
  • Reliability and security fixes β€” Outbound media aligned with fs policy; sandbox mediaUrl/fileUrl bypass closed; gateway restart wakes sessions and retries delivery; per-channel boot failures isolated; Docker setup loop fix; WhatsApp/Telegram/Slack/Discord fixes across threads, topics, and timeouts.

v2026.3.23 β€” What's new for you

Released March 23, 2026. Full release notes on GitHub Β· Source (ZIP)

  • Qwen ModelStudio support expanded β€” Adds standard pay-as-you-go DashScope endpoints for China and global Qwen API keys, with provider relabeled as Qwen (Alibaba Cloud Model Studio).
  • Control UI clarity and accessibility β€” Unified button primitives, improved Knot theme contrast (WCAG 2.1 AA), config icons, discrete roundness stops, and broader aria-label coverage.
  • CSP hardening β€” Inline script blocks in Control UI are now SHA-256 hashed and explicitly allowlisted in CSP script-src.
  • Plugin/runtime packaging fixes β€” Bundled plugin runtime sidecars are shipped again; ClawHub/plugin compatibility and uninstall target handling fixed.
  • Auth and token stability β€” Fixes stale-token snapback for OpenAI auth/profile writes and preserves operator scopes correctly in Control UI device-auth bypass paths.
  • Browser reliability β€” Existing-session attach waits for usable tabs; CDP loopback reuse improved to avoid relaunch regressions on slower headless Linux setups.
  • Web search provider correctness β€” Agent turns now use the active configured web_search provider instead of stale/default selection.
  • Mistral defaults repaired β€” Safer output budgets bundled; openclaw doctor --fix can repair old oversized Mistral limits that caused 422 errors.
  • More reliability fixes β€” cron --at --tz wall-clock correctness, Telegram threading context fallback, plugin message tool media/block behavior, OpenRouter auto pricing bootstrap recursion, and proxy-aware OAuth refresh paths.

v2026.3.22 β€” What's new for you

Released March 23, 2026. Full release notes on GitHub Β· Source (ZIP)

  • ClawHub-native install flows β€” openclaw skills search|install|update and plugins install clawhub:<package> with tracked update metadata.
  • Plugin/marketplace expansion β€” Claude marketplace installs, marketplace listing/update support, bundle install support for Codex/Claude/Cursor.
  • Provider/plugin architecture expansion β€” OpenRouter, GitHub Copilot, and OpenAI Codex moved into bundled provider plugins.
  • New web providers/tools β€” Exa, Tavily, and Firecrawl added as bundled web-search providers/tools.
  • OpenAI defaults and forward-compat β€” Default OpenAI setup model moved to openai/gpt-5.4; support for gpt-5.4-mini and gpt-5.4-nano.
  • Breaking highlights β€” ClawHub-first plugin install resolution; legacy Chrome extension relay removed (migrate via openclaw doctor --fix); Plugin SDK moved to openclaw/plugin-sdk/*; legacy CLAWDBOT_*/MOLTBOT_* env compatibility removed.

v2026.3.12 β€” What's new for you

Released March 13, 2026. Full release notes on GitHub Β· Source (ZIP)

  • Dashboard v2 β€” Refreshed gateway dashboard with modular overview, chat, config, agent, and session views; command palette; mobile bottom tabs; slash commands, search, export, pinned messages.
  • GPT-5.4 & Claude fast mode β€” Session-level fast toggles via /fast, TUI, Control UI, and ACP; per-model defaults; OpenAI/Codex and Anthropic service_tier support.
  • Ollama, vLLM, SGLang as provider plugins β€” Provider-owned onboarding, discovery, model-picker setup, and post-selection hooks.
  • Kubernetes docs β€” Starter K8s install with raw manifests, Kind setup, and deployment guide.
  • sessions_yield β€” Orchestrators can end the current turn immediately and carry a hidden follow-up payload into the next session turn.
  • Slack Block Kit β€” Agents can send Block Kit messages via channelData.slack.blocks.
  • Security: short-lived pairing codes, workspace plugin auto-load disabled (GHSA-99qw-6mr3-36qr), exec approval and gateway auth hardening, and other advisories.

v2026.3.11 β€” What's new for you

Released March 12, 2026. Full release notes on GitHub Β· Source (ZIP)

Security

  • Gateway/WebSocket origin validation β€” Browser-originated connections now enforce origin validation regardless of proxy headers (GHSA-5wcw-8jjv-m286).

What you can do now

  • First-class Ollama onboarding; macOS chat model picker; OpenRouter Hunter/Healer Alpha; iOS home canvas; Discord auto-thread archive duration; Memory Gemini embedding and multimodal indexing; ACP resumeSessionId.

Breaking

  • Cron/doctor: Use openclaw doctor --fix for legacy cron storage and notify/webhook metadata migration.

v2026.3.8 β€” What's new for you

Released March 9, 2026. Full release notes on GitHub Β· Source (ZIP)

What you can do now

  • Back up and verify your setup from the CLI β€” openclaw backup create and openclaw backup verify create local state archives with options like --only-config and --no-include-workspace. Destructive flows now suggest backup first.
  • Control when Talk Mode sends β€” New talk.silenceTimeoutMs config lets you set how long Talk waits for silence before auto-sending the transcript. Fewer accidental early sends or long waits.
  • TUI knows your workspace agent β€” When you launch the TUI inside a configured agent workspace, OpenClaw infers the active agent so you don't have to specify it every time. Explicit agent: targets still work.
  • Brave web search with LLM context β€” Opt-in tools.web.search.brave.mode: "llm-context" uses Brave's LLM Context endpoint so web_search returns extracted grounding snippets with source metadata.
  • See the exact build in --version β€” openclaw --version now includes the short git commit hash when available, so you can match installs to source.
  • ACP provenance for agent collaboration β€” Optional ACP ingress provenance metadata (openclaw acp --provenance off|meta|meta+receipt) so OpenClaw agents can retain and report ACP-origin context with session trace IDs.
  • macOS remote gateway token in onboarding β€” Remote mode setup in the macOS app now has a dedicated field for the gateway token, with clearer handling of non-plaintext tokens.

Fixes and polish

  • Telegram: duplicate DM replies fixed when multiple session keys resolve for one agent; Cron/Telegram text-only announces now route through real adapters so delivery status is accurate.
  • Matrix: safer DM routing with broken m.direct homeservers and explicit room bindings honored.
  • macOS: openclaw update can recover from a disabled gateway service; LaunchAgent re-enabled before updater bootstrap.
  • Web search: provider list ordering alphabetized in onboarding and config; Brave setup docs updated with current $5/month credit and plan names.

v2026.3.7 β€” What's new for you

Released March 8, 2026. Full release notes on GitHub Β· Source (ZIP)

What you can do now

  • Use smarter context plugins β€” Plugins like lossless-claw can now control how your agent remembers and summarizes long conversations. If you've ever hit context limits or wanted a different summarization style, this opens the door.
  • Keep ACP threads across restarts β€” When you use ACP (agent collaboration) in Discord or Telegram, your thread bindings now survive gateway restarts. No more re-binding after updates.
  • Get the Control UI in Spanish β€” Switch the web dashboard to Spanish. Great if you prefer espaΓ±ol for your setup and settings.
  • Pick your web search provider during onboarding β€” The setup wizard now lets you choose which search provider powers your agent's web lookups, with support for secrets from external vaults (SecretRef).
  • Better Perplexity search results β€” Web search using Perplexity is now powered by their Search API with structured results. You get more precise answers and can filter by language, region, and time.
  • Store your gateway token in a vault β€” You can now point gateway.auth.token at a secret managed by your vault (e.g. HashiCorp, Doppler) instead of plain config. Cleaner and more secure for production.
  • Faster Docker startup β€” If you run OpenClaw in Docker, you can pre-bake extensions into the image so they don't install at startup. Slimmer builds and quicker boots.

Improvements under the hood

  • Plugins can inject system-context text for better prompt cachingβ€”fewer repeated tokens and lower cost.
  • Hook policies let you control whether plugins can modify prompts (allowPromptInjection).

Before upgrading

If you use both a gateway token and a password (including from SecretRefs), you must now set gateway.auth.mode to token or password explicitly. Add this to your config before upgrading to avoid startup or pairing issues.

v2026.3.2 β€” What's new for you

Released March 3, 2026. Release notes

  • Ask your agent to read PDFs β€” Native PDF support. Just point the agent at a PDF and it can analyze, summarize, or extract information without extra setup.
  • Store more secrets in your vault β€” SecretRef coverage expanded to 64 targets. Use your existing vault for channel tokens, API keys, and gateway auth.
  • Smoother Telegram replies β€” New setups get partial streaming by default, so you see replies appear as they're generated instead of waiting for the full message.
  • Catch config errors early β€” openclaw config validate checks your config before the gateway starts. Fewer surprise failures.
  • Use Ollama for memory search β€” If you run Ollama locally, you can use it for embeddings in memory search. Keeps more of your workflow on your own machine.
  • Zalo Personal without extra tools β€” Zalo Personal now works with native JavaScript integration. No more installing a separate CLI.

Heads up: New installs default to tools.profile: "messaging" (fewer tools out of the box). ACP dispatch is on by default. Plugin HTTP handlers use a new registration API. Zalo Personal no longer uses external CLI binaries.

v2026.3.1 β€” What's new for you

Released March 2, 2026. Release notes

  • Health checks for Docker and Kubernetes β€” Built-in /health and /ready endpoints for liveness and readiness probes. Easier to run OpenClaw in containers and orchestration.
  • More from your Android node β€” Camera, device status, notifications list, photos, contacts, calendar, and motion sensors. Your phone becomes a richer input for your agent.
  • Discord threads that stick β€” Thread-bound sessions now use idle-timeout instead of fixed TTL. Use /session idle and /session max-age to tune how long threads stay active.
  • Telegram DM topics β€” Route different Telegram DMs or topics to different agents or sessions. Better for multi-project or multi-identity setups.
  • Control UI in German β€” Dashboard available in German (de).
  • Faster OpenAI streaming β€” WebSocket-first for OpenAI models. Fewer connection hiccups and quicker first-token.

v2026.2.26 β€” What's new for you

Released February 27, 2026. Release notes

  • Manage secrets from the CLI β€” openclaw secrets audit, configure, apply, and reload. Pull API keys and tokens from your vault instead of editing config by hand.
  • ACP agents in threads β€” ACP (agent collaboration) agents are first-class in Discord and Telegram threads. Spawn, send, and get replies without jumping between surfaces.
  • Route who goes where β€” openclaw agents bindings, bind, and unbind let you control which accounts and channels route to which agents.
  • Channel plugins own onboarding β€” When you add a channel, its plugin can run its own setup wizard. More guided, less guesswork.
  • Android device and notifications β€” Android nodes expose device status, info, and a list of active notifications. Ask your agent what's on your lock screen.

Older releases

Related