Agent Breaking Changes_

← OpenClaw

OpenClaw openclaw 2026.9.4

2026-09-11 · official notes

Summary

• <!-- openclaw-release-publication:docs-v1 -->
• OpenClaw v2026.9.4
• direct commits · 1,558 pull requests · 294 contributors

Full notes

<!-- openclaw-release-publication:docs-v1 -->

## OpenClaw v2026.9.4

20 direct commits · 1,558 pull requests · 294 contributors

### Changes included in this release

The release notes and changelog contain the same content, presented in two formats:

- [Release notes](https://docs.openclaw.ai/releases/2026.9.4) — formatted for people, with expandable sections.
- [Changelog](https://raw.githubusercontent.com/openclaw/openclaw/main/CHANGELOG/2026.9.4.md) — plain Markdown for AI agents and tools.

### Thanks

[@0xcyda](https://github.com/0xcyda) [@100yenadmin](https://github.com/100yenadmin) [@1vision365-petertijsma](https://github.com/1vision365-petertijsma) [@609nft](https://github.com/609nft) [@84dnnvbdvp-debug](https://github.com/84dnnvbdvp-debug) [@aaajiao](https://github.com/aaajiao) [@aatreya](https://github.com/aatreya) [@abacha](https://github.com/abacha) [@adinballew](https://github.com/adinballew) [@aeoess](https://github.com/aeoess) [@aevgeniou](https://github.com/aevgeniou) [@ai-hpc](https://github.com/ai-hpc) [@aimansour](https://github.com/aimansour) [@akagifreeez](https://github.com/akagifreeez) [@aleps001](https://github.com/aleps001) [@alexjpanagis](https://github.com/alexjpanagis) [@alexph-dev](https://github.com/alexph-dev) [@alix-007](https://github.com/alix-007) [@aminekhettat](https://github.com/aminekhettat) [@andrea-kingautomation](https://github.com/andrea-kingautomation) [@anguslogan01](https://github.com/anguslogan01) [@aniruddhaadak80](https://github.com/aniruddhaadak80) [@ansxor](https://github.com/ansxor) [@anyech](https://github.com/anyech) [@arcabotai](https://github.com/arcabotai) [@artemeey](https://github.com/artemeey) [@ashawwal](https://github.com/ashawwal) [@aspalagin](https://github.com/aspalagin) [@avcarp](https://github.com/avcarp) [@avp717](https://github.com/avp717) [@ayaangazali](https://github.com/ayaangazali) [@azuretek](https://github.com/azuretek) [@barbarhan](https://github.com/barbarhan) [@baumus](https://github.com/baumus) [@benjaml4](https://github.com/benjaml4) [@bottanicals](https://github.com/bottanicals) [@brainatworkharris](https://github.com/brainatworkharris) [@bricelb](https://github.com/bricelb) [@bsniznd](https://github.com/bsniznd) [@c0ncatenate](https://github.com/c0ncatenate) [@cai-ops](https://github.com/cai-ops) [@ccaprani](https://github.com/ccaprani) [@ceckert](https://github.com/ceckert) [@chegherian](https://github.com/chegherian) [@chelsealong](https://github.com/chelsealong) [@chl-0537](https://github.com/chl-0537) [@chriscantwell](https://github.com/chriscantwell) [@chrislro](https://github.com/chrislro) [@cjn119-ui](https://github.com/cjn119-ui) [@ck-xyz](https://github.com/ck-xyz) [@cobblestone-digital1](https://github.com/cobblestone-digital1) [@colton-harris](https://github.com/colton-harris) [@conan-scott](https://github.com/conan-scott) [@cp1369](https://github.com/cp1369) [@crash2kx](https://github.com/crash2kx) [@dasx](https://github.com/dasx) [@dbarbatti](https://github.com/dbarbatti) [@developercrocodiles](https://github.com/developercrocodiles) [@devin-linux](https://github.com/devin-linux) [@dh-js](https://github.com/dh-js) [@dilapidateddolphin98](https://github.com/dilapidateddolphin98) [@dillona](https://github.com/dillona) [@dimonnld](https://github.com/dimonnld) [@donniefi](https://github.com/donniefi) [@dreamer-hit](https://github.com/dreamer-hit) [@drobison00](https://github.com/drobison00) [@dw1161](https://github.com/dw1161) [@ejc3](https://github.com/ejc3) [@ekinnee](https://github.com/ekinnee) [@elbourne12345](https://github.com/elbourne12345) [@eleqtrizit](https://github.com/eleqtrizit) [@elikampf](https://github.com/elikampf) [@elvisio7](https://github.com/elvisio7) [@enominera](https://github.com/enominera) [@ericcaiwx-star](https://github.com/ericcaiwx-star) [@fabiolr](https://github.com/fabiolr) [@fahrenhe1t](https://github.com/fahrenhe1t) [@fanyangcs](https://github.com/fanyangcs) [@fanyuantaier](https://github.com/fanyuantaier) [@fede-kamel](https://github.com/fede-kamel) [@finn763](https://github.com/finn763) [@flagshipclaw](https://github.com/flagshipclaw) [@fulgerulnegru](https://github.com/fulgerulnegru) [@fuller-stack-dev](https://github.com/fuller-stack-dev) [@galiniliev](https://github.com/galiniliev) [@gdxbsv](https://github.com/gdxbsv) [@geekforlife](https://github.com/geekforlife) [@githoubi](https://github.com/githoubi) [@glenn-agent](https://github.com/glenn-agent) [@glucksberg](https://github.com/glucksberg) [@goutamadwant](https://github.com/goutamadwant) [@gozu](https://github.com/gozu) [@grynn](https://github.com/grynn) [@guarismo](https://github.com/guarismo) [@guojiongming](https://github.com/guojiongming) [@gwiltschek](https://github.com/gwiltschek) [@hannesrudolph](https://github.com/hannesrudolph) [@happyfaptain](https://github.com/happyfaptain) [@harjothkhara](https://github.com/harjothkhara) [@harshitgupta31415](https://github.com/harshitgupta31415) [@hawk5150](https://github.com/hawk5150) [@hayden-cc](https://github.com/hayden-cc) [@he-yufeng](https://github.com/he-yufeng) [@hekzory](https://github.com/hekzory) [@hermanzeng](https://github.com/hermanzeng) [@hugenshen](https://github.com/hugenshen) [@husodrn46](https://github.com/husodrn46) [@hxy91819](https://github.com/hxy91819) [@igs-rogenlo](https://github.com/igs-rogenlo) [@ikenraf](https://github.com/ikenraf) [@infocus13](https://github.com/infocus13) [@islandpreneur007](https://github.com/islandpreneur007) [@itanyplus](https://github.com/itanyplus) [@iwhatsskill](https://github.com/iwhatsskill) [@jackatagenticforce](https://github.com/jackatagenticforce) [@jackten](https://github.com/jackten) [@jai-assistant](https://github.com/jai-assistant) [@jailbirt](https://github.com/jailbirt) [@jalehman](https://github.com/jalehman) [@jarvismazz](https://github.com/jarvismazz) [@jason-allen-oneal](https://github.com/jason-allen-oneal) [@jerabinovich](https://github.com/jerabinovich) [@jesse-merhi](https://github.com/jesse-merhi) [@jialele](https://github.com/jialele) [@jinngimk-lang](https://github.com/jinngimk-lang) [@jjjhenriksen](https://github.com/jjjhenriksen) [@jkamgang](https://github.com/jkamgang) [@jlacroix82](https://github.com/jlacroix82) [@jlapenna](https://github.com/jlapenna) [@jmissig](https://github.com/jmissig) [@jodok](https://github.com/jodok) [@junfxiao](https://github.com/junfxiao) [@kashivreddy](https://github.com/kashivreddy) [@kaspnov](https://github.com/kaspnov) [@kesslerio](https://github.com/kesslerio) [@kiagentkronos-cell](https://github.com/kiagentkronos-cell) [@kimiyu-186](https://github.com/kimiyu-186) [@kingakrej](https://github.com/kingakrej) [@kingkong9817](https://github.com/kingkong9817) [@kirde](https://github.com/kirde) [@kopl-blip](https://github.com/kopl-blip) [@kvnloo](https://github.com/kvnloo) [@laisonamarante](https://github.com/laisonamarante) [@laurencebrown](https://github.com/laurencebrown) [@laurenceputra](https://github.com/laurenceputra) [@leapdragon](https://github.com/leapdragon) [@legupsystems](https://github.com/legupsystems) [@lei-happy](https://github.com/lei-happy) [@leilei3167](https://github.com/leilei3167) [@lendersmark](https://github.com/lendersmark) [@leon-sk668](https://github.com/leon-sk668) [@lightningwarellc](https://github.com/lightningwarellc) [@linhongyu510](https://github.com/linhongyu510) [@lisheguo](https://github.com/lisheguo) [@liuwqgit](https://github.com/liuwqgit) [@lizhengwu](https://github.com/lizhengwu) [@lonexreb](https://github.com/lonexreb) [@louisfy](https://github.com/louisfy) [@lraesly](https://github.com/lraesly) [@ly85206559](https://github.com/ly85206559) [@mag-linares-andalucia](https://github.com/mag-linares-andalucia) [@manumadrigal09](https://github.com/manumadrigal09) [@markthebest12](https://github.com/markthebest12) [@martins-oss](https://github.com/martins-oss) [@marvinthebored](https://github.com/marvinthebored) [@masatohoshino](https://github.com/masatohoshino) [@masterswords1](https://github.com/masterswords1) [@matthewmoroz](https://github.com/matthewmoroz) [@maxvidkrytaklishnya](https://github.com/maxvidkrytaklishnya) [@mgabor3141](https://github.com/mgabor3141) [@miguelbranco80](https://github.com/miguelbranco80) [@mikronn2](https://github.com/mikronn2) [@moerai](https://github.com/moerai) [@morrow-bluedot](https://github.com/morrow-bluedot) [@mrnozz](https://github.com/mrnozz) [@najef1979-code](https://github.com/najef1979-code) [@narbs](https://github.com/narbs) [@newsstand](https://github.com/newsstand) [@nianjiuzst](https://github.com/nianjiuzst) [@nissl24](https://github.com/nissl24) [@nkdmike](https://github.com/nkdmike) [@nocodet888-arch](https://github.com/nocodet888-arch) [@noelillinger](https://github.com/noelillinger) [@north-echo](https://github.com/north-echo) [@novaunboundai](https://github.com/novaunboundai) [@nullarbitrage](https://github.com/nullarbitrage) [@obviyus](https://github.com/obviyus) [@oliverbot26](https://github.com/oliverbot26) [@omarshahine](https://github.com/omarshahine) [@ooiuuii](https://github.com/ooiuuii) [@orangejon](https://github.com/orangejon) [@ouioui33](https://github.com/ouioui33) [@oywino](https://github.com/oywino) [@pash-openai](https://github.com/pash-openai) [@patrick-erichsen](https://github.com/patrick-erichsen) [@pbergeot](https://github.com/pbergeot) [@pcpilot-dev](https://github.com/pcpilot-dev) [@peetiegonzalez](https://github.com/peetiegonzalez) [@pengzh1](https://github.com/pengzh1) [@peterhodl](https://github.com/peterhodl) [@peterkaynie](https://github.com/peterkaynie) [@pfrederiksen](https://github.com/pfrederiksen) [@pgondhi987](https://github.com/pgondhi987) [@pick-cat](https://github.com/pick-cat) [@piotx](https://github.com/piotx) [@pollybot13](https://github.com/pollybot13) [@postoso](https://github.com/postoso) [@qingminglong](https://github.com/qingminglong) [@razvangirgiz](https://github.com/razvangirgiz) [@rboy1](https://github.com/rboy1) [@rgregg](https://github.com/rgregg) [@richard355168](https://github.com/richard355168) [@rico007](https://github.com/rico007) [@rileyjjy](https://github.com/rileyjjy) [@rjamoul](https://github.com/rjamoul) [@rlosito](https://github.com/rlosito) [@romneyda](https://github.com/romneyda) [@rondavis007](https://github.com/rondavis007) [@rqlangley](https://github.com/rqlangley) [@ruel225](https://github.com/ruel225) [@ruicatalao7](https://github.com/ruicatalao7) [@russellweiss](https://github.com/russellweiss) [@safzanpirani](https://github.com/safzanpirani) [@sallyom](https://github.com/sallyom) [@samrrr](https://github.com/samrrr) [@sappkevin](https://github.com/sappkevin) [@schjonhaug](https://github.com/schjonhaug) [@schwanncells](https://github.com/schwanncells) [@scotthuang](https://github.com/scotthuang) [@sedrak-hovhannisyan](https://github.com/sedrak-hovhannisyan) [@sercada](https://github.com/sercada) [@seven7763](https://github.com/seven7763) [@shakkernerd](https://github.com/shakkernerd) [@shaozhengkun123](https://github.com/shaozhengkun123) [@shojikumaru](https://github.com/shojikumaru) [@skaneta](https://github.com/skaneta) [@sloptop-the-terrible](https://github.com/sloptop-the-terrible) [@soroyue](https://github.com/soroyue) [@spectrl](https://github.com/spectrl) [@srikolagani](https://github.com/srikolagani) [@steipete](https://github.com/steipete) [@stephane-fci](https://github.com/stephane-fci) [@stevenlee-oai](https://github.com/stevenlee-oai) [@sunlit-deng](https://github.com/sunlit-deng) [@sunnyandtec-ak](https://github.com/sunnyandtec-ak) [@sunnyiren-max](https://github.com/sunnyiren-max) [@sunnyshu0925](https://github.com/sunnyshu0925) [@syfvb](https://github.com/syfvb) [@synthalorian](https://github.com/synthalorian) [@szqub](https://github.com/szqub) [@takhoffman](https://github.com/takhoffman) [@teddytennant](https://github.com/teddytennant) [@theangrypit](https://github.com/theangrypit) [@thecrazylex](https://github.com/thecrazylex) [@thien-ngn](https://github.com/thien-ngn) [@thomasmoenco](https://github.com/thomasmoenco) [@tilor](https://github.com/tilor) [@timetrvlr](https://github.com/timetrvlr) [@todddickerson](https://github.com/todddickerson) [@tomdailey55](https://github.com/tomdailey55) [@toneloke](https://github.com/toneloke) [@toraiwa](https://github.com/toraiwa) [@tskerpnext](https://github.com/tskerpnext) [@unknowbug](https://github.com/unknowbug) [@vacinc](https://github.com/vacinc) [@vincentkoc](https://github.com/vincentkoc) [@von8794](https://github.com/von8794) [@vyctorbrzezowski](https://github.com/vyctorbrzezowski) [@wangmiao0668000666](https://github.com/wangmiao0668000666) [@wenbiyou](https://github.com/wenbiyou) [@wolikimcheng](https://github.com/wolikimcheng) [@wpu911](https://github.com/wpu911) [@xialonglee](https://github.com/xialonglee) [@xiaoguomeiyitian](https://github.com/xiaoguomeiyitian) [@xueqingli1](https://github.com/xueqingli1) [@xuxyyy](https://github.com/xuxyyy) [@xx441](https://github.com/xx441) [@xydigitlybnnnn](https://github.com/xydigitlybnnnn) [@xydt-juyaohui](https://github.com/xydt-juyaohui) [@xydt-tanshanshan](https://github.com/xydt-tanshanshan) [@yangxiansheng](https://github.com/yangxiansheng) [@yanhe1169](https://github.com/yanhe1169) [@yetval](https://github.com/yetval) [@yigtwxx](https://github.com/yigtwxx) [@ylcn91](https://github.com/ylcn91) [@yncubys](https://github.com/yncubys) [@youens](https://github.com/youens) [@yxloveql](https://github.com/yxloveql) [@zachisfine](https://github.com/zachisfine) [@zenglingbiao](https://github.com/zenglingbiao) [@zhangguiping-xydt](https://github.com/zhangguiping-xydt) [@zhuyankarl](https://github.com/zhuyankarl) [@zwyhmcn](https://github.com/zwyhmcn) [@zyw02](https://github.com/zyw02)

### Release verification

- Signed source: `3a9d69db306cd7f081e06254cb89c4bcc14a7107`.
- [Full stable validation](https://github.com/openclaw/openclaw/actions/runs/34539227282): passed, attempt 2. Qualification also verified 15 performance measurements and 20 real OpenAI completions across 10 upgrade baselines.
- [Core npm publication](https://github.com/openclaw/openclaw/actions/runs/34554632555): passed; exact qualified bytes, registry signatures, provenance and fresh install verified.
- 90 npm plugins and 3 core companion packages: published at `latest`, exact bytes verified.
- [Docker publication](https://github.com/openclaw/openclaw/actions/runs/34555843439): passed; public GHCR and Docker Hub manifests and attestations match qualified artifacts.
- [Original publisher](https://github.com/openclaw/openclaw/actions/runs/34552806250): failed during npm propagation readback. GitHub finalized through manual recovery; no package republish.
- Telegram and Parallels checks: explicitly waived by the release owner, not passed.
- macOS DMG, ZIP, and debug symbols are public and byte-verified against the signed/notarized artifacts; the [stable update feed](https://github.com/openclaw/openclaw/pull/144636) is live and verified.
- Pending: ClawHub recovery, npm beta-selector synchronization, remaining native app distribution, and stable main closeout. Android native qualification failed. Windows historical-upgrade and Vercel mirror advisory failures remain recorded.
- The [repaired split-publication verifier](https://github.com/openclaw/openclaw/pull/144638) passed live npm/Docker verification. Full beta-selector verification and the immutable main-closeout record remain pending. The attached postpublish evidence preserves the earlier recovery snapshot; these follow-ups are not marked complete.
- Linux desktop AppImage and Debian package: published from `v2026.9.4` source `3a9d69db306cd7f081e06254cb89c4bcc14a7107`. [Build, packaged runtime smoke, and signing](https://github.com/openclaw/openclaw/actions/runs/34749148773) passed; GitHub asset upload was recovered using the exact successful CI artifacts. Public downloads match the [checksums](https://github.com/openclaw/openclaw/releases/download/v2026.9.4/SHA256SUMS.linux-app.txt), and the AppImage signature was independently verified. The [Linux updater manifest](https://github.com/openclaw/openclaw/releases/download/v2026.9.4/latest.json) is published, and the stable update endpoint was verified at 2026.9.4.