Skip to content
Agents tracked: 258 Downloads (7d): 219M up 6.1% GitHub stars: 5.5M VS Code installs: 148M Releases (7d): 293 Agent status: 2 with issues Updated Oct 7, 2026
AgentGid

NanoClaw changelog: what's new each month

Every stable NanoClaw release summarised by month: the highlights, new features, improvements, fixes and anything you need to act on. 3 months covered; the current month updates daily.

September 2026

1 release: 2.4.0

September brought significant model defaults and infrastructure changes to NanoClaw, with new credential and proxy options and improvements to container management during updates.

Action needed
  • Custom sources composing agent instructions must migrate to new module system.
  • Credential gateways must be installed before restart when merging upstream by hand.
  • OpenCode skill requires payload refresh; re-run /add-opencode to use native provider contracts.

Highlights

  • Claude agent groups now default to Opus 5.5 model instead of previous versions, affecting costs and usage limits.
  • New Iron Proxy option provides local gateway with control console for secrets, credentials, and OAuth management.
  • Custom instruction sources must migrate to the new module system for continued compatibility.
  • Agent containers are now properly stopped during updates, eliminating timeout issues.

New

  • Iron Proxy installed via /add-iron-proxy for local gateway with Iron Control web console.
  • Credential gateways now available through skills system with /add-onecli for OneCLI support.
  • Claude agents now default to Concise output tone.
  • Codex groups default to gpt-6-astra for new threads.

Improved

  • Update process now stops idle agent containers with 10-second grace period instead of timing out.
  • Claude model defaults upgraded: API-key installs from Opus 5, Pro and Team Standard from Sonnet.
  • Codex skill now uses native provider contracts with updated payload requirements.

Fixed

  • Agent updates no longer time out when idle containers are running.

August 2026

3 releases: 2.1.54 → 2.3.0

August brought major architectural changes to NanoClaw, unifying how channels, memory, and plugins work across the system. The release focused on simplifying integrations, tightening security, and improving session management.

Action needed
  • iMessage unified into single channel with /add-imessage backend selection required.
  • All providers now use shared OKF v0.1-compatible memory tree; persona moves to instructions.prepend.md.
  • Channel install skills become source of truth; whatsapp-formatting and slack-formatting move to channels branch.
  • Scheduled tasks moved from MCP tools to ncl tasks; task delivery now requires explicit named destination.

Highlights

  • iMessage now supports both local and hosted backends through a single unified channel.
  • All providers now share one memory format, with persona configuration moved to instructions.
  • Agent templates are now first-class plugins with standardized plugin.json and mcp.json files.
  • New per-agent Slack apps for classic Slack installs, with agent spawning directly from Slack.
  • Host restarts now preserve running agent sessions instead of killing in-flight work.

New

  • Default provider setting for new agent groups via DEFAULTAGENTPROVIDER.
  • Unified guard system for all privileged actions crossing container or channel boundaries.
  • Task management moved to ncl commands with explicit delivery destinations.
  • Remote MCP servers can now be registered via HTTP with Streamable support.
  • Plugin MCP servers can declare working directories in mcp.json.
  • Agent-to-agent messaging now properly prioritizes over Claude Code's built-in SendMessage.
  • Container identity explicitly configured for non-root hosts with uid and HOME settings.
  • Template-based agent creation in the setup wizard with local or remote templates.

Improved

  • Channel install skills now follow deterministic /add-channel patterns for consistency.
  • In-place plugin updates when applying a template to groups that already have it.
  • Scheduled task lifecycle now stricter with cascade deletion and due-run rejection.
  • Container gateway wiring is now typed and admission-checked before validation.
  • Agent-to-agent messaging receives proper session driver support.
  • MCP servers support configurable working directories via ${PLUGINROOT} paths.

Fixed

  • Codex provider updated to pin @openai/codex 0.146.0 ahead of GPT-5.4 retirement.
  • Claude installs updated to use hardened agent image with patched sandbox components.
  • Session data preservation ensured when switching from custom mailbox implementations to built-in SQLite.
  • Slack experience now properly handles agent spawning in classic single-bot installs.

June 2026

2 releases: 2.1.0 → 2.1.17

June brought major provider flexibility and reliability improvements to NanoClaw. The release adds support for multiple AI providers, fixes critical data corruption issues, and streamlines group management with cascading deletions.

Action needed
  • Startup requires upgrade-state.json marker; install must reach current version through sanctioned setup path.
  • OneCLI SDK 0.5.0 → 2.2.1 requires OneCLI server with /v1 API; older servers will 404.
  • Provider selection is now explicit per group; no install-wide default provider exists.

Highlights

  • New Codex (OpenAI) agent provider option alongside Claude, selectable per group with full runtime support.
  • Groups now support provider-specific memory isolation, allowing seamless switching between Claude and Codex without stale data.
  • Cascading group deletion now cleanly removes all associated sessions, tasks, and messages in a single transaction.
  • Long-lived session transcripts now auto-rotate at 12 MB to prevent size-related issues.
  • Billing errors and access denials now properly reach users instead of silently failing.

New

  • Codex (OpenAI) agent provider with full planning, MCP tools, and server-side history support.
  • Setup wizard can now select, install, and authenticate non-default agent providers.
  • /add-rtk skill installs rtk into agent containers with output-summarizing proxy, reducing token usage by 60–90%.
  • WhatsApp-formatting container skill adds @mention syntax support for agent communication.
  • /migrate-memory command enables cross-provider memory transfer without runtime involvement.
  • /upload-trace command ships session transcripts to Hugging Face.
  • /update-nanoclaw automatically upgrades the OneCLI gateway alongside SDK updates.
  • Provider registry in setup picker for streamlined provider selection and installation.

Improved

  • Startup now validates upgrade state to ensure sanctioned installation paths.
  • Long-lived hub sessions rotate transcripts before resume to maintain performance.
  • Group deletion now cascades across sessions, destinations, members, wirings, and scheduled tasks in one transaction.
  • Persistent inbound.db corruption now triggers container exit for host-sweep respawn with fresh mount.
  • Provider choice is now explicit per group via ncl groups config, removing install-wide defaults.
  • OneCLI SDK upgraded to 2.2.1 with pinned gateway and CLI versions in versions.json.

Fixed

  • Multiple pending messages no longer trigger N>1 retry loops after outbound <messages> envelope removal.
  • Command-gate denials now properly reach senders instead of silencing with SQLITEREADONLY errors.
  • Budget and billing-exhausted errors now surface to users instead of being silently dropped.
  • Session transcript retry logic fixed for pending messages bundled in envelope format.

Summaries are written automatically from the official release notes (full changelog ↗); check the original notes before relying on a detail. NanoClaw: pricing, features and alternatives · All changelogs