NanoClaw 2026.11.0 is the new stable release, so /update-nanoclaw on the default stable channel now offers it. 🦐 It covers everything since 2026.10.0 and was tested on the beta channel through nine pre-releases. Five changes you'll notice first:
- Each agent gets only the keys you give it. OneCLI moves to 1.45, where new agent groups get only their model key and other keys go to the groups you choose. OneCLI's database also gets its own password, which closes a critical security hole (see Security below). On OneCLI installs, both need a step from you. (#4094, #4439)
- Agents can create other agents from templates. Ask for one in chat, or pick one from
ncl templates listor the public library. (#4112) - Cursor is an agent provider. Run
/add-cursor, or pick Cursor in setup, and your agents run on Cursor's Agent SDK. (#4107) - Cards can show KPI fields, a table and charts. Agents put them in
send_cardcards, and Slack draws them natively. (#4292) - Newer models. Locally built agent images run Claude Code 2.1.321 with Claude Haiku 5.5 and know Claude Fable 5.2. Codex groups signed in with ChatGPT can use GPT-6.2 Astra and GPT-6.2 Sol. (#4332, #4446)
Eight changes need action from some installs, among them the OneCLI upgrade, the OneCLI database password, the webhook address and two new Google Chat settings, so check the section below before you update.
Thanks to everyone who ran the betas and told us what broke, and to the community contributors whose fixes are in this release: @shachartal, @carstenf, @topcoder1, @antonio-antuan, @witek, @refactornator, @patrick-hofmann, @musashinm, @NechuBM, @petrolette, @echarrod, @stefancgillberg, @bmultini and @OowhitecatoO.
⚠️ Before you update
- [BREAKING] Chat SDK channels move to adapter 4.41.1, which fixes Telegram messages with links that were never delivered. Affected: installs where
grep -o '"@chat-adapter/[a-z]*"' package.jsonprints anything (Telegram, Slack, Discord, Google Chat, Teams, WhatsApp Cloud, GitHub, Linear). Fix:/update-nanoclawrefreshes installed channels; after a manual merge, rerun/add-<channel>for each one. Google Chat: @mentions in spaces now needGOOGLE_CHAT_BOT_USER_ID=users/<id>in.env(DMs work without it; without it the log says "Google Chat botUserId is not configured" at startup): once the app has replied to you in a DM, list that DM's messages with the Chat API (spaces.messages.list), copy thesender.nameof a message whose sendertypeisBOT, and restart the service. Slack agent-to-agent rooms: a sibling bot now arrives asslack:bot:U…instead ofslack:bot:B…, so approve each sibling bot once more. Check: each channel answers a test message. Rollback:pnpm exec tsx scripts/update-nanoclaw.ts rollback --id <transaction-id>(rolling back).
Thanks to @shachartal. (#3570, #3993) - [BREAKING] Iron Proxy installs that connected Codex with ChatGPT before this release must sign in to Codex again. Detect, from the NanoClaw folder (works while the service is stopped):
f=data/session-materials/iron-control/codex.json; [ -f "$f" ] && grep -q '"mode":"chatgpt"' "$f" && ! grep -q '"accountId"' "$f" && echo affected. Once running, an affected install's Codex agents answer only with the failure notice ("Sorry, something went wrong and I couldn't answer") and the agent container log showsselected workspace missing from routing discovery. Why: Codex 0.156 and later check the login's workspace id, and older Iron logins never recorded it. Fix:pnpm exec tsx setup/index.ts --step provider-auth codex, then check that a Codex agent answers. OneCLI installs are affected only when the vault holds several ChatGPT logins or one without a recorded id; the host log then says "OneCLI login stand-in keeps its placeholder account id": delete the extra or stale login (onecli secrets list, thenonecli secrets delete --id <id>), run the same command, and grant the new secret to each agent that had the old one, asdocs/onecli-upgrades.mdin your install describes. Rollback: return to the previous release.
(#4133) - [BREAKING] Forks and hand-made templates: the template code moved and
templates/is now ignored by git. Affected: fork code that importscloneRegistry,listTemplatesFromDir,copyTemplateorDEFAULT_TEMPLATES_SOURCEfromsetup/templates.ts(it stops compiling), forks that edit theGROUP_SCOPE_RESOURCESline or the stamper'sensureContainerConfigline, forks that point setup at their own template library, and anyone who keeps a hand-made template intemplates/. Why: templates fetched by setup or by an agent are install state and must not block/update-nanoclaw, and setup now lists a library from itsindex.json. Fix: importcloneRegistryandlistTemplatesFromDirfromsrc/templates/library.tsandawait cloneRegistry();copyTemplateis gone, so callensureTemplateLocal; a fork that changedDEFAULT_TEMPLATES_SOURCEeditsLIBRARY_REPO(owner/repo) andLIBRARY_BRANCHinsrc/templates/library.tsinstead; re-anchor fork edits on the new lines; keep a new hand-made template in git withgit add -f templates/<ref>; give your own library anindex.jsonat its root in the same shape asnanocoai/nanoclaw-templates({ "schema": 1, "categories": { "<category>": [{ "ref": "<folder>", "name": "...", "description": "..." }] } }). Check:pnpm exec tsc --noEmitpasses and setup's library picker lists your templates (building templates). Rollback: revert this release; fetched templates then show as untracked ingit status, so delete them orgit addthe ones to keep.
(#4112) - [BREAKING] OneCLI installs: upgrade the gateway to 1.45.0 and the
onecliCLI to 2.11.0, where agents get only the keys you grant them. Detect: the gateway's/api/healthreports a version older than 1.45.0, orunknown(Iron Proxy installs skip this). Why: OneCLI 1.44 replaced secret modes with per-agent grants, and 1.45 is the last version that converts existing installs, so do not skip past it. Fix: before restarting, followdocs/onecli-upgrades.mdin your install (the same guide on GitHub); it backs up the gateway database, stops if the conversion would delete your rules, and covers the CLI binary. If you use/add-dial-tool, run the guide's Dial check before you pull; it deletes the Dial key only when the upgrade could hand it to agents you kept away from Dial (see the Dial item below). Existing groups keep what the conversion gives them; new groups get only their model credential, and on a 1.42 gateway new groups still get every key until you upgrade. To give a group a tool, re-run that tool's skill (for example/add-vercel) and pick the group; with/add-tavily-tool, re-run its Phase 5 so paid-key upgrades attach the key./add-vercel,/add-tavily-tooland/add-dial-toolrefuse a gateway that is not 1.45. If your Claude key in OneCLI is not namedAnthropic(or your Codex keyCodexoropenai), new groups get no key: run that provider's login again after upgrading (pnpm exec tsx setup/index.ts --step gateway-auth claude, orcodex). Check:/api/healthreports 1.45.0 and a new agent group answers. Rollback: restore the database backup the guide takes.
(#4094) - [BREAKING] OneCLI installs: give OneCLI's database its own password.
/update-nanoclawdoes not do this for you. Detect:[ -f ~/.onecli/docker-compose.yml ] && { ! grep -q '^POSTGRES_PASSWORD=.' ~/.onecli/.env 2>/dev/null || grep -Eqx "POSTGRES_PASSWORD=[\"']?(onecli)?[\"']?[[:space:]]*" ~/.onecli/.env; } && echo affected. Remote gateways and Iron Proxy installs are not affected. Why: OneCLI's database still used the fixed default password from OneCLI's compose file. Fix, from the NanoClaw folder:pnpm exec tsx .claude/skills/add-onecli/scripts/postgres-password.ts. It saves a random password in~/.onecli/.env, sets it on the database and restarts OneCLI once; your data stays. If it prints "Not changed", fix what it names (usually a setting to save in~/.onecli/.env) and run it again. Check: a second run prints "OneCLI's database already has its own password", and once the update has finished, an agent answers. Rollback: none needed; the previous release keeps working with the new password.
(#4439) - [BREAKING] The webhook server now listens on 127.0.0.1 by default. Tunnels and reverse proxies on the same machine keep working. Affected: a proxy on another machine, or anything in Docker on Linux that calls back to the host, such as a Mattermost server; webhooks stop arriving, and the log shows
Webhook server started host="127.0.0.1". Fix: setWEBHOOK_HOST=0.0.0.0(or one interface's IP address; a name such aslocalhoststops the host at startup) in.envand restart. Check: a message on that channel gets an answer. Rollback: the same setting restores the old behavior.
(#4185) - [BREAKING] Google Chat installs need two new settings, or the channel does not start. Google Chat now verifies that webhooks come from your Workspace add-on Chat app, using
GOOGLE_CHAT_ENDPOINT_URLandGOOGLE_CHAT_PROJECT_NUMBER(digits) in.env;/update-nanoclawbrings the new adapter but cannot ask for them. Detect: the log says "Google Chat needs GOOGLE_CHAT_ENDPOINT_URL and GOOGLE_CHAT_PROJECT_NUMBER (digits) in .env to verify webhooks". Fix: re-run/add-gchat, which keeps your existing values and asks for the endpoint URL, the project number and the bot user id for @mentions in spaces, or set both values by hand and restart. The Chat app must be a Google Workspace add-on, and converting an app to one cannot be undone. Check: a test message gets an answer. Rollback:pnpm exec tsx scripts/update-nanoclaw.ts rollback --id <transaction-id>.
(#4132, #4100) - [BREAKING] Custom skills and forks: a card's response handler must say what the click did. Affected: your own skill or fork code that registers a response handler for card clicks, or that calls
finalizeRejectwith a reason. Detect: a response handler that returnstruestill compiles, but its card no longer changes and the host logslegacy_true; afinalizeRejectcall with a 4th string argument no longer compiles. Why: a card may show only what the host decided. Fix: return'accepted','refused','closed'or'ignored'(orfalseto pass the click on), and pass a reject reason asfinalizeReject(approval, session, userId, { reason }). Check:pnpm exec tsc --noEmitpasses and a clicked card changes. Rollback: return to the previous release; handlers that returntruethen redraw as before.
(#4168, #4171) /add-dial-toolusers: run the upgrade guide's Dial check before upgrading OneCLI. It reads only, and saysdeleteonly when the gateway has not converted yet (1.43 or older) and the upgrade could remove what keeps agents away from Dial, such asDial: blocked agents, or when it cannot read all the rules that decide; a gateway already on 1.44 or later keeps its Dial key and its grants. When it saysdelete, the guide's--deletecommand removes the key; re-run/add-dial-toolafter the upgrade, which gives the Dial key only to the agent groups you choose, and new groups get Dial only when you add them. NanoClaw'sONECLI_PROJECT_IDand theonecliCLI's project (onecli config set project, orONECLI_PROJECT) must match or both be unset: when they differ, the re-run stops and writes nothing to OneCLI. An agent group name with a line break no longer changes which groups keep Dial. (#4196, #4095)- Update Node to its October 2026 security release. Setup now requires Node 22.23.4, 24.22.1 or 26.12.1 or newer and refuses the end-of-life 23 and 25; locally built agent images move to Node 22.23.5 (Node's November 2026 security release), pinned by digest, and hardened installs get it with a later image. NanoClaw keeps running on an older Node; re-running setup picks a Node that meets the minimum, and stops only when it finds none. After
/update-nanoclaw, runbash setup/install-node.sh, then re-runbash nanoclaw.shso the service uses the new Node. If Node comes from nvm, fnm, volta or asdf, update it there. (#4183) - Egress lockdown now covers agents that were already running when it was turned on: they restart on the locked network when the host restarts. If the lockdown network exists but is not internal (only a network made by hand, or a setting that points at an ordinary one), agents no longer start and the host log says "Refusing to spawn with open egress". Fix: list what is attached with
docker network inspect nanoclaw-egress, detach it (docker network disconnect nanoclaw-egress <container>), thendocker network rm nanoclaw-egress; the next agent start recreates it as internal. Iron Proxy installs name itnanoclaw-egress-<slug>, andNANOCLAW_EGRESS_NETWORKcan set another name. (#4160) - Locally built agent images move to Claude Code 2.1.321 and Agent SDK 0.3.321, where Claude Haiku 5.5 replaces Haiku 4.5. They are the first pair that knows Claude Fable 5.2. On the Anthropic API, Claude Code's background requests and groups set to
haikumove to Haiku 5.5, which costs a tenth of Haiku 4.5's price for prompts up to 100K tokens. Hardened installs keep Claude Code 2.1.280 and Haiku 4.5 until an image for this release is listed. (#4332) - Hardened installs move to the image built from v2026.10.0. A pull now takes the image listed in
agent-images.jsononmainfor the newest release in the install's history, so a new hardened image reaches installs without a new release. Until an image built from 2026.11.0 is listed, this release uses v2026.10.0's (Claude Code 2.1.280, newer than the old pinned build), and the pull's "agent-runner lock drift" warning is expected.mainlists a newer build of that image, made on 2026-11-14, so/update-nanoclawpulls it again. Runpnpm exec tsx setup/index.ts --step registry -- --refreshto move onto it, and again once the 2026.11.0 image is listed (hardened runtime). (#4139, #4149) - Codex groups signed in with ChatGPT can use GPT-6.2 Astra and GPT-6.2 Sol.
/add-codexnow pins@openai/codex0.169.0; OpenAI refuses these models to Codex 0.165 and older on ChatGPT logins (API keys already worked). Groups with no model set start new threads on GPT-6.1 Sol with an API key and on GPT-6.2 Sol with a ChatGPT login; existing threads keep their model. To pick one, runncl groups config update --id <group-id> --model gpt-6.2-astra, thenncl groups restart --id <group-id>. To stay on the 2026.10.0 default, use--model gpt-6-astra. (#4446)
✨ New
- Agents can create other agents from templates. Ask in chat, or pick one from
ncl templates listor the public library (using templates). (#4112) - Cursor is an agent provider. Run
/add-cursoror pick Cursor in setup; it needs a locally built agent image (providers). (#4107) - Setup waits for a slow first reply instead of failing, and shows each stage with its time, so local models that take minutes to load pass setup. Setup without a terminal now stops waiting after 2 minutes instead of 30 seconds. (#4108)
- Agents on slow local models are no longer cut off mid-turn. Raise
NANOCLAW_ABSOLUTE_CEILING_MSorNANOCLAW_CLAIM_STUCK_MSin.env, then restart (environment variables). (#3646) - Cards can show KPI fields, a table and charts. Slack draws them natively and Teams shows a chart as a table; where a channel can't show them, the agent sends the numbers as text. (#4292)
- Early test builds are now called betas (
vX.Y.Z-beta.N), and the last one or two before a release are release candidates. To get them, runpnpm exec tsx scripts/update-nanoclaw.ts set-channel --channel beta; the defaultstablechannel never gets either. (#4313)
🛠️ Fixes
Channel fixes arrive with /update-nanoclaw. After a manual merge, rerun /add-<channel> for each channel you use.
- Setup tells you when the first reply failed, with the agent's error, the log files and the troubleshooting docs, instead of saying your assistant is ready, and
pnpm run chatexits with code 4 on a failure notice. (#3980) - Setup on Linux and WSL asks for your password in the open, right before it installs Node or Docker. (#4200)
- Setup on Linux reaches Docker right after it adds you to the docker group, so the service no longer keeps restarting. A reboot (or
wsl --shutdownon WSL) makes it last. (#4201) - Setup names the NanoClaw account this machine is signed in to and lets you switch it without deleting
account.json. (#4225) - Channel setup works on WSL and minimal Ubuntu images: setup installs jq when it's missing. (#4202)
- Setup restarts NanoClaw after it installs a provider, so Codex, Cursor and OpenCode work without a manual restart. OpenCode with a new endpoint needs one more
bash setup/lib/restart.sh. (#4213) - Codex sign-in no longer needs the Codex CLI installed. Setup runs the pinned version through pnpm, with no global install or sudo. (#4455)
- Setup keeps using the Node version it checked, and names the real cause when Node or npm is broken. (#4373, #4418)
- The background service finds the tools it was installed with (Homebrew on Apple Silicon, nvm on Linux) and uses
NANOCLAW_INSTALL_IDwhen you set it. Existing installs get both by runningpnpm exec tsx setup/index.ts --step serviceonce. Thanks to @refactornator and @patrick-hofmann. (#1604, #1938, #4350) /update-nanoclawno longer stops at its validate step on installs with Slack (thanks to @witek) or/add-vercel, or on a busy machine. (#3451, #4489, #4488)/update-nanoclawno longer stops on a lockfile conflict at the first update of a default install. After a manual merge, take the new lockfile and runpnpm install --lockfile-only. (#4312)- Fetching the pre-built sandbox image works again after a Node upgrade. (#4341)
- Groups that installed extra packages move to the new agent image on their own, so
--rebuildis no longer needed after an update. If you built a group's image by hand under its own tag, give it your own tag and pin it withncl groups config update --id <group-id> --image-tag <tag>. (#4431) - Agents no longer lose or repeat a reply around
send_message. (#3918) - Agents reply in the language of the message they're answering, unless you ask for another. (#4329)
- A stuck channel no longer silences agents. NanoClaw stops waiting on a send after 60 seconds and keeps the conversation going. (#4192)
- Claude agents start fresh when their saved conversation is gone, instead of failing with "No conversation found" and losing the message. (#4379)
- Recurring tasks no longer grow the session database by one copy of the task prompt per run. Thanks to @OowhitecatoO. (#4245)
- Long replies are sent in parts and resume at the part that failed. Slack replies over 10,000 characters are split instead of refused, and a cut no longer breaks an emoji. (#4419, #4363, #4322)
- Claude agents can read long PDFs you send them. Hardened installs get it with a later image. (#4174)
- Codex agents behind OneCLI can use Codex's built-in image generation, and on Slack installs they keep the ncl and canvas instructions. (#4164, #4465)
ncl groups config add-mountrefuses folders NanoClaw keeps for itself. If a group already has one, its container start is refused: remove the mount withncl groups config remove-mount, then restart the group. (#4377)- Discord: Approve on an approval card now approves (thanks to @carstenf), and server messages that @mention someone reach the agent (thanks to @topcoder1). (#4117, #4251, #4252)
- Agent reactions reach Telegram and other Chat SDK channels. Thanks to @antonio-antuan. (#3970)
- Approval cards are clearer and safer to click. They appear in the thread where you're waiting, show the full action and mark anything they shorten, keep the question once answered, and change only after NanoClaw accepts the click. An approval or
ask_user_questionwhose title and question run over 2,000 characters is refused, and the agent is told the limit. (#4135, #4147, #4156, #4168, #4171, #4328) - Mattermost: one @mention no longer makes the bot answer every message in the channel. Mention it once in a thread and keep talking there. (#3797)
- Mattermost recovers by itself from a short outage at startup, retries a connection that never finishes opening instead of hanging, and splits replies longer than one post. (#4265, #4351, #4320)
- Slack agent DMs show three "Get started" suggested prompts, and new DM threads get a title. (#4456)
- Google Chat attachments reach the agent, and the agent says so when a file comes from Google Drive. Resend email replies go out again. (#4170, #4176, #4169)
- The WhatsApp link step gives a clear answer when WhatsApp refuses the connection or a pairing code goes unused. (#4420)
- Signal on Linux: sends to new contacts no longer hang. Rerun
setup/install-signal-cli.sh, then restart the service. (#4093) - Also fixed in setup and updates: Arch setup asks before a whole-system upgrade to install jq (#4371); provider image rebuilds show a progress window instead of Docker output (#4453); setup asks about the hardened image again after a sign-in that didn't finish (#4432), warns when a remote OneCLI gateway would send agents to their own machine (#4203), explains a failed background Slack install (#4204), accepts Anthropic's newer
sk-ant-usrandsk-ant-svcAPI keys when they are scoped to one workspace (#4161) and no longer prints a pkttyagent error on Linux without polkit (#3798);/update-nanoclawnames each skill it couldn't refresh (#4430) and typechecks agent-runner changes without Bun (#4461);/update-skillsrefreshesslack-agent-flow(#4406); Discord and Matrix re-runs apply the adapter patch (#4375); extra packages install when the NanoClaw folder's name has a space (#4317); and scripts run from paths with a space or a symlink, thanks to @echarrod (#4303). - Also fixed for agents and channels: mention-sticky threads wake the agent only after it was mentioned there (#3802, #4335, #4336); Docker Desktop runs no longer fail when a message arrives mid-reply (#4119), and
ncland agent tools no longer hit "database is locked" (#4101); an agent reads its own replies from other threads as its own (#4092);ncl groups restart --idrestarts the group you name, thanks to @antonio-antuan (#4026);ncl groups deleteandncl messaging-groups deleteclean up what depends on the group (#4110, #4103, #4102); creating an agent refuses an invalid folder name and no longer trips over a group that hasn't run yet (#4148, #4120); a Slack bot for channels only no longer sends you an FYI for each DM it turns away (#4070, #4071); stopping a container no longer logs a false error, thanks to @musashinm (#4057); Chat SDK errors and refused portal connections show in the log, and idle stops log at info (#4324, #4433, #4382); GitHub, Linear and Resend log a warning when a message that waited behind a busy conversation is skipped or expires (#4364); a Discord card that times out loses its buttons (#4367); agents no longer misread a OneCLIaccess_restrictederror, and the OneCLI docs match 1.45 (#4437, #4405); WhatsApp marks voice notes as voice notes (#4378);nclshows the restart command on Linux without systemd (#4206); and the/add-dashboarddashboard keeps up with large transcripts once you rerun/add-dashboard, thanks to @NechuBM (#4086).
🔒 Security
/add-resendinstalls a Resend adapter with no known advisories. The pin moves from 0.1.1 (4 moderate findings throughuuid) to 0.3.0, and/update-nanoclawmoves existing email installs to it (after a manual merge, rerun/add-resend). The webhook now answers before the message is processed, so a message that fails is not retried, and replies are sent as HTML with a plain-text part that drops link targets. (#4042)- Signal setup checks the signal-cli download's sha256 before installing it. (#4093)
- OneCLI setup keeps keys off the command line. Setup now gives keys to the
onecliCLI through a private temporary file or stdin, and hides them in error messages. If setup ever failed while saving your Anthropic key or OneCLI API key, rotate that key and delete the old files inlogs/setup-steps/andlogs/setup.log. (#4187) - OneCLI's database gets its own password, so agent containers can no longer log in to it. It used a fixed default password, so code in any agent container, including an agent steered by prompt injection, could log in and take control of OneCLI. Setup now gives a new install a random password; an existing install runs the one command under Before you update.
/add-oneclialso tells you when the database still accepts the default password after setup, and~/.oneclican no longer be mounted into an agent container. See GHSA-j39m-796j-gjm3. (#4439, #4471) - Dial setup no longer leaves the account token readable by other users on the machine while it pins the default sender number. (#4315)
- Registry sign-in opens your browser only for a plain https link, and says so when it starts no browser. On WSL without
wslvieworxdg-openit no longer triescmd.exe; open the link it prints instead. (#4316) - Text that task scripts and webhooks put in an agent's prompt can no longer pose as text NanoClaw wrote. Script output, webhook bodies, task prompts and attachment types can no longer close the block they sit in. Thanks to @petrolette. (#3717)
- Locally built agent images move to Node 22.23.5, Node's November 2026 security release.
/update-nanoclawrebuilds the image; hardened installs get it with a later image. Setup's minimum Node stays the same. (#4398) - Approval cards on Google Chat and Discord show request text as typed. On Google Chat a card's own labels are bold, so a line of request text can't pose as one, and a line in an agent's message that starts like a label, such as
*Action:*, stays as typed. On Discord,*,_and~in request text show as typed, so they can't turn code into links, mentions or spoilers./update-nanoclawbrings it; after a manual merge, rerun/add-gchator/add-discord. (#4356, #4360) - Locally built agent images move to Bun 1.4.4, which no longer trusts the revoked eMudhra certificates.
/update-nanoclawrebuilds the image; hardened installs get it with a later image. (#4193) - Locally built agent images clear every known High and Critical advisory that had a fix. The image ships npm 11, pnpm 10.34.9, a fresh build of its Node base and updated agent-runner libraries.
/update-nanoclawrebuilds the image; hardened installs get it with a later image. (#4270) - Re-applying a template to an agent (restamp) can no longer be pointed outside its group folder. It refuses, with an error, to write a context file or skill through a folder in the group folder that was swapped for a link, and checks template file names more strictly. On a Mac this needs the NanoClaw folder on an APFS or HFS+ disk (the usual Mac disk); on other disks these writes are refused. (#4194)
- Hardened how the host opens files in agent folders.
🔧 For custom installations
- Custom container code that reads
inbound.dbthroughopenInboundDb()orgetInboundDb()(mailbox/sqlite/connection.ts) must usereadInbound((db) => ...):openInboundDb()is gone, andgetInboundDb()now works only in tests. (#4118) - Custom mailbox stores that create storage on first write: a new thread or conversation now gets its earlier context there. The default SQLite store was not affected. (#4347)
CLAUDE.mdmatches the code again. Coding agents get the right session folder and image tag, and know a group'sCLAUDE.mdis rewritten on every start: standing instructions go ininstructions.prepend.md. (#4380)/add-codexships its provider inside the skill, so installs and forks no longer need the providers branch; on an older core its instructions tell you to update core first. Codex archives pick up core's header fix (the thread-id line no longer renders as a heading). (#4104)- Provider skills can archive exchanges through core. Use
container/agent-runner/src/provider-contracts/exchange-archive.ts; refreshing/add-codexdeletes the old copy inproviders/exchange-archive.ts, so a custom provider that imports it must switch. (#4105) - Skills can add context when a message wakes an agent, without editing core. Register a provider with
registerWakeContext(src/wake-context.ts): blocks it returns within a shared 1.5-second budget are written before the waking message, as<tag about="...">, a later block rides with the next message, and a slash command gets none. Channel adapters gain an optionalreadHistory(the Chat SDK bridge has it), and the mailbox's outbound reads carry an optionalplatformMessageId. With nothing registered, routing works as before and the agent's prompt gains one line about theaboutattribute. (#4435) - A gateway credential can target one exact path on a host. The provider credential seam moves to version 2: a custom provider skill that requires exactly version 1 must accept 1 or later, a skill that sets
pathmust require 2, and a custom gateway must declareconnectionPaths: trueto accept path-scoped credentials. (#4106) - The agent image no longer installs
cron-parseror itsluxondependency (about 4.9 MB); scheduling still runs on the host. Custom container code that imported them must add them back. (#4088) - Forks that pointed the
versions.jsonagent-image pin at their own mirror must move that reference toNANOCLAW_AGENT_IMAGE_REF, because theagent-images.jsonlist now comes first. (#4139) - Forks no longer run the agent-image refresh workflow, which failed every 6 hours outside
nanocoai/nanoclaw. (#4157) - OpenCode:
OPENCODE_NATIVE_ATTACHMENT_MAX_BYTESandOPENCODE_NATIVE_ATTACHMENT_MAX_COUNTare gone; they never took effect. (#4172) - Forks: keep
@chat-adapter/discordat 4.41.1. A newer adapter needs a newerchatthan core pins, sopnpm run buildfails. If pnpm stops withERR_PNPM_UNUSED_PATCH, runpnpm add @chat-adapter/discord@4.41.1or re-run/add-discord; to remove Discord, follow itsREMOVE.md./add-discord's troubleshooting now gives the same fix, instead of keeping a newer adapter that doesn't build. (#4404)
New Contributors
- @dependabot[bot] made their first contribution in #4066
- @bmultini made their first contribution in #4081
- @patrick-hofmann made their first contribution in #1938
- @refactornator made their first contribution in #1604
- @NechuBM made their first contribution in #4086
- @shachartal made their first contribution in #3570
- @carstenf made their first contribution in #4117
- @witek made their first contribution in #3451
- @nanoclaw-image-refresh[bot] made their first contribution in #4179
- @stefancgillberg made their first contribution in #4022
- @antonio-antuan made their first contribution in #3970
- @joel-nanoco made their first contribution in #4329
- @musashinm made their first contribution in #4057
- @petrolette made their first contribution in #3717
Contributors
Thanks to everyone who landed work in this release:
- build(deps): bump source-map-js from 1.2.1 to 1.2.2 by @dependabot[bot] in #4066
- chore(container): bump Claude Code to 2.1.296, the Agent SDK to 0.3.296 and Codex to 0.162.1 by @gavrielc in #4069
- feat(permissions): a decline can skip the owner FYI by @amit-shafnir in #4070
- fix(approvals): approval card joins the requester's thread in their own chat by @amit-shafnir in #4080
- fix(agent-runner): never lose or repeat a reply around send_message by @glifocat in #3918
- build(deps-dev): bump vitest from 4.1.4 to 4.1.11 by @dependabot[bot] in #4067
- test(update-skills): isolate registry-remote env overrides by @bmultini in #4081
- ci: pin workflow runners to ubuntu-26.04 by @glifocat in #4085
- test(setup): keep channel-skill fixtures out of the checkout by @glifocat in #4087
- fix(setup): bump signal-cli to 0.14.9 and verify the download by @glifocat in #4093
- build(deps-dev): clear 11 dev-only Dependabot alerts by @glifocat in #4089
- chore(agent-runner): drop unused cron-parser dependency by @glifocat in #4088
- fix(sweep): global env overrides for ABSOLUTE_CEILING_MS and CLAIM_STUCK_MS by @glifocat in #3646
- chore(skills): bump the Resend adapter pin to 0.3.0 by @glifocat in #4042
- fix(cross-session-context): the agent's own replies from other threads read as "you" by @amit-shafnir in #4092
- feat: create agents from templates in chat by @amit-shafnir in #4112
- feat(setup): the template library picker reads the index by @amit-shafnir in #4113
- fix(templates): a template create skips a folder an unspawned group holds by @amit-shafnir in #4120
- fix(agent-runner): retry inbound.db reads caught mid host write by @amit-shafnir in #4118
- fix(router): send the command-gate denial without writing outbound.db by @amit-shafnir in #4119
- fix: include /opt/homebrew/bin in launchd plist PATH by @patrick-hofmann in #1938
- fix(agent-runner): set busy_timeout before journal_mode on outbound open by @glifocat in #4101
- ci: check the signal-cli hash and open an issue for new releases by @glifocat in #4096
- fix: include Homebrew and node paths in service PATH by @refactornator in #1604
- fix(add-dashboard): read transcripts without loading whole files by @NechuBM in #4086
- ci(stale): add author-blocked stale policy; closing stays in dry run by @glifocat in #3656
- fix(setup): score the agent's failure notice as a failed first chat by @glifocat in #3980
- fix(approvals): keep untrusted text on one line in approval cards by @glifocat in #4090
- fix(channels): bump chat core + adapters to 4.41.1 — Telegram drops URLs with odd underscore counts by @shachartal in #3570
- feat(container): pull the hardened image published for each release by @amit-shafnir in #4139
- fix(approvals): post long approval cards in full as text blocks by @glifocat in #4135
- feat(gateways): let a credential connection target one path by @glifocat in #4106
- feat(agent-runner): add a shared exchange archive for provider contracts by @glifocat in #4105
- fix(cli): clear host rows and refresh destinations in ncl groups delete by @glifocat in #4110
- feat(skills): add /add-cursor with its own payload by @glifocat in #4107
- fix(interactive): stop waiting when a question card cannot be delivered by @glifocat in #4141
- fix(approvals): quote untrusted text in the remaining approval cards by @glifocat in #4136
- feat(setup): wait longer for the first reply and show its stages by @glifocat in #4108
- fix(codex): give gateway stand-ins the real ChatGPT workspace id by @glifocat in #4133
- feat(add-codex): ship the Codex runtime from the skill payload by @glifocat in #4104
- agent-images: list the v2026.10.0 hardened image by @amit-shafnir in #4149
- ci: open the agent-images.json PR for each promoted image, as the refresh App by @glifocat in #4010
- chore(release): v2026.10.1-rc.1 by @glifocat in #4158
- docs: provider code ships in skill payloads, not the providers branch by @glifocat in #4109
- ci: run the image refresh only in nanocoai/nanoclaw by @glifocat in #4157
- fix(cli): cascade dependent rows in ncl messaging-groups delete by @glifocat in #4103
- fix(agents): refuse a new agent whose group folder is invalid by @amit-shafnir in #4148
- fix(skills): clear messaging-group dependents in add-imessage removal by @glifocat in #4102
- fix(discord): Approve clicks recorded as reject (custom_id value suffix not stripped) by @carstenf in #4117
- fix(add-gchat): ask for the endpoint URL and project number by @glifocat in #4100
- fix(update-skills): attribute a barrel import to the skill that appends it by @witek in #3451
- agent-images: v2026.10.0 -> v2026.10.0-20261021T1608 by @nanoclaw-image-refresh[bot] in #4179
- fix(setup): accept Anthropic's newer API key types (sk-ant-usr, sk-ant-svc) by @glifocat in #4161
- refactor(add-opencode): drop the unreachable attachment file-part path by @glifocat in #4172
- fix(webhook): listen on 127.0.0.1 by default, add WEBHOOK_HOST by @glifocat in #4185
- fix(egress): apply lockdown to agents already running when it is turned on by @glifocat in #4160
- fix(container): add poppler-utils so Claude agents can read PDFs by @glifocat in #4174
- fix(host): stage attachments for message ids that contain '/' by @glifocat in #4170
- feat(add-onecli): OneCLI 1.45 grants; new groups get only their model credential by @glifocat in #4094
- fix(security): require Node's October 2026 security releases in setup and the agent image by @glifocat in #4183
- feat(add-dial-tool): scope Dial with OneCLI agent grants by @glifocat in #4095
- fix(add-dial-tool): one OneCLI project for the key and its grants; safe group names by @glifocat in #4189
- fix(onecli): don't pass secrets on the command line; redact failed-command errors by @glifocat in #4187
- chore(release): v2026.10.1-rc.2 by @glifocat in #4190
- chore(container): bump Bun to 1.4.4 for the eMudhra root removal by @glifocat in #4193
- ci: cut the PR gate from 7.5 to 2.5 minutes with sharded tests and a cached image by @zvi-fried in #4191
- ci: put the jobs added by #4191 on Bun 1.4.4 by @glifocat in #4208
- fix(add-onecli): delete the Dial key on upgrade only when the conversion could widen it by @glifocat in #4196
- fix(setup): print the device code beside the portal link by @amit-shafnir in #4224
- fix(setup): name the signed-in account and let setup switch it by @amit-shafnir in #4225
- agent-images: v2026.10.0 -> v2026.10.0-20261026T0306 by @nanoclaw-image-refresh[bot] in #4226
- fix(add-discord): ship the adapter patch so @mentions reach the bot by @topcoder1 in #4251
- agent-images: v2026.10.0 -> v2026.10.0-20261103T0454 by @nanoclaw-image-refresh[bot] in #4253
- test: give subprocess-spawning OneCLI detector test a 30s timeout by @stefancgillberg in #4022
- fix(delivery): strip the agent-group suffix from reaction/edit target ids by @antonio-antuan in #3970
- docs(contributing): match the PR body example to what #3646 shipped by @glifocat in #4145
- fix(cli): add the no-systemd restart hint, fix service names in CLAUDE.md by @glifocat in #4206
- fix(templates): restamp writes through pinned directories by @glifocat in #4194
- fix(setup): ask for the sudo password up front on Linux, and give WSL the right docker-group hint by @glifocat in #4200
- ci: add Dependabot for Actions, pnpm, bun, docker and skill pins; remove the inert Renovate config by @glifocat in #3978
- chore(deps): bump actions/create-github-app-token from 3.2.0 to 3.3.0 in the actions-minor-patch group by @dependabot[bot] in #4277
- chore(deps): bump pnpm/action-setup from 4.3.0 to 6.1.0 by @dependabot[bot] in #4278
- chore(deps): bump actions/setup-go from 5.6.0 to 7.0.0 by @dependabot[bot] in #4280
- chore(deps-dev): bump @eslint/js from 9.39.4 to 9.39.5 by @dependabot[bot] in #4285
- chore(deps): bump actions/setup-node from 4.4.0 to 7.1.0 by @dependabot[bot] in #4281
- chore(deps-dev): bump globals from 15.15.0 to 17.13.0 by @dependabot[bot] in #4283
- chore(deps-dev): bump vitest from 4.1.11 to 5.0.5 by @dependabot[bot] in #4286
- feat(send_card): fields, tables and charts in agent cards by @amit-shafnir in #4292
- fix(send_card): count a card's whole text as Teams receives it by @amit-shafnir in #4296
- fix(delivery): one stuck channel send no longer silences a session until restart by @glifocat in #4192
- fix(container): clear known fixable advisories from the agent image by @glifocat in #4270
- fix(setup): reach Docker from the user service when the docker group was just added by @glifocat in #4201
- feat(release): accept vX.Y.Z-beta.N pre-release tags by @glifocat in #4313
- chore(release): v2026.11.0-beta.1 by @glifocat in #4326
- Reply in the language of the message being answered by @joel-nanoco in #4329
- fix(release): refuse a pre-release that sorts below an existing tag by @glifocat in #4330
- chore(container): bump Claude Code to 2.1.321 and the Agent SDK to 0.3.321 by @Koshkoshinsk in #4332
- fix(update): regenerate lockfile-only merge conflicts by @glifocat in #4312
- fix(setup): restart the host after provider-auth installs a provider by @glifocat in #4213
- fix(setup): install jq so channel setup works on WSL and minimal Linux images by @glifocat in #4202
- fix(router): mention-sticky follows a thread only after the agent was woken there by @glifocat in #3802
- fix(add-dial): write the default-sender pin's auth file private by @glifocat in #4315
- fix(onecli): warn when a remote gateway points agents at their own machine by @glifocat in #4203
- chore(deps-dev): bump prettier to 3.9.10 and reformat src by @glifocat in #4293
- ci: read-only token for CI; check the release target before running it by @glifocat in #4318
- test(add-resend): copy and run the Resend delivery test by @glifocat in #4188
- test(onecli): drop a replace that changed nothing by @glifocat in #4319
- fix(questions): keep the question on an answered ask_user_question card by @glifocat in #4328
- fix: run docker build and pkill without a shell by @glifocat in #4317
- fix(router): stop holding sticky follow-ups behind a pending command gate by @glifocat in #4335
- chore(release): v2026.11.0-beta.2 by @glifocat in #4343
- fix(cross-session-context): backfill prepares a new session's mailbox by @Koshkoshinsk in #4347
- fix(approvals): approval cards always show the full action by @glifocat in #4147
- fix(setup): honor NANOCLAW_INSTALL_ID in shell service and image names by @glifocat in #4350
- fix(setup): open the sign-in link without a shell, https only by @glifocat in #4316
- fix(channels): log Chat SDK warnings and errors instead of silencing them by @glifocat in #4324
- fix(approvals): resolve a clicked card only after the host accepts the click by @glifocat in #4168
- chore(add-slack): copy, run and remove the long-replies test by @glifocat in #4323
- chore(add-mattermost): copy, run and remove the channel factory test by @glifocat in #4325
- chore(release): v2026.11.0-beta.3 by @glifocat in #4359
- fix(setup): show why a Slack setup job failed, and pass verify after a good re-run by @glifocat in #4204
- fix(setup): give the nohup wrapper the install id and retire the old service by @glifocat in #4358
- agent-images: v2026.10.0 -> v2026.10.0-20261114T0248 by @nanoclaw-image-refresh[bot] in #4355
- fix(docker-driver): wait out in-flight --rm auto-removal on stop by @musashinm in #4057
- fix(setup): let the docker credential helper find Node after an upgrade by @glifocat in #4341
- fix(setup): stop the WhatsApp link step at once when WhatsApp closes the connection by @glifocat in #4372
- fix(claude): start fresh when the stored session's transcript is gone by @glifocat in #4379
- chore: remove dead code and stale comments by @glifocat in #4374
- docs: make CLAUDE.md match the code on main by @glifocat in #4380
- test(add-mattermost): pin the copy list and its REMOVE.md cleanup by @glifocat in #4365
- fix(build): load @types/node explicitly so TypeScript 6 and 7 keep Node globals by @glifocat in #4290
- fix(channels): never split an emoji when a long reply is cut by @glifocat in #4363
- fix(cli): groups restart --id from an agent restarts the target (#3911) by @antonio-antuan in #4026
- fix(setup): keep the Node that meets the minimum first on PATH by @glifocat in #4373
- ci(registry): test channel payloads and every channel together by @glifocat in #4177
- chore(dependabot): hold TypeScript at 6.x by @glifocat in #4381
- fix(add-matrix, add-discord): patch the adapter on re-runs and older installs by @glifocat in #4375
- docs(templates): stop promising gateway features OneCLI 1.45 removed by @glifocat in #4215
- test(container-runner): kill racing Docker's --rm auto-removal, end to end by @glifocat in #4383
- fix(logging): quiet idle ceiling reaps, log Docker's raw teardown error by @glifocat in #4382
- test(claude): cover a plain file and a missing projects dir in the transcript lookup by @glifocat in #4388
- fix(setup): report a failing npm, and find pnpm in ~/.local/bin when migrating by @glifocat in #4403
- fix(setup): keep the WhatsApp link when the connection closes after pairing by @glifocat in #4387
- fix(chat-sdk): warn when a queued inbound message is lost by @glifocat in #4364
- fix(agent-runner): escape payloads embedded in composed prompt blocks by @petrolette in #3717
- fix(setup): retire only the service names setup writes by @glifocat in #4362
- fix(setup): three follow-ups for the credential helper refresh by @glifocat in #4389
- fix(setup): tell a finished WhatsApp pairing from a requested pairing code by @glifocat in #4420
- chore(deps): bump node from 22.23.4-slim to 22.23.5-slim in /container by @dependabot[bot] in #4398
- docs(add-discord): move a newer adapter back to 4.41.1 instead of dropping the patch by @glifocat in #4404
- chore(release): v2026.11.0-beta.4 by @glifocat in #4423
- docs(add-onecli): an Allow covers Ask tools it matches; explain access_restricted to agents by @glifocat in #4405
- fix(skills): refresh slack-agent-flow, grown append blocks and missing channel adapters by @glifocat in #4406
- fix(logging): name the container or network a Docker teardown failed on by @glifocat in #4407
- fix(setup): ask the image question again after a failed sign-in by @glifocat in #4432
- feat: add extension points for context at a session's wake by @amit-shafnir in #4435
- fix(chat-sdk): resume a split reply at the part that failed by @glifocat in #4419
- docs: name the agent image's new Node base (22.23.5) by @glifocat in #4421
- test(skills): pin that a clean checkout reports no channel skill by @glifocat in #4436
- docs(add-onecli): access_restricted does not prove the app is connected by @glifocat in #4437
- fix(setup): say why when Node cannot start, and name the real reason pnpm is missing by @glifocat in #4418
- fix(update): name each skill that failed to refresh in the validate error by @glifocat in #4430
- fix(portal): end a refused cell dial at once instead of after 10 s by @glifocat in #4433
- fix(onecli): give OneCLI's database its own password by @glifocat in #4439
- fix(host): open agent-folder files without blocking by @glifocat in #4440
- fix(container): rebuild a group's image when the agent image under it changes by @glifocat in #4431
- chore(release): v2026.11.0-rc.1 by @glifocat in #4444
- docs(claude-md): list every cli_scope exception in the scope table by @glifocat in #4391
- fix(add-codex): pin Codex 0.169.0 so ChatGPT logins can use GPT-6.2 by @glifocat in #4446
- fix(setup): follow-ups from the #4202 and #4213 reviews by @glifocat in #4371
- fix(scripts): run CLI entry points from checkouts with spaces or symlinks in the path by @echarrod in #4303
- fix(mounts): reject extra mounts of paths the driver protects by @glifocat in #4377
- fix(update): typecheck agent-runner with the pinned Bun when the host has none by @glifocat in #4461
- fix(agent-runner): never block or follow links on the Claude settings.json by @echarrod in #4300
- fix(add-codex): raise the Codex AGENTS.md cap to 64 KiB by @glifocat in #4465
- fix(codex): make built-in image generation work behind OneCLI by @glifocat in #4164
- chore(release): v2026.11.0-rc.2 by @glifocat in #4466
- fix(setup): verify linger without interactive polkit prompts by @glifocat in #3798
- fix(setup): follow-ups from the #4418 review by @glifocat in #4441
- fix(setup): show the provider image rebuild in the progress window by @glifocat in #4453
- fix(add-codex): sign in via the pinned Codex CLI through pnpm dlx, outside /tmp by @glifocat in #4455
- fix(add-codex): keep old sign-in folders a process Linux won't show may use by @glifocat in #4477
- fix(onecli): show a refused database password change, block ~/.onecli mounts by @glifocat in #4471
- chore(release): v2026.11.0-rc.3 by @glifocat in #4487
- fix(setup): a step ends only once its raw log is written by @glifocat in #4488
- test(container): let the vercel guard accept an /add-vercel install by @glifocat in #4489
- fix(mailbox): keep one task payload per recurring series by @OowhitecatoO in #4245
- test(cli): rewrite tests that cannot fail, drop duplicates by @glifocat in #4498
- docs(readme): fix claims that no longer match main by @glifocat in #4506
- chore(release): v2026.11.0 by @glifocat in #4508
Full Changelog: v2026.10.0...v2026.11.0