GitHub Release: openclaw/openclaw v2026.8.2 (01.09.2026)

$ git clone https://github.com/openclaw/openclaw.git Clone

2026.8.2

Highlights

• Your Home agent, beside your work: open Home in a right or bottom dock with Cmd/Ctrl+Shift+H, keep your current page in view, and preview or remove its work-context snapshot or attach selected text to your message. Related )


• A desktop companion for Linux: install the .deb or AppImage on x86-64 Linux, connect to a local or remote Gateway, and open Quick Chat from the system tray or an X11 keyboard shortcut. AppImage updates are signature-verified; .deb installs remain under your package manager. See the . (.


• Safer upgrades: preserve newer configuration, stop incomplete session migrations before claiming success, and recover a stopped Gateway after a failed update when the installed package or rollback is verified safe. Related , , ) Thanks , , , and . () Thanks , . (, ) Thanks , , .


• Browser control without a running Gateway: let supported macOS and Linux Chrome extension builds wake their paired local relay for authenticated CDP clients; this needs the updated native host and an extension build with relay wake-up support. (, , , .

Changes

• 
  

  Recovery cleanup: preview retained migration originals with openclaw update cleanup --dry-run, then explicitly remove eligible originals while the selected Gateway is stopped; cleanup preserves current SQLite history but permanently gives up rollback to removed originals. Related )

  
  


• 
  

  Session visibility default: let unsandboxed sessions work with other sessions of the same agent by default, including retained cron sessions; shared-agent operators should set tools.sessions.visibility to tree or self when they need narrower access, while sandbox and cross-agent restrictions remain enforced. Related )

  
  


• 
  

  Cross-session conversations: render forwarded messages as distinct speech bubbles with source-session links and sending-agent identity, preserving attribution when messages steer an active conversation. ()

  
  


• 
  

  Session organization: group session actions into clearer menus, copy transcripts as Markdown, open sessions in tabs, windows, or splits, edit icons and colors together, and optionally hide empty session groups. Related . ()

  
  


• 
  

  Home without switching pages: dock the selected agent’s existing Home conversation beside your work, retain its draft and attachments when opening it full page, and inspect or remove the “Working on” context before sending. Related )

  
  


• 
  

  Prepared cloud projects: reuse prepared project snapshots and validated workspace hashes before starting a cloud session, and preserve the required stop, snapshot, and restart cycle for Daytona-backed projects. Related . (, . ()

  
  


• 
  

  Chrome relay wake-up: support standalone local relays that start on demand, share their paired browser with the Gateway, and remain available to other CDP clients when the Gateway disconnects; see the )

  
  


• 
  

  Plugin SDK types: type Telegram botToken as SecretInput (string | SecretRef), matching existing secret-reference support; plugin authors should use the resolved account token and read finalization-context messages only when source === "openclaw-transcript". ()

  
  


• 
  

  Background sessions: start work from New Session without leaving the page with Cmd/Ctrl+Enter, retain the selected local, cloud, or paired-device placement, and open the session from its completion notice; use Cmd/Ctrl+Shift+Enter when Modifier+Enter is already your normal send shortcut, while explicit Draft visibility still creates a draft. Related ) Thanks ) Thanks ) Thanks , , , .



• Private diagnostics: redact values explicitly marked private in macOS app logs, keep credential values and prefixes out of routine Clawdock diagnostics, and preserve safe redaction of long secrets. Related . (, . (, .


• Source-file fidelity: preserve UTF-8 BOMs, line endings, fuzzy-match context bytes, and end-of-file state when applying patches, including formatting-only edits. Related . () Thanks , and , , , , , .


• Safe session recovery: preserve independently created files and symlinks during archive restore, repair supported legacy v17 agent databases, and fail updates clearly when session migration still blocks startup. Related . (, , , and . ( and . ( and . ( and , , , .


• Failed-update recovery: restart the managed Gateway through the selected installed CLI after a failed update when the replacement or restored installation is verified usable; retain backups and leave the Gateway stopped when rollback or package readiness remains uncertain. Related ) Thanks , .


• Scheduled jobs: preserve and recover valid migrated cron jobs, avoid needless schedule-repair writes, and emit complete JSON when cron output is piped; heartbeat jobs now report the actual completed, skipped, or failed outcome after the heartbeat settles. Related , , , , , .


• Approval migration: import historical execution approvals and usage metadata, and identify malformed legacy fields without exposing their values so operators can repair the preserved source. Related , and , . (, ) Thanks , , , and . () Thanks , , .


• Bun Gateway compatibility: restore authenticated Gateway connections under Bun 1.4 while preserving payload limits and request scheduling. ()


• Installer and container access: repair npm-prefix shell initialization, surface failed install finalization, and restore in-container CLI access when Docker uses a custom host port. Related , , . (, , , , and ) Thanks , , and , , , and . (, )


• Human priority and cancellation: prioritize human messages over inter-session work, stop queued Swarm collectors with their parent, and persist blocked completion alerts atomically. Related , , ) Thanks , , .


• Conversation context: reject summaries that revive superseded tasks, stop repeated byte-triggered compaction, retain policy ownership, and carry saved conversation summaries into a fresh Codex thread when switching runtimes. Related , , , , , , , .


• Draft and queue recovery: preserve offline drafts and restored draft text, resume draining after canceling a queued edit, and let you discard unconfirmed messages that block the queue. Related . (, .


• Starting chats: preserve typing on the new-session page, prevent duplicate initial prompts during workspace preparation, and avoid duplicate queued messages across clients. Related . (, .


• Workspace continuity: keep non-Git workspaces usable, preserve the selected worktree base branch through reconnects, and reload projects after startup identity is resolved. (, . (, and , , ) Thanks , and , , , ) Thanks , , and , . (, , , , , , .


• Microphone and transcription: explain pending microphone permission, avoid expiring a voice session while permission is pending, report transcription failures, and honor the selected transcription model. Related , , , .


• Voice settings and calls: retain canonical voice selections, discover configured providers, prevent late callbacks from creating phantom calls or obsolete replies, and preserve call capacity after storage failures. Related . (, , , , and , , , ) Thanks , , , .


• iMessage and Telegram: keep iMessage replies in the current conversation and preserve Telegram’s rich button labels when building reply context. Related , and . ( and . (, ) Thanks , and , , ) Thanks , , , .


• Text fidelity: preserve Unicode when truncating email and runtime text, retain HTML paragraph boundaries, and avoid leaking code-span placeholders into outbound messages; preserve trailing whitespace inside inline code and keep astral Unicode letters separated when stripping model control tokens. Related . (, , ) Thanks , , and . ( and . (, ) Stop also cancels pending worker provisioning and project preparation while allowing owned cleanup to finish. (, , , , , ) Thanks . (, , , , , .


• Model browsing and search: recover model browsing after catalog replacement and distinguish missing answers from malformed Google and xAI responses. Related . (, , , .


• Usage accuracy: keep output-token counts cumulative and recoverable, restore native-session usage after /new, refresh native pricing without pinning defaults, and correct cached long-context costs; refresh Cerebras and Chutes estimates from provider pricing while preserving explicit user rates, and keep usage pricing on static model metadata. Related , , , . ()


• Long-history performance: avoid excessive context copies, release transcript backing storage after eviction, reuse prepared batch writers, and reduce repeated Control UI history processing while preserving full-fidelity fork evidence. Related , . (, , , , and . (, , and , , ) Thanks .


• Beam transcript fidelity: preserve uploader identity, restart delivery when the receiver changes, and omit mixed Claude tool content without losing snapshot state. (, , ) Thanks .


• CLI output and tools: keep Unicode session and task tables aligned, fail session tailing on follow-read errors, preserve escaped Code Mode output prefixes, and retain readable grep context and literal @-prefixed paths. Related , , , , .


• Skills and memory wiki: recover colon-rich skill frontmatter, allow disposal of malformed proposals, and reject unsupported wiki operations and self-imported source pages; discover skill roots created after Gateway startup so newly added skills can refresh normally. Related . (, , , , , .


• Settings and configuration: preserve concurrent first saves, retain owners across legacy agent imports and store changes, preserve QQBot multi-account settings, and honor per-agent tool-progress detail overrides. Related , , , , , , , and , . (, , , .


• macOS ChatGPT login: finish onboarding after a same-route Gateway reconnect by resubmitting a callback only when it was never dispatched, preserving the existing login session. Related ) Thanks .


• Gateway setup and repair: require actual Gateway protocol readiness before declaring setup complete, preserve the operator’s home during sudo service installation, and allow stopping a Gateway even when its state schema is newer. Related , , , , .


• Diagnostics stay on target: keep embedded triage on the installation being diagnosed, and let TLS status and connection checks read certificates without creating or repairing certificate files. Related , , .


• Doctor maintenance: coordinate state repair with the matching managed Gateway, preserve its installed service definition, and verify it after any restart; use openclaw gateway install --force when you explicitly want to replace the managed launcher. Related )


• Gateway restart after repair: release Doctor’s database handles before restarting, so completed session migrations no longer leave the Gateway blocked by Doctor’s own database leases. ()


• Clearer repair outcomes: report when configuration errors block state repair, fail unhealthy plugin Doctor checks, preserve newly written stability bundles, and stop warning about canonical database links and nested Git workspaces. Related , , , , ) Thanks , , .


• Auth archive recovery: show completed or failed interrupted recovery even when Doctor returns early or another migration is declined, preserving failed source data. Related . ( and , . (, , , , .


• Automatic update policy: keep the saved update channel authoritative after a one-off package tag, cancel discovery when checks are disabled, record failed automatic updates, and preserve recovery actions across dashboard reloads; unattended installation requires a managed Gateway service. (. () Thanks .


• Runtime capability review: show the runtime plugin source and capabilities before model activation, keep installation and the live model check in the same setup flow, and let declining or canceling end that attempt without silently choosing another connection. (.


• Cloud result recovery: retain worker results before retiring stale owners, recover cloud sessions across Gateway restarts and cancellation, and scope recovery to the requested environment. Related , ) Thanks .


• Retained conversation inputs: keep retained inputs in transcript order and prevent retired prompts from reappearing after history refresh or remount. () Thanks . () Thanks .


• macOS installation and sign-in: relaunch the verified app after installation and let stalled provider sign-in exit without late authentication replies reopening a retired flow. Related . () Thanks .


• Linux and npm installation: preserve Fedora and other RPM-owned Node packages when OpenClaw needs a separate SQLite-safe runtime, restore npm conflict recovery and failure diagnostics, and keep installer dry runs from downloading the terminal UI helper. Related . (, , , .


• IPv6 Gateway access: keep canvas, boards, and other plugin-hosted surfaces reachable when the Gateway uses bracketed IPv6 hosts, including forwarded host headers. (.


• Browser relay admission: limit pending relay authentication and replay records per client source so one source cannot consume the shared capacity. (.


• Credential reloads and inspection: stop SMS webhook, media, and Twilio work when its account credentials become unavailable or are superseded, and keep inactive channel credentials out of inspection. Related , .


• LINE conversations: list configured peers and groups, keep typing indicators working for Gateway-driven replies, and avoid answering standby events while another channel owns the conversation. Related , , ) Thanks ) Thanks , and )


• Hermes migration: preserve the selected agent’s model, supported provider metadata, MCP tool restrictions, active organization skills, and disabled skill settings; partial apply failures return a complete JSON report with a nonzero exit. () Thanks , , .


• Failure diagnostics: retain the real reason in JSON log errors, preserve useful stdout alongside stderr on command failure, and report quiet npm timeouts or termination instead of blank errors. Related , , ) Thanks .


• Status and restart diagnostics: honor usage and agent-scope options in full status reports, identify active work delaying a restart, and report declared configuration accurately in triage. Related , ) Thanks . (, and . ( and ) Thanks , ) Thanks .


• Session and shutdown ownership: retain the selected agent through global native-session operations, keep sends on the selected channel plugin, stop new outbound retry admission during shutdown, and reject language-server tools after their bundle is disposed. Related . (, ) Thanks .

Known issues

• Optional memory plugin dependency: standalone @openclaw/memory-lancedb installs can still resolve an older vulnerable Sharp version through an optional Transformers dependency. The plugin’s reviewed text-embedding and vector-storage path does not load that image adapter; this dependency exposure remains a packaging follow-up.


• Hindi and Korean token labels: the native app’s token-usage label reverses the wording for used and total tokens; the counts and calculations are unchanged.

Upcoming deprecations

These already-deprecated Plugin SDK import paths remain available in 2026.8.2. Their recorded removal target is 2026-09-01; plugin authors should prepare the following migrations using the .

Release verification

• npm package: (availability pending npm processing)


• Uploaded prepared tarball integrity: sha512-I9aqK1attaONePpWs2gPqh23s1s1EDcN/6icF2AAfONdtowu4156QD7g6oD7KlA2vQ9yiqnvlAVH6yduvGH9Ig==; public registry readback pending.


• npm upload accepted at 2026-09-01T15:54:25Z; public publication time awaits registry readback.


• Signed release tag:


• Exact-release npm preflight: — succeeded; signed provenance published at manually uploaded from the verified preflight tarball at 2026-09-01T15:52:09.217Z; registry integrity matches the sealed artifact. This authenticated manual upload has no GitHub OIDC attestation. latest is 2026.8.2; the newer 2026.9.1-beta.1 beta tag is preserved.


• Matrix tarball SHA-256: d295140a6869fe7fae60abf019a6f80f20d61210202e8e36dea6cf3d346c8754.


• Dependency evidence: openclaw-2026.8.2-dependency-evidence.zip, containing the original exact-release preflight reports. Attached and SHA-256 verified: 7d0bb1f0a3ba8d75f404f9daa29bec6aa65549a2e7de574da26090ad1d841037.


• Windows promotion: — completed; published bytes match the build artifact, both package checksums pass, and the AppImage Minisign signature is verified.


• Android release: ; no completed publication claimed.