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:
- 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
Full changelog for each release on GitHub: