📜 Changelog
User-centric release notes. We highlight what matters most: new features, improvements, and breaking changes you need to know. Full technical details are on the official GitHub releases.
View all releases on GitHub → · Latest: v2026.4.21
Latest stable quality pass: OpenAI image generation defaults move to `gpt-image-2`, doctor can now repair missing bundled plugin runtime dependencies in packaged installs, image provider/model fallback failures are logged clearly, owner-enforced command checks are tightened, Slack runtime sends preserve `threadTs` aliases, browser invalid accessibility refs fail fast, and npm install noise is reduced via `node-domexception` override mirroring.
Release focused on setup UX, prompt quality, operational guardrails, and channel/runtime reliability: improved onboarding security UI and model-load feedback, stronger default agent prompts, tiered model pricing support, session-store maintenance caps, cron state-file split, Moonshot Kimi defaults, and broad fixes across owner-command enforcement, startup dependency repair, thinking/reasoning controls, Slack/Telegram/Matrix/BlueBubbles delivery, and gateway security boundaries.
Broad platform and packaging release: Anthropic defaults move to Claude Opus 4.7, Gemini TTS is added, Model Auth health appears in Control UI, LanceDB cloud storage and Copilot embeddings expand memory options, and bundled plugin packaging/runtime boundaries are tightened. Reliability fixes span security hardening, replay/session recovery, channel behavior, Dreaming/memory ingestion, auth propagation, and local-model failover behavior.
Quality-focused release with GPT-5 family improvements and broad provider/channel reliability fixes: forward-compat for `gpt-5.4-pro`, Telegram forum topic names persisted into context/metadata, Codex catalog `apiKey` visibility fix, media tool model normalization for image/PDF, stricter Slack interaction allowlist checks, gateway-tool guardrails blocking newly-enabled dangerous config flags, improved Ollama usage accounting and timeout wiring, browser/CDP SSRF policy fixes, and many memory/dreaming, queueing, keepalive, and channel stability repairs.
Broad quality release centered on plugin loading boundaries, memory/dreaming reliability, and local-model ergonomics: scoped plugin activation by manifest intent, bundled LM Studio provider with onboarding and embeddings, Active Memory plugin and Codex/exec-policy/gateway command discovery refinements, and many fixes across startup sequencing, chat command catalog, dreaming promotion/diary behavior, keepalive, queueing, and channel delivery.
Dreaming and memory-wiki: ChatGPT import ingestion with Imported Insights and Memory Palace diary subtabs; Control UI / webchat: structured bubbles for media/reply/voice, `[embed ...]` rich output with gated URLs; `video_generate`: URL-only asset delivery, `providerOptions`, reference audio, adaptive aspect, higher image-input cap; Feishu document-comment threads with reactions; Teams reactions with Graph pagination and delegated OAuth for sends; plugin manifests gain activation/setup descriptors; Ollama caches `/api/show` context during discovery; plus Codex OAuth scope fix, transcription DNS, Talk Mode mic permission, WhatsApp default account and reactions, and many agent/QA fixes.
Bundled Codex provider with plugin-owned app-server harness for `codex/gpt-*` models; optional Active Memory plugin (dedicated memory sub-agent before replies); experimental MLX speech for Talk Mode on macOS; Seedance 2.0 in fal video tooling; Teams message actions; `openclaw exec-policy` CLI; gateway `commands.list` RPC; Matrix MSC4357 draft streaming markers; broad browser/sandbox/exec security hardening; plus fixes for WhatsApp media, Teams downloads, gateway startup, and many channel routing edge cases.
Dreaming: grounded REM backfill with `rem-harness --path`, diary timeline, and promotion integration; Control UI diary/Scene improvements; provider `providerAuthAliases` in manifests; iOS CalVer pinning workflow; security fixes for browser SSRF after interactions, dotenv hardening, sanitized node exec events, and safer plugin onboarding auth collisions.
Recovery release: fix packaged npm builds loading Telegram and other bundled channels via top-level sidecars (no missing `dist/extensions/.../src` imports); align bundled plugin compatibility metadata with the release; Slack proxy and Socket Mode fixes; `update_plan` behavior for OpenAI-family runs; exec default reporting aligned with `host=auto`.
`openclaw infer` hub for provider-backed inference; memory-wiki stack restored (CLI, sync, claims, search); bundled webhook ingress plugin for TaskFlows; persisted compaction checkpoints with Sessions UI branch/restore; pluggable compaction providers; `agents.defaults.systemPromptOverride`; Gemma 4 and Arcee AI provider additions; Discord event cover images; many agent history and Control UI fixes.
Built-in `video_generate` and `music_generate` tools; bundled ComfyUI workflow plugin; provider expansion (Qwen, Fireworks, StepFun, Bedrock Mantle inference profiles, MiniMax TTS/search); multilingual Control UI; ClawHub flows in the Skills panel; `openclaw plugins install --force`; experimental memory dreaming with `/dreaming` and Dreams UI; Claude Code CLI via loopback MCP + stream-json streaming; richer `openclaw config schema` metadata; large security and prompt-cache hardening — plus breaking removal of legacy config alias paths (use `openclaw doctor --fix`).
Restored Task Flow substrate with durable state, managed child tasks, and `api.runtime.taskFlow` for plugins; breaking moves of xAI `x_search` and Firecrawl `web_fetch` config into plugin-owned paths (`openclaw doctor --fix`); Android Google Assistant App Actions; `before_agent_reply` hook; gateway/node host exec defaults aligned to low-friction approvals; Feishu Drive comment threads; Matrix `m.mentions`; compaction model + optional `agents.defaults.compaction.notifyUser`; deep provider transport hardening and many exec-approval fixes.
Chat-native `/tasks` board, bundled SearXNG `web_search` plugin, Amazon Bedrock Guardrails, Voice Wake for Talk Mode, per-cron tool allowlists (`openclaw cron --tools`), global `agents.defaults.params`, smarter rate-limit failover, and broad reliability fixes for tasks, gateway reload, and exec approvals.
Unified SQLite background-task ledger for ACP, subagents, cron, and detached CLI; first-class `openclaw flows` for task-flow control; new QQ Bot channel plugin; major Matrix upgrades (streaming, proxy, history, threads); remote HTTP/SSE MCP servers; stricter plugin and skill install scans; plus breaking security changes for node execution, trusted-proxy auth, and node command gating.
Qwen OAuth portal auth removal (migrate to Model Studio API key), xAI Responses + x_search integration, MiniMax image generation, plugin approval hooks, OpenAI apply_patch default-on, and new config schema CLI.
OpenAI compatibility endpoints, richer tools visibility in /tools and Control UI, Teams SDK migration, Slack interactive parity restore, container-targeted CLI commands, and skills setup UX improvements.
ModelStudio/Qwen DashScope endpoints, UI/clarity refinements (Knot theme, config icons, roundness), CSP hashes for Control UI, bundled plugin runtimes restored, channel auth fixes, ClawHub compatibility, and many stability fixes.
Native openclaw skills search|install|update, ClawHub-first plugin install, openclaw update --tag main, /plugins chat commands, new Matrix plugin, Claude marketplace, Chutes/Exa/Tavily/Firecrawl providers, and breaking changes for Chrome relay, nano-banana-pro, and legacy env vars.
Recovery release for v2026.3.13 tag path. Compaction fix, Telegram media SSRF, Discord gateway handling, session reset preservation, Android chat settings, Docker OPENCLAW_TZ, Slack interactive replies, and many stability fixes.
Control UI dashboard refresh, /fast toggle for Anthropic & OpenAI, Slack Block Kit, sessions_yield for subagents, K8s docs, Ollama/vLLM/SGLang provider-plugin architecture, and multiple security hardening fixes.
Security fix for WebSocket hijacking, Discord thread auto-archive config, Gemini memory embeddings, first-class Ollama setup, OpenCode Go, cron notification tightening, and macOS/iOS onboarding improvements.
TUI agent inference from workspace, Brave LLM Context mode for web search, talk.silenceTimeoutMs, openclaw --version with git hash, macOS remote gateway token, backup create/verify polish, plus Docker image pruning and plugin onboarding fixes.
Context engine plugins, persistent ACP channel bindings, Telegram topic routing, Spanish locale, gateway auth mode, Gemini 3.1 Flash-Lite, Docker slim builds, and many fixes. Requires explicit gateway.auth.mode when both token and password are set.
Major quality-of-life release: stop OpenClaw with natural language, native PDF analysis, Telegram streaming by default, and Ollama memory embeddings. New users get safer defaults with messaging-only profile and ACP dispatch.
Major feature release: adaptive thinking, container health probes, Android nodes, Discord threads, Telegram DM topics, OpenAI WebSocket, Feishu upgrades, external secrets, ACP thread agents, and more.
### Changes - Highlight: External Secrets Management introduces a full `openclaw secrets` workflow (`audit`, `configure`, `apply`, `reload`) with runtime snapshot activation, strict `secrets apply` …
### Changes - Android/Chat: improve streaming delivery handling and markdown rendering quality in the native Android chat UI, including better GitHub-flavored markdown behavior. (#26079) Thanks @obv…
### Changes - Auto-reply/Abort shortcuts: expand standalone stop phrases (`stop openclaw`, `stop action`, `stop run`, `stop agent`, `please stop`, and related variants), accept trailing punctuation …
### Changes - Providers/Kilo Gateway: add first-class `kilocode` provider support (auth, onboarding, implicit provider detection, model defaults, transcript/cache-ttl handling, and docs), with defau…
### Changes - Provider/Mistral: add support for the Mistral provider, including memory embeddings and voice support. (#23845) Thanks @vincentkoc. - Update/Core: add an optional built-in auto-updater …
### Changes - Models/Google: add Gemini 3.1 support (`google/gemini-3.1-pro-preview`). - Providers/Onboarding: add Volcano Engine (Doubao) and BytePlus providers/models (including coding variants), …
### Changes - iOS/Watch: add an Apple Watch companion MVP with watch inbox UI, watch notification relay handling, and gateway command surfaces for watch status/send flows. (#20054) Thanks @mbelinky…
### Changes - Agents/Anthropic: add opt-in 1M context beta header support for Opus/Sonnet via model `params.context1m: true` (maps to `anthropic-beta: context-1m-2025-08-07`). - Agents/Models: sup…
### Changes - Discord: unlock rich interactive agent prompts with Components v2 (buttons, selects, modals, and attachment-backed file blocks) so for native interaction through Discord. Thanks @thewi…
### Changes - Telegram: add poll sending via `openclaw message poll` (duration seconds, silent delivery, anonymity controls). (#16209) Thanks @robbyczgw-cla. - Slack/Discord: add `dmPolicy` + `all…
### Changes - Discord: send voice messages with waveform previews from local audio files (including silent delivery). (#7253) Thanks @nyanjou. - Discord: add configurable presence status/activity/ty…
### Changes - CLI: add `openclaw logs --local-time` to display log timestamps in local timezone. (#13818) Thanks @xialonglee. - Telegram: render blockquotes as native `<blockquote>` tags instead of …
### Added - iOS: alpha node app + setup-code onboarding. (#11756) Thanks @mbelinky. - Channels: comprehensive BlueBubbles and channel cleanup. (#11093) Thanks @tyler6204. - Plugins: device pairing +…
### Changes - Models: support Anthropic Opus 4.6 and OpenAI Codex gpt-5.3-codex (forward-compat fallbacks). (#9853, #10720, #9995) Thanks @TinyTb, @calvin-hpnet, @tyler6204. - Providers: add xAI (…
### Changes - Telegram: remove last `@ts-nocheck` from `bot-handlers.ts`, use Grammy types directly, deduplicate `StickerMetadata`. Zero `@ts-nocheck` remaining in `src/telegram/`. (#9206) - Telegram…
### Changes - Feishu: add Feishu/Lark plugin support + docs. (#7313) Thanks @jiulingyun (openclaw-cn). - Web UI: add Agents dashboard for managing agent files, tools, skills, models, channels, and c…
### Changes - Docs: onboarding/install/i18n/exec-approvals/Control UI/exe.dev/cacheRetention updates + misc nav/typos. (#3050, #3461, #4064, #4675, #4729, #4763, #5003, #5402, #5446, #5474, #5663, #…
### Changes - CLI: add `completion` command (Zsh/Bash/PowerShell/Fish) and auto-setup during postinstall/onboarding. - CLI: add per-agent `models status` (`--agent` filter). (#4780) Thanks @jlowin. …
Status: stable. ### Changes - Rebrand: rename the npm package/CLI to `openclaw`, add a `openclaw` compatibility shim, and move extensions to the `@openclaw/*` scope. - Onboarding: strengthen security…
## 2026.1.24 ### Highlights - Providers: Ollama discovery + docs; Venice guide upgrades + cross-links. (#1606) Thanks @abhaymundhara. https://docs.clawd.bot/providers/ollama https://docs.clawd.bot/pr…
## 2026.1.23 ### Highlights - TTS: move Telegram TTS into core + enable model-driven TTS tags by default for expressive audio replies. (#1559) Thanks @Glucksberg. https://docs.clawd.bot/tts - Gateway…
### Changes - Highlight: Compaction safeguard now uses adaptive chunking, progressive fallback, and UI status + retries. (#1466) Thanks @dlauer. - Providers: add Antigravity usage tracking to status o…
### Highlights - Lobster optional plugin tool for typed workflows + approval gates. [docs](https://docs.clawd.bot/tools/lobster) - Custom assistant identity + avatars in the Control UI. [docs](https:/…
### Changes - Control UI: add copy-as-markdown with error feedback. (#1345) https://docs.clawd.bot/web/control-ui - Control UI: drop the legacy list view. (#1345) https://docs.clawd.bot/web/control-ui…
### Highlights - Hooks: add hooks system with bundled hooks, CLI tooling, and docs. (#1028) — thanks @ThomsenDrake. https://docs.clawd.bot/hooks - Media: add inbound media understanding (image/audio/v…
### Highlights - Plugins: add provider auth registry + `clawdbot models auth login` for plugin-driven OAuth/API key flows. - Browser: improve remote CDP/Browserless support (auth passthrough, `wss` u…
### Install - npm i -g clawdbot@2026.1.14-1 ### Highlights - Web search: `web_search`/`web_fetch` tools (Brave API) + first-time setup in onboarding/configure. - Browser control: Chrome extension re…
### Fixes - Packaging: include `dist/memory/**` in the npm tarball (fixes `ERR_MODULE_NOT_FOUND` for `dist/memory/index.js`). …
### Fixes - CLI: avoid top-level await warnings in the entrypoint on fresh installs. - CLI: show a commit hash in the banner for npm installs (package.json gitHead fallback). …
### Highlights - CLI: `clawdbot status` now table-based + shows OS/update/gateway/daemon/agents/sessions; `status --all` adds a full read-only debug report (tables, log tails, Tailscale summary, and …
### Highlights - Microsoft Teams provider: polling, attachments, outbound CLI send, per-channel policy. - Models/Auth expansion: OpenCode Zen + MiniMax API onboarding; token auth profiles + auth orde…
## 2026.1.8 ### Highlights - Security: DMs locked down by default across providers; pairing-first + allowlist guidance. - Sandbox: per-agent scope defaults + workspace access controls; tool/session i…
## Fixes - NPM package: include missing runtime dist folders (slack/signal/imessage/tui/wizard/control-ui/daemon) to avoid ERR_MODULE_NOT_FOUND in Node 25 npx installs.…
### Fixed - Media: preserve GIF animation when uploading to Discord/other providers (skip JPEG optimization for image/gif). - Agent runtime: update pi-mono dependencies to 0.31.1 (agent-core split). …
warelay 1.3.0 (2025-12-02) ### Highlights - **Pluggable agents (Claude, Pi, Codex, Opencode):** New `inbound.reply.agent` block chooses the CLI and parser per command reply; per-agent argv builders i…
- Manual heartbeat sends: warelay heartbeat accepts --message/--body with --provider web|twilio to push real outbound messages; --dry-run previews payloads without sending. - SHA256: bb4f80a8c4d92ceed…
warelay 1.2.1\n\n- Heartbeat: warelay heartbeat now supports --message/--body for manual sends on web or twilio, with --dry-run to preview payloads.\n- Media handling: MIME-first detection (magic byte…
- Heartbeat UX: default 10 m; prompt `HEARTBEAT ultrathink`; `HEARTBEAT_OK` suppresses sends; skipped heartbeats don’t refresh sessions; fallback heartbeats no longer start new sessions; supports `hea…
- Web auto-replies now resize/recompress media, honor inbound.reply.mediaMaxMb, detect media kind, and enforce provider caps. - Sessions can send the system prompt only once (optional sessionIntro) an…
### Features - Added `cwd` option to command reply config so external reply commands (e.g., Claude Code) run in the intended working directory for correct context. - Added configurable file-based logg…
- Fix commander help config for TypeScript build (subcommandTerm). - Bump version and web UA to 0.1.2; keeps tagline/help polish from 0.1.1. Install: ```bash npm install -g warelay@0.1.2 # or npx war…
- Added executable shim so npx warelay@0.1.x runs the CLI directly. - Help/version banner uses README tagline with color and a colored examples footer. - Added --verbose to send and status for consist…