Fixes

• Installer: include patches/ in the npm package so postinstall patching works for npm/bun installs.

View full changelog

Highlights

• Plugins are now first-class: loader + CLI management, plus the new Voice Call plugin.
• Config: modular $include support for split config files. (#731) — thanks @pasogott.
• Agents/Pi: reserve compaction headroom so pre-compaction memory writes can run before auto-compaction.
• Agents: automatic pre-compaction memory flush turn to store durable memories before compaction.

Changes

• Deps: update pi-agent-core/pi-ai/pi-coding-agent/pi-tui and refresh the pi-ai patch.
• Dev: bump @types/node.
• macOS: add wizard debug CLI and share wizard parsing helpers.
• CLI/Onboarding: simplify MiniMax auth choice to a single M2.1 option.
• CLI: configure section selection now loops until Continue.
• Docs: explain MiniMax vs MiniMax Lightning (speed vs cost) and restore LM Studio example.
• Docs: add Cerebras GLM 4.6/4.7 config example (OpenAI-compatible endpoint).
• Onboarding/CLI: group model/auth choice by provider and label Z.AI as GLM 4.7.
• Onboarding/Docs: add Moonshot AI (Kimi K2) auth choice + config example.
• CLI/Onboarding: prompt to reuse detected API keys for Moonshot/MiniMax/Z.AI/Gemini/Anthropic/OpenCode.
• CLI/Onboarding: move MiniMax to the top of the provider list.
• CLI/Onboarding: add MiniMax M2.1 Lightning auth choice.
• CLI/Onboarding: show key previews when reusing detected API keys.
• Auto-reply: add compact /model picker (models + available providers) and show provider endpoints in /model status.
• Control UI: add Config tab model presets (MiniMax M2.1, GLM 4.7, Kimi) for one-click setup.
• Plugins: add extension loader (tools/RPC/CLI/services), discovery paths, and config schema + Control UI labels (uiHints).
• Plugins: add clawdbot plugins install (path/tgz/npm), plus list|info|enable|disable|doctor UX.
• Plugins: voice-call plugin now real (Twilio/log), adds start/status RPC/CLI/tool + tests.
• Docs: add plugins doc + cross-links from tools/skills/gateway config.
• Docs: clarify memory flush behavior + writable workspace requirement in Memory/Session/FAQ.
• Docs: add beginner-friendly plugin quick start + expand Voice Call plugin docs.
• Tests: add Docker plugin loader + tgz-install smoke test.
• Tests: extend Docker plugin E2E to cover installing from local folders (plugins.load.paths) and file: npm specs.
• Tests: add coverage for pre-compaction memory flush settings (including read-only/CLI skips).
• Tests: modernize live model smoke selection for current releases and enforce tools/images/thinking-high coverage. (#769) — thanks @steipete.
• Agents/Tools: add apply_patch tool for multi-file edits (experimental; gated by tools.exec.applyPatch; OpenAI-only).
• Agents/Tools: rename the bash tool to exec (config alias maintained). (#748) — thanks @myfunc.
• Agents: add pre-compaction memory flush config (agents.defaults.compaction.*) with a soft threshold + system prompt.
• Config: add $include directive for modular config files. (#731) — thanks @pasogott.
• Build: set pnpm minimum release age to 2880 minutes (2 days). (#718) — thanks @dan-dr.
• macOS: prompt to install the global clawdbot CLI when missing in local mode; install via clawd.bot/install-cli.sh (no onboarding) and use external launchd/CLI instead of the embedded gateway runtime.
• Docs: add gog calendar event color IDs from gog calendar colors. (#715) — thanks @mjrussell.
• Cron/CLI: add --model flag to cron add/edit commands. (#711) — thanks @mjrussell.
• Cron/CLI: trim model overrides on cron edits and document main-session guidance. (#711) — thanks @mjrussell.
• Skills: bundle skill-creator to guide creating and packaging skills.
• Providers: add per-DM history limit overrides (dmHistoryLimit) with provider-level config. (#728) — thanks @pkrmf.
• Discord: expose channel/category management actions in the message tool. (#730) — thanks @NicholasSpisak.
• Docs: rename README “macOS app” section to “Apps”. (#733) — thanks @AbhisekBasu1.
• Gateway: require client.id in WebSocket connect params; use client.instanceId for presence de-dupe; update docs/tests.
• macOS: remove the attach-only gateway setting; local mode now always manages launchd while still attaching to an existing gateway if present.

Installer

• Postinstall: replace git apply with builtin JS patcher (works npm/pnpm/bun; no git dependency) plus regression tests.
• Postinstall: skip pnpm patch fallback when the new patcher is active.
• Installer tests: add root+non-root docker smokes, CI workflow to fetch clawd.bot scripts and run install sh/cli with onboarding skipped.
• Installer UX: support CLAWDBOT_NO_ONBOARD=1 for non-interactive installs; fix npm prefix on Linux and auto-install git.
• Installer UX: add install.sh --help with flags/env and git install hint.
• Installer UX: add --install-method git|npm and auto-detect source checkouts (prompt to update git checkout vs migrate to npm).

Fixes

• Control UI: flatten nav into a single horizontal scroll row on tablet/mobile (and always show collapsed group items). (#771) — thanks @carlulsoe.
• macOS: start + await local gateway before onboarding wizard begins.
• macOS: cancel onboarding wizard on close, recover if the gateway drops the session, and time out stalled gateway connects.
• macOS: wizard debug CLI now surfaces error status instead of exiting as complete.
• Models/Onboarding: configure MiniMax (minimax.io) via Anthropic-compatible /anthropic endpoint by default (keep minimax-api as a legacy alias).
• Agents/Browser: cap Playwright AI snapshots for tool calls (maxChars); CLI snapshots remain full. (#763) — thanks @thesash.
• Models: normalize Gemini 3 Pro/Flash IDs to preview names for live model lookups. (#769) — thanks @steipete.
• CLI: fix guardCancel typing for configure prompts. (#769) — thanks @steipete.
• Providers: default groupPolicy to allowlist across providers and warn in doctor when groups are open.
• MS Teams: add groupPolicy/groupAllowFrom gating for group chats and warn when groups are open.
• Providers: strip tool call/result ids from Gemini CLI payloads to avoid API 400s. (#756)
• Gateway/WebChat: include handshake validation details in the WebSocket close reason for easier debugging; preserve close codes.
• Gateway/Auth: send invalid connect responses before closing the handshake; stabilize invalid-connect auth test.
• Gateway: tighten gateway listener detection.
• Control UI: hide onboarding chat when configured and guard the mobile chat sidebar overlay.
• Auth: read Codex keychain credentials and make the lookup platform-aware.
• macOS/Release: avoid bundling dist artifacts in relay builds and generate appcasts from zip-only sources.
• Doctor: surface plugin diagnostics in the report.
• Plugins: treat plugins.load.paths directory entries as package roots when they contain package.json + clawdbot.extensions; load plugin packages from config dirs; extract archives without system tar.
• Config: expand ~ in CLAWDBOT_CONFIG_PATH and common path-like config fields (including plugins.load.paths); guard invalid $include paths. (#731) — thanks @pasogott.
• Agents: stop pre-creating session transcripts so first user messages persist in JSONL history.
• Agents: skip pre-compaction memory flush when the session workspace is read-only.
• Auto-reply: allow inline /status for allowlisted senders (stripped before the model); unauthorized senders see it as plain text.
• Auto-reply: include config-only allowlisted models in /model even when the catalog is partial.
• Auto-reply: allow fuzzy /model matches (e.g. /model kimi or /model moonshot/kimi) when unambiguous.
• Auto-reply: ignore inline /status directives unless the message is directive-only.
• CLI/Configure: enter the selected section immediately, then return to the section picker.
• CLI/Configure: apply the chosen auth model as default (skip the extra picker) and refresh the model catalog for new providers.
• Auto-reply: align /think default display with model reasoning defaults. (#751) — thanks @gabriel-trigo.
• Auto-reply: flush block reply buffers on tool boundaries. (#750) — thanks @sebslight.
• Auto-reply: allow sender fallback for command authorization when SenderId is empty (WhatsApp self-chat). (#755) — thanks @juanpablodlc.
• Heartbeat: refresh prompt text for updated defaults.
• Agents/Tools: use PowerShell on Windows to capture system utility output. (#748) — thanks @myfunc.
• Agents/Tools: normalize Claude Code-style read/write/edit params (file_path/old_string/new_string) and keep sandbox guards in place. (#768) — thanks @hsrvc.
• Docker: tolerate unset optional env vars in docker-setup.sh under strict mode. (#725) — thanks @petradonka.
• CLI/Update: preserve base environment when passing overrides to update subprocesses. (#713) — thanks @danielz1z.
• Agents: treat message tool errors as failures so fallback replies still send; require to + message for action=send. (#717) — thanks @theglove44.
• Agents: preserve reasoning items on tool-only turns.
• Agents: enforce gating for reasoning-tag providers to prevent tag/reasoning leaks. (#754) — thanks @mcinteerj.
• Agents/Subagents: wait for completion before announcing, align wait timeout with run timeout, and make announce prompts more emphatic.
• Agents: route subagent transcripts to the target agent sessions directory and add regression coverage. (#708) — thanks @xMikeMickelson.
• Agents/Tools: preserve action enums when flattening tool schemas. (#708) — thanks @xMikeMickelson.
• Gateway/Agents: canonicalize main session aliases for store writes and add regression coverage. (#709) — thanks @xMikeMickelson.
• Agents: reset sessions and retry when auto-compaction overflows instead of crashing the gateway.
• Providers/Telegram: normalize command mentions for consistent parsing. (#729) — thanks @obviyus.
• Providers: skip DM history limit handling for non-DM sessions. (#728) — thanks @pkrmf.
• Sandbox: fix non-main mode incorrectly sandboxing the main DM session and align /status runtime reporting with effective sandbox state.
• Sandbox/Gateway: treat agent::main as a main-session alias when session.mainKey is customized (backwards compatible).
• Auto-reply: fast-path allowlisted slash commands (inline /help//commands//status//whoami stripped before model).

View full changelog

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 scan progress via OSC-9 + spinner).
• CLI Backends: add Codex CLI fallback with resume support (text output) and JSONL parsing for new runs, plus a live CLI resume probe.
• CLI: add clawdbot update (safe-ish git checkout update) + --update shorthand. (#673) — thanks @fm1randa.
• Gateway: add OpenAI-compatible /v1/chat/completions HTTP endpoint (auth, SSE streaming, per-agent routing). (#680) — thanks @steipete.

Changes

• Onboarding/Models: add first-class Z.AI (GLM) auth choice (zai-api-key) + --zai-api-key flag.
• CLI/Onboarding: add OpenRouter API key auth option in configure/onboard. (#703) — thanks @mteam88.
• Agents: add human-delay pacing between block replies (modes: off/natural/custom, per-agent configurable). (#446) — thanks @tony-freedomology.
• Agents/Browser: add browser.target (sandbox/host/custom) with sandbox host-control gating via agents.defaults.sandbox.browser.allowHostControl, allowlists for custom control URLs/hosts/ports, and expand browser tool docs (remote control, profiles, internals).
• Onboarding/Models: add catalog-backed default model picker to onboarding + configure. (#611) — thanks @jonasjancarik.
• Agents/OpenCode Zen: update fallback models + defaults, keep legacy alias mappings. (#669) — thanks @magimetal.
• Providers: unify group history context wrappers across providers with per-provider/per-account historyLimit overrides (fallback to messages.groupChat.historyLimit). Set 0 to disable. (#672) — thanks @steipete.
• Gateway/Heartbeat: optionally deliver heartbeat Reasoning: output (agents.defaults.heartbeat.includeReasoning). (#690)
• Docker: allow optional home volume + extra bind mounts in docker-setup.sh. (#679) — thanks @gabriel-trigo.

Fixes

• CLI/Status: expand tables to full terminal width; clarify provider setup vs runtime warnings; richer per-provider detail; token previews in status while keeping status --all redacted; add troubleshooting link footer; keep log tails pasteable; show gateway auth used when reachable; surface provider runtime errors (Signal/iMessage/Slack); harden tailscale status --json parsing; make status --all scan progress determinate; and replace the footer with a 3-line “Next steps” recommendation (share/debug/probe).
• CLI/Gateway: clarify that clawdbot gateway status reports RPC health (connect + RPC) and shows RPC failures separately from connect failures.
• CLI/Update: gate progress spinner on stdout TTY and align clean-check step label. (#701) — thanks @bjesuiter.
• Telegram: add /whoami + /id commands to reveal sender id for allowlists; allow @username and prefixed ids in allowFrom prompts (with stability warning).
• Control UI: stop auto-writing telegram.groups["*"] and warn/confirm before enabling wildcard groups.
• WhatsApp: send ack reactions only for handled messages and ignore legacy messages.ackReaction (doctor copies to whatsapp.ackReaction). (#629) — thanks @pasogott.
• Sandbox/Skills: mirror skills into sandbox workspaces for read-only mounts so SKILL.md stays accessible.
• Terminal/Table: ANSI-safe wrapping to prevent table clipping/color loss; add regression coverage.
• Docker: allow optional apt packages during image build and document the build arg. (#697) — thanks @gabriel-trigo.
• Gateway/Heartbeat: deliver reasoning even when the main heartbeat reply is HEARTBEAT_OK. (#694) — thanks @antons.
• macOS: clear unsigned launchd overrides on signed restarts and warn via doctor when attach-only/disable markers are set. (#695) — thanks @jeffersonwarrior.
• Agents: enforce single-writer session locks and drop orphan tool results to prevent tool-call ID failures (MiniMax/Anthropic-compatible APIs).
• Docs: make clawdbot status the first diagnostic step, clarify status --deep behavior, and document /whoami + /id.
• Docs/Testing: clarify live tool+image probes and how to list your testable provider/model ids.
• Tests/Live: make gateway bash+read probes resilient to provider formatting while still validating real tool calls.
• WhatsApp: detect @lid mentions in groups using authDir reverse mapping + resolve self JID E.164 for mention gating. (#692) — thanks @peschee.
• Gateway/Auth: default to token auth on loopback during onboarding, add doctor token generation flow, and tighten audio transcription config to Whisper-only.
• Providers: dedupe inbound messages across providers to avoid duplicate LLM runs on redeliveries/reconnects. (#689) — thanks @adam91holt.
• Agents: strip / tags from hidden reasoning output and cover tag variants in tests. (#688) — thanks @theglove44.
• macOS: save model picker selections as normalized provider/model IDs and keep manual entries aligned. (#683) — thanks @benithors.
• Agents: recognize "usage limit" errors as rate limits for failover. (#687) — thanks @evalexpr.
• CLI: avoid success message when daemon restart is skipped. (#685) — thanks @carlulsoe.
• Commands: disable /config + /debug by default; gate via commands.config/commands.debug and hide from native registration/help output.
• Agents/System: clarify that sub-agents remain sandboxed and cannot use elevated host access.
• Gateway: disable the OpenAI-compatible /v1/chat/completions endpoint by default; enable via gateway.http.endpoints.chatCompletions.enabled=true.
• macOS: stabilize bridge tunnels, guard invoke senders on disconnect, and drain stdout/stderr to avoid deadlocks. (#676) — thanks @ngutman.
• Agents/System: clarify sandboxed runtime in system prompt and surface elevated availability when sandboxed.
• Auto-reply: prefer RawBody for command/directive parsing (WhatsApp + Discord) and prevent fallback runs from clobbering concurrent session updates. (#643) — thanks @mcinteerj.
• WhatsApp: fix group reactions by preserving message IDs and sender JIDs in history; normalize participant phone numbers to JIDs in outbound reactions. (#640) — thanks @mcinteerj.
• WhatsApp: expose group participant IDs to the model so reactions can target the right sender.
• Cron: wakeMode: "now" waits for heartbeat completion (and retries when the main lane is busy). (#666) — thanks @roshanasingh4.
• Agents/OpenAI: fix Responses tool-only → follow-up turn handling (avoid standalone reasoning items that trigger 400 “required following item”) and replay reasoning items in Responses/Codex Responses history for tool-call-only turns.
• Sandbox: add clawdbot sandbox explain (effective policy inspector + fix-it keys); improve “sandbox jail” tool-policy/elevated errors with actionable config key paths; link to docs.
• Hooks/Gmail: keep Tailscale serve path at / while preserving the public path. (#668) — thanks @antons.
• Hooks/Gmail: allow Tailscale target URLs to preserve internal serve paths.
• Auth: update Claude Code keychain credentials in-place during refresh sync; share JSON file helpers; add CLI fallback coverage.
• Auth: throttle external CLI credential syncs (Claude/Codex), reduce Keychain reads, and skip sync when cached credentials are still fresh.
• CLI: respect CLAWDBOT_STATE_DIR for node pairing + voice wake settings storage. (#664) — thanks @azade-c.
• Onboarding/Gateway: persist non-interactive gateway token auth in config; add WS wizard + gateway tool-calling regression coverage.
• Gateway/Control UI: make chat.send non-blocking, wire Stop to chat.abort, and treat /stop as an out-of-band abort. (#653)
• Gateway/Control UI: allow chat.abort without runId (abort active runs), suppress post-abort chat streaming, and prune stuck chat runs. (#653)
• Gateway/Control UI: sniff image attachments for chat.send, drop non-images, and log mismatches. (#670) — thanks @cristip73.
• macOS: force restart-mac.sh --sign to require identities and keep bundled Node signed for relay verification. (#580) — thanks @jeffersonwarrior.
• Gateway/Agent: accept image attachments on agent (multimodal message) and add live gateway image probe (CLAWDBOT_LIVE_GATEWAY_IMAGE_PROBE=1).
• CLI: clawdbot sessions now includes elev:* + usage:* flags in the table output.
• CLI/Pairing: accept positional provider for pairing list|approve (npm-run compatible); update docs/bot hints.
• Branding: normalize user-facing “ClawdBot”/“CLAWDBOT” → “Clawdbot” (CLI, status, docs).
• Auto-reply: fix native /model not updating the actual chat session (Telegram/Slack/Discord). (#646)
• Doctor: offer to run clawdbot update first on git installs (keeps doctor output aligned with latest).
• Doctor: avoid false legacy workspace warning when install dir is ~/clawdbot. (#660)
• iMessage: fix reasoning persistence across DMs; avoid partial/duplicate replies when reasoning is enabled. (#655) — thanks @antons.
• Models/Auth: allow MiniMax API configs without models.providers.minimax.apiKey (auth profiles / MINIMAX_API_KEY). (#656) — thanks @mneves75.
• Agents: avoid duplicate replies when the message tool sends. (#659) — thanks @mickahouan.
• Agents: harden Cloud Code Assist tool ID sanitization (toolUse/toolCall/toolResult) and scrub extra JSON Schema constraints. (#665) — thanks @sebslight.
• Agents: sanitize tool results + Cloud Code Assist tool IDs at context-build time (prevents mid-run strict-provider request rejects).
• Agents/Tools: resolve workspace-relative Read/Write/Edit paths; align bash default cwd. (#642) — thanks @mukhtharcm.
• Discord: include forwarded message snapshots in agent session context. (#667) — thanks @rubyrunsstuff.
• Telegram: add telegram.draftChunk to tune draft streaming chunking for streamMode: "block". (#667) — thanks @rubyrunsstuff.
• Tests/Agents: add regression coverage for workspace tool path resolution and bash cwd defaults.
• iOS/Android: enable stricter concurrency/lint checks; fix Swift 6 strict concurrency issues + Android lint errors (ExifInterface, obsolete SDK check). (#662) — thanks @KristijanJovanovski.
• iOS/macOS: share AsyncTimeout, require explicit bridgeStableID on connect, and harden tool display defaults (avoids missing-resource label fallbacks).
• Telegram: serialize media-group processing to avoid missed albums under load.
• Signal: handle dataMessage.reaction events (signal-cli SSE) to avoid broken attachment errors. (#637) — thanks @neist.
• Docs: showcase entries for ParentPay, R2 Upload, iOS TestFlight, and Oura Health. (#650) — thanks @henrino3.
• Agents: repair session transcripts by dropping duplicate tool results across the whole history (unblocks Anthropic-compatible APIs after retries).
• Tests/Live: reset the gateway session between model runs to avoid cross-provider transcript incompatibilities (notably OpenAI Responses reasoning replay rules).

View full changelog