Agent Breaking Changes_

← OpenClaw

OpenClaw OpenClaw 2026.8.1-beta.4 (mistakenly published as 2026.9.1-beta.1)

pre

2026-08-28 · official notes

Summary

Full notes

## 2026.8.1-beta.4 (mistakenly published as 2026.9.1-beta.1)

> [!WARNING]
> This package was mistakenly published under the version `2026.9.1-beta.1`. It is actually `2026.8.1-beta.4` and should not be interpreted as newer than stable `2026.8.1`. Stable users should install or update to `2026.8.1`.

### Highlights

- **Gateway restart recovery:** preserve admitted turns across repeated Gateway restarts so restart-safe runs continue through each checkpoint and deliver their final response. (#130491) Thanks @jalehman.
- **Gateway config-write reliability:** keep committed config writes pending through watcher handoff so same-write reloads settle against the observed generation instead of failing during source transfer. (#131515)
- **Codex managed runtime:** update the bundled Codex runtime to 0.150.1 across Linux, macOS, and Windows while retaining platform-specific package resolution and current compaction behavior. (#130685) Thanks @vincentkoc.
- **Linux installation reliability:** provision the stable Node 24 LTS stream and constrain RPM installs to the configured NodeSource repository so Linux setup cannot select an incompatible prerelease. [PR 130369](https://github.com/openclaw/openclaw/pull/130369). Thanks @RomneyDa and @vincentkoc.
- **Worker recovery:** re-arm admission-deadline launches, terminalize dead-worker turns, and defer debris cleanup so interrupted delegated work settles visibly. (#130446)
- **Control UI file safety:** preserve confirmed agent-file saves during overlapping reads and refreshes while keeping newer drafts intact. (#130468)
- **Model browsing reliability:** keep model discovery available after automatic plugin activation instead of losing the selected provider catalog. (#130481)

### Changes

- **Audit decisions:** record generic tool-action decisions at their authoritative execution boundary for clearer operator diagnostics. (#130358) Thanks @joshavant.
- **Codex app-server compatibility:** carry Codex 0.150.1 collaboration, status, and activity protocol additions through the managed bridge without weakening exact platform package checks. (#130685) Thanks @vincentkoc.
- **Control UI appearance:** save appearance preferences per user profile so shared browsers no longer collapse everyone onto one visual setup. (#130340)
- **Model selection scopes:** add configurable model-selection scopes while preserving the canonical provider and runtime policy path. (#127813) Thanks @Marvinthebored and @Peetiegonzalez.

### Fixes

- **Gateway restart recovery:** retain admitted restart-safe runs across cleanup and repeated restarts, preserving checkpoints and final delivery. (#130491) Thanks @jalehman.
- **Gateway config watcher handoff:** preserve pending config writes until the watcher observes the committed generation, preventing `config.patch` from failing during same-write source handoff. Fixes #131405. (#131515)
- **Linux installer runtime selection:** use stable Node 24 LTS provisioning and scope RPM installs to NodeSource so fresh Linux installs cannot select an incompatible prerelease. [PR 130369](https://github.com/openclaw/openclaw/pull/130369). Thanks @RomneyDa.
- **Worker admission recovery:** re-arm eligible launches after admission deadlines and terminalize dead-worker turns instead of leaving delegated work unresolved. (#130446)
- **Control UI agent files:** keep confirmed saves and file metadata intact when older reads or list refreshes finish later. (#130468)
- **Model catalog activation:** preserve model browsing after automatic provider-plugin activation. (#130481)

### Complete contribution record

This audited record covers the complete 662bd4edddc2168b4071420bccf3fb89f6ac4c62..6e9fefd1aa42fc4af0d7c0b4056fabf3e10d48e8 history: 2 in-range PRs + 1,518 retained seed-only PRs = 1,520 unique PRs. The generation manifest also supplies direct commits as editorial input; the grouped notes above prioritize user impact.

Shipped baseline exclusions: v2026.8.1-beta.2 (0 PRs).

#### Pull requests

- **PR #130685** Thanks @vincentkoc.
- **PR #131515** Related #131405.
- **PR #130491** Related #130485. Thanks @jalehman.
- **PR #130446**
- **PR #130468**
- **PR #130481**
- **PR #130358** Thanks @joshavant.
- **PR #130340**
- **PR #127813** Thanks @Marvinthebored and @Peetiegonzalez.
- **PR #128225** Related #128199. Thanks @vyctorbrzezowski.
- **PR #128248** Thanks @ampagent.
- **PR #127874** Thanks @edenfunf.
- **PR #128235** Thanks @vincentkoc.
- **PR #128234** Thanks @vincentkoc.
- **PR #117480** Thanks @zenglingbiao.
- **PR #118505** Thanks @zhilong1115 and @vincentkoc.
- **PR #128166** Related #121770. Thanks @vyctorbrzezowski and @lucascmg-vx.
- **PR #128178** Related #89528. Thanks @gaoanze888 and @songshikang0111.
- **PR #128125**
- **PR #127315** Related #127314. Thanks @hannesrudolph.
- **PR #128230** Related #128229. Thanks @vyctorbrzezowski.
- **PR #127236** Thanks @Yigtwxx.
- **PR #126352** Thanks @Yigtwxx.
- **PR #115984** Thanks @yanmo42.
- **PR #128206**
- **PR #128264** Thanks @ampagent.
- **PR #127842** Thanks @vyctorbrzezowski.
- **PR #128263**
- **PR #128268**
- **PR #117890** Thanks @zenglingbiao and @vincentkoc.
- **PR #128269**
- **PR #128260**
- **PR #127998** Related #127858. Thanks @MonkeyLeeT and @PollyBot13.
- **PR #128258**
- **PR #128243**
- **PR #127841** Thanks @vyctorbrzezowski.
- **PR #128272**
- **PR #119204** Thanks @wanyongstar.
- **PR #128277**
- **PR #128281**
- **PR #128224**
- **PR #128273** Related #128194.
- **PR #128274**
- **PR #128284**
- **PR #128154** Thanks @vyctorbrzezowski.
- **PR #128256**
- **PR #128295**
- **PR #128291**
- **PR #128283**
- **PR #120056** Related #116731. Thanks @NarahariRaghava and @warren2008-2020-spec.
- **PR #128292**
- **PR #128294** Thanks @ampagent.
- **PR #126893** Related #126888. Thanks @vyctorbrzezowski.
- **PR #128280**
- **PR #128298** Thanks @vyctorbrzezowski.
- **PR #128265**
- **PR #128287** Thanks @ampagent.
- **PR #128293**
- **PR #128308** Thanks @ampagent.
- **PR #128297**
- **PR #128307**
- **PR #117222** Thanks @funston-bot and @barnett.
- **PR #128315**
- **PR #128317**
- **PR #128329** Thanks @ampagent.
- **PR #128313**
- **PR #128323**
- **PR #125210** Thanks @SunnyShu0925 and @altaywtf.
- **PR #128331** Thanks @ampagent.
- **PR #128322**
- **PR #128337**
- **PR #120280** Thanks @zenglingbiao.
- **PR #128338**
- **PR #128112** Related #128086. Thanks @chelsealong and @bek91 and @hvhoon.
- **PR #128341**
- **PR #128344** Thanks @ampagent.
- **PR #128288**
- **PR #128349**
- **PR #128343**
- **PR #128334**
- **PR #128335** Thanks @Yigtwxx.
- **PR #114209** Related #114208. Thanks @kevin2966n and @vincentkoc.
- **PR #128353**
- **PR #128339**
- **PR #113980** Related #111854. Thanks @Linux2010 and @vincentkoc and @intagold561.
- **PR #125256** Related #125255. Thanks @zyw02.
- **PR #128355**
- **PR #128310** Thanks @Yigtwxx.
- **PR #128359** Thanks @ampagent.
- **PR #128352**
- **PR #113554** Thanks @zeroaltitude.
- **PR #128346**
- **PR #128316**
- **PR #128358**
- **PR #110703** Thanks @zhangguiping-xydt.
- **PR #127289** Thanks @RomneyDa and @vincentkoc.
- **PR #127281** Thanks @RomneyDa and @vincentkoc.
- **PR #128034** Thanks @vincentkoc.
- **PR #128364**
- **PR #127285** Thanks @RomneyDa.
- **PR #128372**
- **PR #94806** Related #94626. Thanks @samson1357924.
- **PR #128378**
- **PR #127682**
- **PR #128377** Thanks @ampagent.
- **PR #128088**
- **PR #128381**
- **PR #128365** Related #128232. Thanks @vyctorbrzezowski.
- **PR #126589**
- **PR #128392** Thanks @ampagent.
- **PR #128391** Thanks @vincentkoc.
- **PR #128137** Thanks @vincentkoc.
- **PR #128188** Thanks @vincentkoc.
- **PR #128231** Thanks @vincentkoc.
- **PR #125357** Related #125356. Thanks @rishitamrakar.
- **PR #128396** Thanks @vincentkoc.
- **PR #120097** Thanks @ayaangazali.
- **PR #123442** Thanks @sunlit-deng.
- **PR #111581** Thanks @coaiMax.
- **PR #128373**
- **PR #128399**
- **PR #128398**
- **PR #128278** Related #128276. Thanks @MITRAKER.
- **PR #128375** Thanks @vincentkoc and @xialonglee.
- **PR #128394**
- **PR #128404**
- **PR #128369**
- **PR #100296** Related #100287.
- **PR #128408** Thanks @ampagent.
- **PR #119964** Related #119796. Thanks @Yigtwxx and @wangmiao0668000666.
- **PR #128363**
- **PR #110736** Thanks @mikasa0818.
- **PR #109424** Thanks @wahaha1223 and @vincentkoc.
- **PR #120331** Thanks @marmar9615-cloud.
- **PR #128415**
- **PR #128374**
- **PR #128423**
- **PR #110294** Thanks @chengzhichao-xydt.
- **PR #128422**
- **PR #128401**
- **PR #128419**
- **PR #128351** Thanks @zhangguiping-xydt.
- **PR #126960** Related #126916. Thanks @ampagent and @vincentkoc.
- **PR #128382**
- **PR #109646** Thanks @lsr911.
- **PR #128436** Thanks @vincentkoc.
- **PR #128393**
- **PR #128448** Thanks @vincentkoc.
- **PR #128431** Thanks @ampagent.
- **PR #110641** Thanks @coder-master-0915 and @vincentkoc.
- **PR #109163** Thanks @TianT1209.
- **PR #128462** Thanks @ampagent.
- **PR #128357** Thanks @ampagent.
- **PR #128438**
- **PR #128434**
- **PR #128432**
- **PR #127699**
- **PR #128406** Related #127477. Thanks @TurboTheTurtle.
- **PR #128435**
- **PR #128471** Thanks @ampagent.
- **PR #128418**
- **PR #126085** Related #119065. Thanks @Schimuneck and @cursoragent and @sallyom.
- **PR #128421**
- **PR #128484** Related #128483.
- **PR #128476** Related #128424.
- **PR #123979** Thanks @jesse-merhi.
- **PR #128478** Thanks @obviyus.
- **PR #128403** Thanks @ayaangazali.
- **PR #128480**
- **PR #128486**
- **PR #118161** Thanks @ayaangazali.
- **PR #128491**
- **PR #128240** Thanks @Takhoffman.
- **PR #128440**
- **PR #128489**
- **PR #128493** Thanks @bek91.
- **PR #128420**
- **PR #128360** Related #128330. Thanks @chelsealong and @alexph-dev.
- **PR #128497** Thanks @vincentkoc.
- **PR #128496**
- **PR #128279**
- **PR #128494** Thanks @obviyus.
- **PR #128510**
- **PR #128501**
- **PR #128463** Thanks @vincentkoc.
- **PR #128517** Related #128516.
- **PR #128487** Thanks @ampagent.
- **PR #128523**
- **PR #128513**
- **PR #128518**
- **PR #128522** Thanks @vincentkoc.
- **PR #128397**
- **PR #128519**
- **PR #128174** Related #127483. Thanks @zhangguiping-xydt.
- **PR #128426**
- **PR #128266** Related #127587. Thanks @Parker-Fawcett.
- **PR #108060** Related #107202. Thanks @zhangyan2026 and @compoodment.
- **PR #128495** Thanks @Leon-SK668.
- **PR #128197** Thanks @obviyus.
- **PR #128507** Thanks @vincentkoc.
- **PR #128551**
- **PR #128541**
- **PR #128502** Related #127410. Thanks @Alix-007.
- **PR #121183** Related #121168. Thanks @Leon-SK668.
- **PR #128542**
- **PR #128554**
- **PR #128545** Related #128544.
- **PR #128560**
- **PR #128553** Related #128445.
- **PR #128562**
- **PR #128526**
- **PR #128558**
- **PR #128547** Related #62529. Thanks @MadanChaollaPark.
- **PR #124405** Related #124345. Thanks @synthalorian and @eggc-tech.
- **PR #117422**
- **PR #128570**
- **PR #128573**
- **PR #124171** Thanks @masatohoshino.
- **PR #128503**
- **PR #128565**
- **PR #123193** Thanks @SunnyShu0925 and @obviyus.
- **PR #120216** Thanks @zenglingbiao.
- **PR #128575**
- **PR #128576**
- **PR #128506** Thanks @jesse-merhi.
- **PR #119320** Thanks @ayaangazali.
- **PR #128557**
- **PR #128577**
- **PR #128561** Thanks @xialonglee.
- **PR #128447**
- **PR #128451**
- **PR #119864** Related #119854. Thanks @hidenori-endo.
- **PR #128589**
- **PR #128563**
- **PR #128574** Thanks @wangmiao0668000666.
- **PR #120597** Related #120549. Thanks @LiuwqGit and @gucasbrg.
- **PR #119537** Thanks @Alix-007.
- **PR #128582**
- **PR #128581** Related #43292. Thanks @rkcollins.
- **PR #125527** Thanks @Kaneki-x.
- **PR #128590** Related #128587.
- **PR #127338** Related #127272. Thanks @HermanZeng and @lopezdp.
- **PR #128566** Related #128564.
- **PR #128474**
- **PR #124551** Related #124550. Thanks @zyw02.
- **PR #128588** Related #128585.
- **PR #128579** Thanks @vincentkoc.
- **PR #124657** Related #124647. Thanks @MaheshBhushan and @jennyskogbrynet-spec.
- **PR #128591** Related #127588.
- **PR #128571**
- **PR #128584**
- **PR #127976** Related #127974. Thanks @wangmiao0668000666.
- **PR #128568**
- **PR #124021** Thanks @clawSean.
- **PR #128603**
- **PR #99505** Thanks @xdemocle and @vincentkoc.
- **PR #117318**
- **PR #128586**
- **PR #128548**
- **PR #128144**
- **PR #128600**
- **PR #128572** Thanks @vincentkoc.
- **PR #128611**
- **PR #128605** Thanks @vincentkoc and @RomneyDa.
- **PR #126976** Thanks @zeroaltitude.
- **PR #126518** Related #126517. Thanks @ChrisCantwell.
- **PR #128439** Related #128005. Thanks @corvid-reads.
- **PR #128621** Thanks @obviyus.
- **PR #128610**
- **PR #126497** Related #126337, #127238. Thanks @zhangguiping-xydt and @yakattack77 and @isaias210.
- **PR #128552** Related #128549.
- **PR #120282** Thanks @zenglingbiao.
- **PR #128464**
- **PR #128613**
- **PR #128595**
- **PR #128131**
- **PR #128614**
- **PR #120240** Thanks @sunlit-deng.
- **PR #128612** Related #122352. Thanks @licheer-zte and @Alix-007.
- **PR #128578** Thanks @Leon-SK668.
- **PR #128641** Related #128640.
- **PR #128639**
- **PR #69479** Related #69042. Thanks @gumadeiras and @chadensteiN.
- **PR #78456** Thanks @sliverp.
- **PR #128622**
- **PR #128597** Related #128596.
- **PR #128632** Related #128583.
- **PR #128601** Related #126996. Thanks @Alix-007.
- **PR #126487** Thanks @yetval and @obviyus.
- **PR #128599**
- **PR #128604** Related #128602.
- **PR #128645** Thanks @obviyus.
- **PR #128638**
- **PR #128414**
- **PR #128459** Thanks @vincentkoc.
- **PR #128636** Related #128623. Thanks @vyctorbrzezowski.
- **PR #128538** Related #128492. Thanks @vyctorbrzezowski.
- **PR #128649**
- **PR #128228** Thanks @8exgh.
- **PR #128671** Thanks @vincentkoc.
- **PR #128514**
- **PR #128656**
- **PR #128670** Related #128662.
- **PR #128607**
- **PR #128546**
- **PR #128652**
- **PR #128458** Thanks @vincentkoc.
- **PR #128704**
- **PR #128705**
- **PR #128651**
- **PR #128678**
- **PR #128709**
- **PR #128703**
- **PR #128716** Related #120662. Thanks @fr-meyer.
- **PR #128713**
- **PR #128702**
- **PR #128721** Related #127283. Thanks @cantoblanco.
- **PR #128715**
- **PR #117285**
- **PR #128672**
- **PR #128710**
- **PR #128727**
- **PR #128717**
- **PR #127991** Related #126694. Thanks @Finn763 and @phehellonthoana-dev.
- **PR #128724** Related #127482.
- **PR #128723**
- **PR #128540** Related #128539.
- **PR #128731**
- **PR #128722** Related #128707.
- **PR #128726** Thanks @obviyus.
- **PR #128733**
- **PR #128728**
- **PR #128734**
- **PR #128729** Related #81099. Thanks @obviyus and @cuuush.
- **PR #128092** Related #125059. Thanks @IWhatsskill.
- **PR #128661**
- **PR #128739** Thanks @Takhoffman.
- **PR #125550** Thanks @Kaneki-x.
- **PR #128635**
- **PR #125820** Thanks @jesse-merhi.
- **PR #128737**
- **PR #128745** Related #128744.
- **PR #120606** Related #120561. Thanks @RileyJJY and @reisball.
- **PR #128753**
- **PR #128758**
- **PR #128760**
- **PR #126908** Related #126902. Thanks @wangmiao0668000666.
- **PR #128262** Related #128261.
- **PR #128766**
- **PR #128770**
- **PR #128759**
- **PR #128775**
- **PR #128752**
- **PR #128774**
- **PR #128780** Related #128769.
- **PR #126939** Thanks @shakkernerd.
- **PR #128778** Related #114693. Thanks @scotthuang.
- **PR #126943** Thanks @shakkernerd.
- **PR #126947** Thanks @shakkernerd.
- **PR #128348** Related #128332. Thanks @VACInc.
- **PR #128761**
- **PR #128788**
- **PR #128807**
- **PR #128795** Thanks @vincentkoc.
- **PR #128771**
- **PR #128811** Thanks @obviyus.
- **PR #128810**
- **PR #128793** Thanks @obviyus.
- **PR #128798** Related #128794.
- **PR #128825** Related #128654.
- **PR #128735** Thanks @vincentkoc.
- **PR #128081** Related #128079. Thanks @Takhoffman.
- **PR #128767** Thanks @VACInc.
- **PR #128212**
- **PR #128833**
- **PR #128356** Thanks @VACInc.
- **PR #128699** Related #128697. Thanks @Vlad-Online and @vincentkoc.
- **PR #128839** Related #128837. Thanks @Takhoffman.
- **PR #124989** Thanks @qingminglong.
- **PR #128823**
- **PR #128841**
- **PR #128844**
- **PR #128765**
- **PR #128777**
- **PR #128846**
- **PR #128763**
- **PR #123015** Thanks @miorbnli.
- **PR #128852**
- **PR #128768**
- **PR #128849**
- **PR #128854** Thanks @vincentkoc.
- **PR #128861**
- **PR #128856**
- **PR #128853** Thanks @Takhoffman.
- **PR #128870** Related #128869.
- **PR #128873** Thanks @joshavant.
- **PR #128874** Thanks @vincentkoc.
- **PR #128864** Related #128850.
- **PR #128865**
- **PR #128876** Thanks @brokemac79.
- **PR #128884** Thanks @jalehman.
- **PR #128885** Thanks @bdjben.
- **PR #128894** Thanks @jalehman.
- **PR #128893**
- **PR #126811** Related #126810. Thanks @TheAngryPit and @jalehman.
- **PR #119295** Thanks @zhangguiping-xydt and @Patrick-Erichsen.
- **PR #128901**
- **PR #128460** Thanks @vincentkoc.
- **PR #128868**
- **PR #128902**
- **PR #128911** Related #128906. Thanks @Takhoffman.
- **PR #128914** Related #128908.
- **PR #128909**
- **PR #126082** Thanks @joshavant.
- **PR #128937**
- **PR #128944** Thanks @Takhoffman.
- **PR #128957** Related #128948.
- **PR #128958**
- **PR #128896** Related #128866. Thanks @VACInc and @hannesrudolph.
- **PR #128964**
- **PR #128951** Thanks @Takhoffman.
- **PR #128732** Related #128698. Thanks @SunnyShu0925 and @vincentkoc and @Vlad-Online.
- **PR #128915** Related #128890.
- **PR #128972** Thanks @Takhoffman.
- **PR #128370** Thanks @VACInc and @vincentkoc.
- **PR #128969** Thanks @Takhoffman.
- **PR #128941** Thanks @Takhoffman.
- **PR #128977** Related #128974.
- **PR #128981** Related #128979.
- **PR #128608** Thanks @Marvinthebored and @Peetiegonzalez and @obviyus.
- **PR #128985** Thanks @obviyus.
- **PR #128903** Thanks @joshavant.
- **PR #128867** Thanks @fuller-stack-dev.
- **PR #129003** Related #129002.
- **PR #128996** Related #128988.
- **PR #128986** Thanks @Takhoffman.
- **PR #129011**
- **PR #128975**
- **PR #128843** Related #128827. Thanks @VACInc and @obviyus.
- **PR #129020** Related #129013.
- **PR #129022** Related #129021.
- **PR #129016**
- **PR #129024**
- **PR #124694**
- **PR #129017** Related #129014.
- **PR #129012**
- **PR #128998** Thanks @vincentkoc.
- **PR #129026** Related #127484.
- **PR #127778** Thanks @joshavant.
- **PR #129027**
- **PR #128626** Related #119041. Thanks @Alix-007 and @lubao515.
- **PR #129033**
- **PR #129043** Related #129042.
- **PR #129031**
- **PR #128664** Thanks @Alix-007.
- **PR #129032**
- **PR #129028**
- **PR #129038** Related #128925. Thanks @aniruddhaadak80.
- **PR #129047**
- **PR #129007** Related #128987.
- **PR #129045**
- **PR #129019** Thanks @vyctorbrzezowski.
- **PR #129029**
- **PR #129055**
- **PR #129057**
- **PR #129039**
- **PR #128805** Thanks @vincentkoc.
- **PR #125388** Related #125147. Thanks @wakqasahmed and @mlaihk.
- **PR #129056** Related #129048.
- **PR #117414**
- **PR #129046**
- **PR #128499** Thanks @Leon-SK668.
- **PR #125370** Thanks @goffern.
- **PR #129050** Related #128537. Thanks @aniruddhaadak80.
- **PR #125599** Thanks @santhiprakash.
- **PR #114403**
- **PR #129069**
- **PR #109951** Thanks @zhanxingxin1998.
- **PR #129051**
- **PR #129053**
- **PR #129059**
- **PR #129066**
- **PR #128756**
- **PR #129062**
- **PR #127752**
- **PR #129074**
- **PR #128659** Thanks @Leon-SK668.
- **PR #129065**
- **PR #129070**
- **PR #129079**
- **PR #129081**
- **PR #129067**
- **PR #129089**
- **PR #129076**
- **PR #129064**
- **PR #129091**
- **PR #125338** Thanks @goffern.
- **PR #129082**
- **PR #129044**
- **PR #129077**
- **PR #129097** Related #127521.
- **PR #121103** Related #121046. Thanks @wangmiao0668000666 and @homeworld520.
- **PR #129000** Thanks @vincentkoc.
- **PR #129102**
- **PR #129085** Related #129014.
- **PR #129106** Related #129105.
- **PR #121941** Related #121919. Thanks @nissl24.
- **PR #129075** Thanks @vincentkoc.
- **PR #129101**
- **PR #129110**
- **PR #129087**
- **PR #129128** Thanks @ampagent.
- **PR #119392** Thanks @tzy-17 and @vinc
Weekly digest: every breaking change, retirement and price change across 20+ coding agents, one email.

Form not loading? Subscribe here.