--- title: "nanoclaw" type: "tool" slug: "nanocoai-nanoclaw" canonical_url: "https://www.graphcanon.com/tools/nanocoai-nanoclaw" github_url: "https://github.com/nanocoai/nanoclaw" homepage_url: "https://nanoclaw.dev" stars: 30149 forks: 12893 primary_language: "TypeScript" license: "MIT" categories: ["ai-agents", "developer-tools"] tags: ["claude-skills", "openclaw", "ai-assistant", "claude-code", "ai-agents"] updated_at: "2026-07-07T18:21:15.311667+00:00" --- # nanoclaw > A lightweight AI assistant in containers for secure agent operation. NanoClaw is a lightweight alternative to OpenClaw designed for security. It runs agents in isolated Linux containers and connects to various messaging platforms like Telegram, Discord, WhatsApp, Gmail, etc. The project aims to simplify the complexity of similar solutions by reducing codebase size and ensuring filesystem isolation through containerization. ## Facts - Repository: https://github.com/nanocoai/nanoclaw - Homepage: https://nanoclaw.dev - Stars: 30,149 · Forks: 12,893 · Open issues: 830 · Watchers: 126 - Primary language: TypeScript - License: MIT - Last pushed: 2026-07-07T13:44:40+00:00 ## Categories - [AI Agents](/categories/ai-agents.md) - [Developer Tools](/categories/developer-tools.md) ## Tags claude-skills, openclaw, ai-assistant, claude-code, ai-agents ## Related tools - [ECC](/tools/affaan-m-ecc.md) - The agent harness performance optimization system (★ 226,962) - [hermes-agent](/tools/nousresearch-hermes-agent.md) - The self-improving AI agent built by Nous Research (★ 210,880) - [AutoGPT](/tools/significant-gravitas-autogpt.md) - AutoGPT: Build, Deploy, and Run AI Agents (★ 185,417) - [ollama](/tools/ollama-ollama.md) - Get up and running with Kimi-K2.6, GLM-5.1, MiniMax, DeepSeek, gpt-oss, Qwen, Gemma and other models. (★ 175,659) - [prompts.chat](/tools/f-prompts-chat.md) - The world's largest open-source prompt library for AI (★ 165,019) - [JavaGuide](/tools/snailclimb-javaguide.md) - Snailclimb/JavaGuide: 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发 (★ 156,863) - [langflow](/tools/langflow-ai-langflow.md) - Langflow is a powerful platform for building and deploying AI-powered agents and workflows. (★ 151,298) - [dify](/tools/langgenius-dify.md) - Production-ready platform for agentic workflow development (★ 148,070) ## README (excerpt) ```text

NanoClaw

An AI assistant that runs agents securely in their own containers. Lightweight, built to be easily understood and completely customized for your needs.

nanoclaw.dev  •   docs  •   中文  •   日本語  •   한국어  •   Discord  •   repo tokens

--- ## Why I Built NanoClaw [OpenClaw](https://github.com/openclaw/openclaw) is an impressive project, but I wouldn't have been able to sleep if I had given complex software I didn't understand full access to my life. OpenClaw has nearly half a million lines of code, 53 config files, and 70+ dependencies. Its security is at the application level (allowlists, pairing codes) rather than true OS-level isolation. Everything runs in one Node process with shared memory. NanoClaw provides that same core functionality, but in a codebase small enough to understand: one process and a handful of files. Claude agents run in their own Linux containers with filesystem isolation, not merely behind permission checks. ## Quick Start ```bash git clone https://github.com/nanocoai/nanoclaw.git nanoclaw-v2 cd nanoclaw-v2 bash nanoclaw.sh ``` `nanoclaw.sh` walks you from a fresh machine to a named agent you can message. It installs Node, pnpm, and Docker if missing, registers your Anthropic credential with OneCLI, builds the agent container, and pairs your first channel (Telegram, Discord, WhatsApp, or a local CLI). If a step fails, Claude Code is invoked automatically to diagnose and resume from where it broke.
Migrating from NanoClaw v1? Run from a fresh v2 checkout next to your v1 install: ```bash git clone https://github.com/nanocoai/nanoclaw.git nanoclaw-v2 cd nanoclaw-v2 bash migrate-v2.sh ``` `migrate-v2.sh` finds your v1 install (sibling directory, or `NANOCLAW_V1_PATH=/path/to/nanoclaw`), migrates state into the v2 checkout, then `exec`s into Claude Code to finish the parts that need judgment (owner seeding, CLAUDE.local.md cleanup, fork-customisation replay). Run the script directly, not from inside a Claude session — the deterministic side needs interactive prompts and real shell I/O for Node/pnpm bootstrap, Docker, OneCLI, and the container build. **What it does:** merges `.env`, seeds the v2 DB from `registered_groups`, copies group folders + session data + scheduled tasks, installs the channel adapters you select, copies channel auth state (including Baileys keystore + LID mappings for WhatsApp), builds the agent container. **What it doesn't:** flip the system service. Pick *"switch to v2"* at the prompt, or do it manually after testing — your v1 install is left untouched. See [docs/v1-to-v2-changes.md](docs/v1-to-v2-changes.md) for what's different and [docs/migration-dev.md](docs/migration-dev.md) for development notes.
## Philosophy **Small enough to understand.** One process, a few source files and no microservices. If you want to understand the full NanoClaw codebase, just ask Claude Code to walk you through it. **Secure by isolation.** Agents run in Linux containers and they can only see what's explicitly mounted. Bash access is safe because commands run inside the container, not on your host. **Built for the individual user.** NanoClaw isn't a monolithic framework; it's software that fits each user's exact needs. Instead of becoming bloatware, NanoClaw is designed to be bespoke. You make your own fork and have Claude Code m ``` --- **Machine-readable endpoints** - JSON: [`/api/graphcanon/tools/nanocoai-nanoclaw`](/api/graphcanon/tools/nanocoai-nanoclaw) - LLM index: [/llms.txt](/llms.txt) - Full corpus: [/llms-full.txt](/llms-full.txt) _GraphCanon - The knowledge graph for AI development. https://www.graphcanon.com/_