AgentIndex icon
AgentIndex
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Submit Tool
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Home/
Workflow Automation/
nanoclaw
nanoclaw logo

nanoclaw

Active·★ 31.1k·MIT·Updated 2026-11-17
★ Most Popular

### Architecture & Positioning NanoClaw (also known in the ecosystem as OpenClaw) is an open-source personal AI assistant runtime built around lightweight container isolation. Unlike conventional local agents that execute scripts and CLI commands directly on the host machine—posing severe risks of filesystem pollution and credential leaks—NanoClaw enforces a micro-container security architecture. Every active agent operates within a dedicated, disposable Linux container, interacting with the host exclusively via guarded Unix sockets and explicitly declared filesystem bind mounts, giving the agent a full shell and tool environment while strictly containing risk. ### Core Capabilities & Differentiation Compared to monolithic sandbox orchestrators, NanoClaw delivers near-instant cold starts, minimal system footprint, and out-of-the-box messaging channel pairing. Its built-in bootstrap scripts automate runtime preparation across Node.js/pnpm and container engines. Furthermore, its decoupled messaging adapter layer connects directly to Slack, Discord, Telegram, or local terminal sessions, allowing teams and developers to summon distinct agent personas with dedicated memory state, custom prompts, and domain skills without setting up complex Kubernetes clusters. ### Deployment & Best Practices When deploying NanoClaw in developer teams or automated server workflows, ensure Docker Engine or Docker Desktop is configured with restricted cgroup resources. In production environments, never expose root directories or sensitive host home paths in bind mounts; create ephemeral, task-scoped workspace volumes instead. Manage LLM API credentials and chat tokens strictly via environment variables or secret vaults rather than hardcoding them into skill manifests.

This write-up is based on the project's README and public repository data. We have not hand-tested the tool. Data as of 2026-11-15.

License
MIT
Latest release
v2026.10.0 · 2026-10-09
Last commit
2026-11-15
Contributors
187
Forks
12,645
Open issues and PRs
1,052
First published
2026-01-31

Source: GitHub, npm and PyPI public APIs.

#ai-agents#ai-assistant#claude-code#claude-skills#dev-tooling#openclaw
$ Install
$ git clone https://github.com/nanocoai/nanoclaw.git nanoclaw-v2 && cd nanoclaw-v2 && bash nanoclaw.sh
↗ Visit site★ GitHub
01

Features

01Agents use separate containers and explicit filesystem mounts.
02Setup pairs a selected messaging channel or local CLI.
03Skills add channels and alternative agent providers.
02

Why choose it

+Hardware-isolated micro-containers ensure agents can execute arbitrary code and CLI utilities without risking host filesystem corruption.
+Decoupled channel adapters natively bridge popular chat applications like Slack, Discord, and Telegram with local CLI workflows.
+Lightweight bootstrap automation configures container runtimes, node packages, and agent identities with minimal manual intervention.
+Modular skill architecture allows dynamic injection of new LLM backends, custom tool chains, and specialized workflow plugins.
03

Trade-offs

!Requires an active Docker daemon or container runtime, which incurs virtualization overhead on macOS and Windows WSL2 environments.
!Filesystem bind mounts must be meticulously audited to prevent unintended leaks of host credentials into containerized agents.
!Multi-channel notification routing and simultaneous multi-user sessions require external persistent storage configuration for durable state.
!Advanced network debugging across container bridges and host proxy firewalls may require custom iptables or docker-compose tuning.
04

Maintenance check

ActiveChecked: 2026-11-13
Last commit
2026-11-13
Commits, last 90 days
100+
Releases, last 90 days
9
Latest release
v2026.11.0-beta.2 (2026-11-12)
Open issues
1062
Recent issues with at least one comment
0/3
Commits per week, last 12 weeks
Commits per week, last 12 weeks: 63, 12, 27, 28, 26, 43, 41, 20, 70, 3, 16, 25

Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.

Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.

Most discussed open issues

  • #1503 nanoclaw.dev has an invalid ssl cert right now19 comments · 2026-03-28
  • #1984 Provider support for custom/local OpenAI-compat endpoints (Codex + OpenCode)6 comments · 2026-04-24
  • #3529 update-nanoclaw skill refresh: local adapters fail validation or get overwritten, no opt-out5 comments · 2026-08-25
  • #1163 Use OpenCode (and its JS SDK) instead/parallel with Claude Code (and its Agents SDK)5 comments · 2026-03-16

Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.

05

Compatibility

macos
Docker Desktop; Node/pnpm bootstrap available
Verified via docs
linux
Docker Engine; Node/pnpm bootstrap available
Verified via docs
windows
WSL2 with Docker
Verified via docs
nodejs
Node 22.23.4+, 24.22.1+ or 26.12.1+; pnpm 10+
Verified via docs
06

Quick start

1
$ git clone https://github.com/nanocoai/nanoclaw.git nanoclaw-v2
2
$ cd nanoclaw-v2
3
$ bash nanoclaw.sh
07

Use cases

↳Run a personal assistant through a chat channel.
↳Customize an assistant by modifying a small codebase.
↳Give teammates separate bot identities and memory.
08

Alternatives

⚡Top VS:
VSProduct-Manager-Skills★8.1k→VShermes-agent★264.2k→VSnocobase★25.0k→VSclaude-ads★11.1k→
video-shotcraft logo
video-shotcraft★ 21.0k
AI video skill for Claude Code & Codex — cinematic, editable product promos with Remotion: 124 shot recipe cards, 150 motion previews, beat sync, sound design, Motion Workbench & JianYing (CapCut CN) export.
claude-skills logo
claude-skills★ 12.4k
67 Specialized Skills for Full-Stack Developers. Transform Claude Code into your expert pair programmer.
Product-Manager-Skills logo
Product-Manager-Skills★ 8.1k
Product Management skills framework built on battle-tested methods for Claude Code, Cowork, Codex, and AI agents.
VSCompare→
hermes-agent logo
hermes-agent★ 264.2k
The agent that grows with you
VSCompare→
nocobase logo
nocobase★ 25.0k
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.
VSCompare→
claude-ads logo
claude-ads★ 11.1k
Claude-first paid-media operations skill for Claude Code across 12 ad platforms (Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, Amazon, Reddit, Pinterest, Snapchat, X): source-grounded audits, deterministic findings and evidence coverage, versioned JSON reports, and capability-gated account changes.
VSCompare→
dashi-ppt-skill logo
dashi-ppt-skill★ 10.8k
An AI-agent skill that generates browser-editable presentations from multiple visual themes, exportable to HTML, PDF, and PPTX.
VSCompare→
darwin-skill logo
darwin-skill★ 7.0k
达尔文.skill —— 一个让你的Skill无限进化的系统:评估→改进→测试→保留或回滚 | Autoresearch-inspired autonomous skill optimization for Claude Code. Evaluate, improve, test, keep or revert.
VSCompare→
See all alternatives →

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Why choose it03Trade-offs04Maintenance check05Compatibility06Quick start07Use cases08Alternatives
nanocoai /
nanoclaw
↗

Lightweight, container-isolated AI assistant runtime with channel pairing, explicit filesystem mounts, and extensible skill integrations

31.1k13kMIT
Last commit1d ago
StatusActive
CategoryWorkflow Automation
Contributors187
Latest releasev2026.10.0
Links
Documentation↗Discussion↗Issues↗Releases↗
Cloud Infrastructure
Ad

Deploy on DigitalOcean

Host your MCP servers, Docker containers, and AI agents with $200 free credit over 60 days.

Claim $200 Free Credit
© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
Best by use caseAboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

MCP ServersCode AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.