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.
Release status: GitHubβs latest non-prerelease is v2026.6.6 (published 2026-06-12). Use that tag for production unless you are explicitly testing a pre-release. Tags with -beta in the name are pre-release builds for validation only.
Beta tags on GitHub: Pre-release builds use -beta (current train: v2026.6.8-beta.*; newest tag: v2026.6.8-beta.1βalways confirm on GitHub). Use openclaw update --channel beta for beta only. Prior stable: v2026.6.5, v2026.6.1, v2026.5.28. Prefer releases/latest (currently v2026.6.6) unless you are validating a pre-release. All releases
Breaking changes (through v2026.6.6)
If an upgrade breaks your setup, the quickest path is almost always:
- 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).
- Tool profiles (v2026.4.29) β configuring
tools.exec or tools.fs no longer implicitly widens restrictive tools.profile values such as messaging or minimal. Add explicit alsoAllow entries if you need those tools under a restricted profile; startup warns when configs are affected.
- Exec approvals / skills (v2026.5.20) β removed the legacy
cat SKILL.md && printf β¦ allowlist compatibility path. Skill files must be loaded with the read tool; only the real skill executable is auto-allowed. Update custom skills or exec-approval rules that relied on the old wrapper.
Full βwhat changedβ context and a post-upgrade checklist: Upgrading / Migrating.
v2026.6.8-beta β Preview (pre-release)
Not production. Latest beta tag: v2026.6.8-beta.1 (June 14, 2026). Builds on stable v2026.6.6βsee GitHub for the full changelog:
- Telegram / WhatsApp β Rich Telegram text (tables, lists, blockquotes), prompt-preserving CLI backend delivery, safer rich-media boundaries; WhatsApp honors configured ACP bindings.
- Agent / Gateway recovery β Account-scoped DM sends, generated media completions, auto-reply message-tool finals, reset archive fallback reads, restart shutdown aborts, yielded subagent pauses, heartbeat dedupe.
- Providers / models β GLM-5.2, Claude Haiku 4.5 catalog rows, OpenRouter/Vertex prefix normalization, SecretRef auth, OAuth image-default routing through Codex, reasoning-signature recovery, tool-schema quarantine.
- Usage hooks β Native full footer renderer, default templates, fixed-decimal formatting, credential-aware limits, warnings for broken templates.
- UI / mobile β Collapsible workspace files, WebChat backscroll during streaming, sidebar session picker fixes, iOS stale Gateway reconnect.
- Memory / state β Split oversized embedding batches, QMD search in transient mode, SQLite WAL avoided on NFS volumes, full reindex rollback recovery.
Test with openclaw update --channel beta and openclaw doctor --fix. Production should use releases/latest (v2026.6.6). Prior beta tags: v2026.6.7-beta.1, v2026.6.6-beta.2 (graduated to stable).
v2026.6.6 β What's new for you
Released June 12, 2026. Full release notes on GitHub Β· Source (ZIP) Β· Source (tar.gz) Β· Mac app: GitHub Releases (latest)
- Security β Tighter boundaries across transcripts, sandbox binds, MCP stdio, Codex HTTP, native search policy, elevated sender checks; exec approvals fail closed on timeout.
- Telegram β Account-scoped topics route to the right agent; streamed text survives tool calls;
/compact on generic ingress; unauthorized DM text kept out of cache and prompt context.
- iMessage β Always-on inbound restart, durable echo markers, block streaming, idle approval discovery, hardened outbound transport.
- Browser / MCP β Existing-session CDP support, discovered WebSocket validation, Streamable HTTP loopback transport, corrected OAuth/SSE authorization handling.
- Control UI / performance β Cached model metadata, lower startup latency, first-reply tracing;
/models derived-registry rescan storms stopped.
- Providers β OpenRouter OAuth onboarding; Claude Fable 5 adaptive thinking; Codex compaction ownership; Ollama thinking defaults in SDK sessions; Gemma 4 reasoning replay preserved.
- Gateway / agents β Safer
config.patch array semantics; malformed RPC timeout rejection; same-model rate-limit retries; thinking catalog compatibility through SDK sessions.
- Memory / plugins β Local llama.cpp in provider plugin; batched embeddings; agent model catalog cache; ClawHub dry-run and managed-plugin drift reporting.
After upgrade: openclaw doctor --fix, then re-test channels (Telegram/iMessage/WhatsApp), MCP/browser tools, OpenRouter OAuth (if used), Control UI startup, and plugin/skill installs. Guides: OpenRouter OAuth, plugin install policy.
v2026.6.5 β Prior stable
Released June 9, 2026. Superseded by v2026.6.6 for new installs. Full release notes on GitHub Β· Source (ZIP) Β· Source (tar.gz) Β· Mac app: OpenClaw-2026.6.5.dmg
- MCP / providers β MCP tool results coerce non-text/image blocks at the materialize boundary (prevents Anthropic 400s); Anthropic extended-thinking recovers after prompt-cache expiry; Parallel bundled
web_search provider; Google Vertex ADC and provider-catalog fixes.
- Agents / tools β Stricter MCP lease handling, prompt-cache tool names, local tool catalogs, unreadable dynamic-tool quarantine, owner-only HTTP tool gating; stalled MCP response timeouts.
- Channels β QQBot strips reasoning/thinking tags before delivery; Matrix voice-note preflight and thread-aware replies; Google Chat native approval cards; WhatsApp bounded startup and config-reload teardown.
- Auth / plugins / skills β Auth profiles in SQLite; official npm plugin install pins preserved; ClawHub GitHub-repo skill installs via pinned commits; skill refresh avoids per-file watcher exhaustion.
- Gateway / mobile β macOS node mode stays on healthy direct Gateway sessions; Android theme mode and clearer provider/model states; rate-limited node pairing.
- State / storage β Matrix sync/crypto, memory-wiki, sandbox registry, ACPX, device-pair, and plugin dedupe state move to SQLite; cron legacy JSON migrates in doctor preflight.
- TUI / Workboard / config β Optimistic user messages stable across history reloads; Workboard stale lifecycle fixes;
config.patch preserves explicit array replacements.
- Release train β Monthly
YYYY.M.PATCH numbering; June 2026 floor at 2026.6.5.
Upgrade to v2026.6.6 for security hardening, Telegram/iMessage delivery, Control UI latency, and OpenRouter OAuth.
v2026.6.1 β Prior stable
Released June 3, 2026. Superseded by v2026.6.6 for new installs. Full release notes on GitHub Β· Source (ZIP) Β· Source (tar.gz) Β· Mac app: OpenClaw-2026.6.1.dmg
- Skill Workshop β Governed skill creation with proposal lists, revision handoff, searchable file previews, review states, and the
skill_workshop agent tool (apply/reject/quarantine). See Skill Workshop guide.
- Workboard & Code mode β Multi-agent orchestration and task-backed board runs; scoped agent/global session namespaces with exact namespace tool dispatch. See Workboard guide.
- Control UI / chat β Sends stay alive through history load; incremental stream deltas; local drafts while typing; composer clears after send; first-output latency tracing; calmer composer controls.
- iOS / mobile β Hosted push relay, realtime Talk playback, iPad layouts; steadier delivery across Telegram/WhatsApp/iMessage/Slack/Discord/Teams/Google Chat/Meet.
- SQLite state β iMessage monitor, inbound queues, and plugin install index toward SQLite-backed tracking with less restart scanning.
- Agents / Codex β Recovery from interrupted tool calls; async media without ending Codex turns; atomic auth profiles; Codex app-server final-answer partials to live previews.
- Plugins β Official
@openclaw/copilot and @openclaw/tokenjuice; SecretRef provider manifest; stale disabled skill snapshots no longer abort channel turns.
- Doctor / providers β Disk space health checks; MiniMax M3; OpenRouter SQLite model caching; bounded provider/plugin timers.
Upgrade to v2026.6.6 for security hardening, Telegram/iMessage delivery, Control UI latency, and OpenRouter OAuth.
v2026.5.28 β Prior stable
Released May 30, 2026. Superseded by v2026.6.6 for new installs. Full release notes on GitHub Β· Source (ZIP) Β· Mac app: OpenClaw-2026.5.28.dmg
- Agent & Codex recovery β Subagent cwd/workspace separation; session locks; shared Codex app-server state across failures.
- Channels β Matrix room-id case, iMessage/Slack/Discord/Telegram/Teams delivery fixes.
- iOS & chat β iOS Pro UI, hosted push relay, realtime Talk, WebChat reconnect.
- Providers β Claude Opus 4.8, encrypted PDF (ClawPDF), MiniMax streaming music; Copilot/Tokenjuice plugins; Workboard.
Upgrade to v2026.6.6 for security hardening, Telegram/iMessage delivery, and expanded provider/channel fixes.
v2026.5.27 β Prior stable
Released May 28, 2026. Superseded by v2026.6.6 for new installs. Full release notes on GitHub Β· Source (ZIP) Β· Mac app: OpenClaw-2026.5.27.dmg
- Security & content boundaries β Group prompts outside system prompt; Tailscale no-auth rejected; node/device-role approvals require admin.
- Codex app-server β Shared clients survive startup failures; workspace memory through tools; native hook relay survives restarts.
- Providers β Core OpenAI-compatible embeddings; DeepInfra full catalog; Pixverse video; VLLM thinking params.
- Channels β Telegram durable
sendMessage; iMessage/Slack/Matrix/Discord/Google Chat delivery fixes.
See v2026.5.28 and v2026.6.6 for newer stable highlights.
v2026.5.26 β Prior stable
Released May 27, 2026. Superseded by v2026.6.6 for new installs. Full release notes on GitHub Β· Source (ZIP) Β· Mac app: OpenClaw-2026.5.26.dmg
- Gateway & replies β Startup avoids repeated plugin/channel/session scans; visible replies separate user-facing sends from follow-up work; runtime/session caches churn less under load.
- Transcripts (core) β One transcript path for meeting summaries, source-provider chunks, cleaned user turns, Codex mirrors, WebChat replies, and CLI/TUI replay.
- Talk / voice β Realtime Talk inspect/steer/cancel/follow-up from Web UI and Discord voice; improved wake-name tolerance.
- Channels β Telegram typing/progress and forum topics; iMessage attachments and duplicate-source dedupe; WhatsApp group/media fixes; Discord voice and alpha-bucket model picker; Signal/iMessage/WhatsApp thumb reaction approvals.
- Security / content boundaries β Browser snapshot SSRF checks; external file wrapping; ClickClack sender allowlists; default Gateway auth rate limiter for remote failures.
- Control UI / TUI β Ephemeral Activity tab; busy TUI prompt queue; explicit fast-mode and systemd Gateway hygiene in status.
- Media β Rastermill replaces Sharp for image processing (no Sharp/Jimp install).
- Auth / diagnostics β Named model login profiles; gateway secret-prep traces; OpenTelemetry LLM spans; mobile pair-new-gateway and Talk improvements.
See v2026.5.27 through v2026.6.6 for newer stable highlights.
v2026.5.22 β Prior stable
Released May 24, 2026. Superseded by v2026.6.6 for new installs. Full release notes on GitHub Β· Source (ZIP) Β· Source (tar.gz) Β· Mac app: OpenClaw-2026.5.22.dmg
- Gateway startup performance β Lazy-load idle plugin work, cache immutable plugin metadata, skip macOS Linuxbrew PATH probes, rotate watch CPU profiles. Health and ready signals no longer wait on unused handler trees.
- Models perf β Gateway pre-warms provider auth state at startup;
/models and listing calls drop from ~20 s to ~5 ms (~4,100Γ faster). Auto re-warms after hot reloads.
- Meeting Notes plugin β Source-only external plugin and SDK source-provider contract (outside core npm). Auto-start capture config, manual transcript imports, read-only
openclaw meeting-notes CLI, Discord voice as first live source.
- Control UI β Search and Load More pagination in the chat session picker so older conversations stay reachable without unbounded loads.
- Subagents β Delegated workers default to
AGENTS.md + TOOLS.md only (persona, identity, user, memory, heartbeat, setup files excluded by default).
- xAI / Grok β OAuth profiles reused for Grok
web_search; new model aliases; media providers can declare default operation timeouts.
- Discord β Configurable
agentComponents.ttlMs with per-account overrides (24 h cap) for long-running component workflows.
- Plugin SDK β Generic channel poll sender; row-level session workflow helpers (
loadSessionStore deprecated); reusable embeddingProviders capability contract.
- CLI / onboarding β Bare
openclaw launches classic onboarding when no config exists yet.
- Packaging & security β npm tarball excludes docs images; root package and OpenClaw npm plugins ship with generated shrinkwrap;
protobufjs 8.4.0.
- Media understanding β Antigravity CLI now a lower-priority image/video fallback; Gemini CLI auto-probing removed.
After upgrade: openclaw doctor --fix, then re-test channels, Meeting Notes (if used), subagent runs (confirm trimmed bootstrap is fine), and plugins that read sessions or embeddings.
v2026.5.20 β Prior stable
Released May 21, 2026. Superseded by v2026.6.6 for new installs. Full release notes on GitHub Β· Source (ZIP) Β· Mac app: OpenClaw-2026.5.20.dmg
- Discord voice β Voice sessions follow configured users into voice channels; bounded
IDENTITY.md/USER.md/SOUL.md context in realtime voice instructions (disable with voice.realtime.bootstrapContextFiles: []).
- Policy plugin β Bundled Policy plugin for channel conformance checks, doctor lint findings, and opt-in workspace repair.
- xAI OAuth β Device-code login for headless/remote setups without a localhost browser callback.
- OpenRouter β Provider-level
params.provider routing policy on requests (model/agent params override defaults).
- Exec approvals β Skill files must load via the read tool; legacy
cat SKILL.md allowlist compatibility removed.
- WhatsApp β Baileys
7.0.0-rc12; Codex harness @openai/codex 0.132.0.
- Doctor & security β Warn on plaintext secrets in
openclaw.json, sandbox-hidden MCP tools, symlinked credential files (fail-closed); thinkingFormat cleanup in doctor --fix.
- Cron & Gateway β Main-session cron on a dedicated wake lane;
gateway status --json includes Gateway version; cron/job and task-maintenance fixes.
- Windows install β
install.ps1 onboarding as attached child process (no freeze at Starting setup...).
- Agents β Per-agent
experimental.localModelLean; improved status when sessions pin non-default models.
After upgrade: openclaw doctor --fix, re-test Discord voice, exec approvals/skills, xAI/OpenRouter auth, WhatsApp, and cron if you use them.
v2026.5.19 β Older stable
Released May 20, 2026. Superseded by v2026.5.20 for new installs. Full release notes on GitHub Β· Mac app: OpenClaw-2026.5.19.dmg
Shipped Node 22.19+, faster Gateway restarts, Mac Settings redesign, skills --global, memory-search batching, plugin tooling, browser dialogs, Android Talk Mode, and Telegram forum-topic/DM-draft fixes. Upgrade to v2026.5.20 for Discord voice follow, Policy plugin, device-code xAI OAuth, and exec-approval skill loading changes.
v2026.5.18 β Older stable
Released May 18, 2026. Superseded by v2026.5.19 / v2026.5.20 for new installs. Full release notes on GitHub Β· Source (ZIP) Β· Mac app: OpenClaw-2026.5.18.dmg
Shipped the same major themes as 5.19 (Node 22.19+, faster restarts, Mac Settings redesign, plugin tooling, browser dialogs, Android Talk Mode). Upgrade to v2026.5.19 for skills --global, memory-search batching, Telegram forum-topic fixes, and config reload metadata.
v2026.5.12 β What's new for you
Released May 14, 2026. Full release notes on GitHub Β· Source (ZIP) Β· Source (tar.gz)
- Leaner installs β WhatsApp, Slack, Amazon Bedrock, Anthropic Vertex, and related provider/plugin dependency cones moved out of core so you only pull what you use.
- Telegram resilience β Isolated polling with durable local spooling, safer group-media handling when
requireMention is on, and preserved HTML/Markdown in streamed and cron announce replies.
- Codex and OpenAI paths β Auth-profile-backed media tools, MCP server projection, context-engine thread rotation, and smoother app-server/runtime fallback behavior.
- Plugin install/update β pnpm 11 support, peer-dependency preservation, safer runtime scans, and fewer wedged source/git installs.
- Security and UI β Broad hardening across gateway, browser, Slack, node pairing, sandbox, and transcripts; Control UI/WebChat/TUI improvements for rich replies, session history, and auto-scroll modes.
After upgrade: openclaw doctor --fix, then re-test channels and plugins you rely on. If you use Bedrock, Slack, or Vertex, confirm those plugins are installed if your config references them (they are no longer bundled in core).
v2026.5.7 β What's new for you
Released May 8, 2026 (Asia/Colombo). Full release notes on GitHub Β· Source (ZIP) Β· Source (tar.gz)
- Auth gates tightened β Native commands now enforce ownership, global Active Memory toggles require admin scope, and inline auto-reply tool calls pass before-tool-call authorization.
- Channel reliability pass β Telegram, Discord, and WhatsApp routing/delivery fixes reduce silent drops, stale pollers, and misrouted targets in common chat flows.
- Cron and CLI fixes β
cron list/show --json now exposes computed status, doctor --fix repairs invalid cron model placeholders, and openclaw channels list output is cleaner for operators.
- Session hygiene β Skill snapshots refresh correctly after
/new/sessions.reset, stale run-context tasks are reconciled, and transcript rollover persistence is more predictable.
- Provider/tooling edge-cases β Adds explicit
openai/chat-latest override and fixes several fetch/auth/normalization edge cases (Tavily SecretRef, compaction token clamping, media/tool transcript cleanup).
v2026.5.6 β What's new for you
Released May 6, 2026. Full release notes on GitHub Β· Source (ZIP) Β· Source (tar.gz) Β· Recovery: Codex OAuth routing (official docs)
- Doctor / Codex OAuth β Reverts the v2026.5.5
doctor --fix change that rewrote valid openai-codex/* routes to openai/*, which could break OAuth-only GPT-5.5 setups or push you onto the API-key path by mistake.
- Plugin runtime fetch β Drops third-party symbol metadata from plain request header dictionaries before they reach native
fetch/Headers, so guarded/proxy fetch paths stop rejecting valid plugin traffic.
- Debug proxy + web fetch β Normalizes captured header dictionaries for replay, and bounds guarded dispatcher cleanup after web-fetch timeouts so timed-out tools return errors instead of leaving Gateway tool lanes wedged open.
v2026.5.5 β What's new for you
Released May 6, 2026. Full release notes on GitHub Β· Source (ZIP) Β· Source (tar.gz)
- Channel reliability β Feishu topic starter hydration, LINE DM policy validation, Telegram/Codex progress rendering cleanup, Matrix approval retry delivery, and Discord heartbeat/command-path fixes.
- Provider/runtime compatibility β xAI Grok reasoning controls are constrained to supported values, Fireworks Kimi thinking parameters are kept compatible, and OpenAI-compatible streaming emits early assistant chunks more reliably.
- Control UI and sessions β Better compaction/session visibility, runtime labeling/filtering, persistent progress-text fixes, and improved responsiveness when history/channel probes are slow.
- Plugin and update path hardening β More resilient official plugin update/install behavior (including peer-link repair paths and stale managed-record handling) while preserving third-party pin intent.
- Ops and diagnostics β Clearer Slack reconnect context, doctor/status restart handoff visibility, safer Windows exec-approvals writes, and cleaner gateway shutdown/restart maintenance behavior.
- Platform quality-of-life β iOS pairing support for private LAN /
.local routes, TUI/session restore hygiene, and fixes that reduce duplicate generated-media fallbacks.
v2026.5.4 β What's new for you
Released May 5, 2026. Full release notes on GitHub Β· Source (ZIP) Β· Source (tar.gz)
- Voice and Meet β Snappier Google Meet / voice flows via Twilio + realtime Gemini: paced audio, backpressure, and barge-in behavior tuned for long calls.
- Windows gateway β Loopback bind defaults to
127.0.0.1 where appropriate so local-only gateways behave predictably on Windows.
- Plugins and migration β Clearer install hints when config references official plugins that are not installed yet; externalized Discord plugin SecretRef contracts resolve from packaged
dist/ paths.
- Models and auth β
openclaw models auth list for auditing configured provider auth; Codex audio transcription routing improvements.
- Control UI β Cron sidebar and chat refinements; workspace and plugin snapshot performance work.
- Channels β Slack rich progress streaming; Discord status/degraded handling; dependency and gateway startup/diagnostics refresh.
- Docs β IRC notes on raw TCP/TLS expectations where relevant.
v2026.5.3 β What's new for you
Stable Β· May 4, 2026. Full release notes on GitHub Β· Source (ZIP) Β· Source (tar.gz) Β· follow-up v2026.5.3-1
- File transfer (bundled plugin) β Agent tools
file_fetch, dir_list, dir_fetch, and file_write for binary ops on paired nodes; default-deny path policy with optional symlink handling (off by default) and per-request size limits.
- Gateway performance β Lazy-loads discovery, cron, schema, shutdown, sessions, and model metadata so startup and Control UI hot paths do less work until needed.
- Channels and streaming β Unified
streaming.mode: "progress" draft lines across Discord, Telegram, Matrix, Slack, and Microsoft Teams; WhatsApp Channel/Newsletter targets; broad delivery and recovery fixes.
- CLI and queue β
/steer <target> to steer the active run when the session is idle; /side as an alias for /btw side questions.
- Config and doctor β Invalid config is not auto-restored on startup or hot reload (fails closed; use
openclaw doctor --fix); doctor --fix can apply safe legacy migrations even when other validation errors remain.
- Install and plugins β Hardened official plugin install/update and ClawHub paths; macOS LaunchAgent upgrade recovery; reject source-only plugin packages before load.
v2026.4.29 β What's new for you
Released April 30, 2026. Full release notes on GitHub Β· Source (ZIP) Β· Source (tar.gz)
- Messaging and automation β Default active-run queueing uses
steer (drain steering at the next model boundary); optional messages.visibleReplies can require visible output through message(action=send); subagent events carry spawnedBy for routing; opt-in inferred follow-up commitments with heartbeat delivery.
- Memory β People-aware wiki metadata (person cards, relationship graphs, provenance views); per-conversation Active Memory allow/deny chat filters; partial recall when the memory sub-agent times out; read-only REM preview RPC for operators.
- Providers and models β Bundled NVIDIA provider with API-key onboarding and catalog metadata; Bedrock and Codex streaming/replay fixes; stale inline Codex model entries are suppressed to avoid assistant-turn failures.
- Gateway and plugins β SQLite-backed keyed plugin state store; optional startup diagnostics timeline;
pnpm gateway:watch defaults to a named tmux session; dependency and tooling refresh.
- Security and operations β OpenGrep rulepack and Code Scanning workflows; stricter GHSA triage notes; tool sections no longer widen restrictive profiles without explicit
alsoAllow (see breaking changes above).
- Channels and reliability β Fixes across Slack Block Kit limits, Telegram proxy/webhook/polling/sends, Discord startup/rate limits, WhatsApp delivery/liveness, and Teams/Matrix/Feishu edge cases; browser control shares one runtime across HTTP control and
browser.request.
v2026.4.27 β What's new for you
Released April 29, 2026. Full release notes on GitHub Β· Source (ZIP)
- Codex Computer Use setup β Codex mode now has explicit setup/status/install flows, marketplace discovery, and fail-closed MCP checks before desktop-control turns.
- New provider support β DeepInfra joins bundled providers with model discovery plus media generation/editing, TTS, embeddings, and onboarding policy integration.
- Channel expansion β Tencent Yuanbao docs/catalog coverage lands, and QQBot gains stronger group-chat, streaming, and media upload behavior.
- Plugin and model catalogs β More providers shift to manifest-backed model catalogs, reducing startup overhead and making aliases/suppressions easier to audit.
- Networking and Docker β Adds opt-in outbound proxy routing and optional Docker GPU passthrough for sandboxed workloads on compatible hosts.
- Stability and reliability β Broad fixes across gateway startup, Telegram/Slack behavior, update sync, session defaults, and platform restart handoffs.
v2026.4.26 β What's new for you
Released April 28, 2026. Full release notes on GitHub Β· Source (ZIP)
- Talk realtime transport β browser Talk adds generic realtime transport contracts, Google Live browser sessions, and relay improvements for backend-only realtime voice plugins.
- Providers β Cerebras arrives as a bundled provider plugin with onboarding, docs, and manifest-owned endpoint metadata.
- Migration tooling β new
openclaw migrate flow and importers for Claude/Hermes setup artifacts, with dry-run and backup-friendly paths.
- Model and plugin infrastructure β provider-filtered model listing authority is tightened; bundled-provider endpoint/model routing metadata shifts into plugin manifests.
- Control UI and ops β raw-config pending-change diff panel, quick-settings layout polish, and Matrix encryption setup CLI improvements.
- Fixes β broad reliability and security updates across update/install verification, startup behavior, token rotation handling, plugin discovery/install, proxy support, local-model defaults, and channel delivery stability.
Since v2026.4.27 β quick delta
If your last stable checkpoint was v2026.4.27, focus on these changes first:
- Queueing and visible replies β default
steer behavior for active runs and optional messages.visibleReplies to enforce user-visible sends.
- Memory and wiki β people-aware wiki surfaces, tighter Active Memory scoping per chat, and partial recall on memory-subagent timeout.
- Providers β NVIDIA as a bundled provider; follow-up fixes for Codex streaming and stale inline model entries.
- Security and config semantics β OpenGrep in-repo scanning; restrictive tool profiles may need explicit
alsoAllow when you configure tools.exec / tools.fs.
- Reliability β channel fixes (Slack, Telegram, Discord, WhatsApp, Teams, Matrix, Feishu), shared browser-control runtime, and gateway/plugin startup diagnostics.
v2026.4.14 β What's new for you
Released April 14, 2026. Full release notes on GitHub Β· Source (ZIP)
- Codex + GPT-5.4 β Forward-compat support for
gpt-5.4-pro and codex model alias/runtime fixes.
- Telegram topics β Human topic names are learned and persisted so prompt/context metadata stays readable after restarts.
- Security hardening β Multiple channel, browser, gateway, and media-path hardening fixes landed (including strict policy paths and safer auth/allowlist handling).
- Ollama + OpenAI-compatible β Streaming usage includes
stream_options.include_usage so local usage accounting is accurate.
- UI stability β Control UI markdown renderer moved to
markdown-it to avoid ReDoS freeze cases.
- Channel reliability β Significant fixes across Discord, Telegram, Matrix, WhatsApp, and BlueBubbles routing and recovery.
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
Full changelog for each release on GitHub: