# NanoClaw

## Docs

- [Docs updates](https://docs.nanoclaw.dev/changelog/docs-updates.md): Notable changes and improvements to the NanoClaw documentation.
- [Releases](https://docs.nanoclaw.dev/changelog/index.md): NanoClaw release history, changelog, and version-by-version feature and fix notes.
- [CLI channel](https://docs.nanoclaw.dev/channels/cli.md): Talk to your agents straight from the terminal over a local Unix socket — the only channel that ships on trunk, with zero credentials and zero setup.
- [Discord](https://docs.nanoclaw.dev/channels/discord.md): Connect NanoClaw to a Discord bot via the Chat SDK adapter — Developer Portal app, Gateway connection, and per-thread sessions.
- [iMessage](https://docs.nanoclaw.dev/channels/imessage.md): Connect NanoClaw to iMessage via the Chat SDK adapter — local mode on your own Mac with Full Disk Access, or remote mode through a Photon API server.
- [More channels](https://docs.nanoclaw.dev/channels/more-channels.md): Catalog of the ten NanoClaw channels installed conversationally with /add-<channel> — Delta Chat, Emacs, GitHub, Google Chat, Linear, Matrix, Resend, Webex, WeChat, and WhatsApp Cloud API.
- [Channels overview](https://docs.nanoclaw.dev/channels/overview.md): How NanoClaw channels work: the built-in CLI channel, the adapter catalog on the channels branch, and the /add-<channel> skills that install them.
- [Signal](https://docs.nanoclaw.dev/channels/signal.md): Connect NanoClaw to Signal via a native signal-cli adapter — QR-code device linking, a local JSON-RPC daemon, and no bot API required.
- [Slack](https://docs.nanoclaw.dev/channels/slack.md): Connect NanoClaw to a Slack workspace via the Chat SDK adapter — app creation, OAuth scopes, webhook URL, and thread sessions.
- [Microsoft Teams](https://docs.nanoclaw.dev/channels/teams.md): Connect NanoClaw to Microsoft Teams via the Chat SDK adapter — Azure app registration, bot resource, messaging endpoint, manifest sideload, and thread sessions.
- [Telegram](https://docs.nanoclaw.dev/channels/telegram.md): Connect NanoClaw to a Telegram bot via the Chat SDK adapter — BotFather token, polling mode, and code-based chat pairing.
- [WhatsApp](https://docs.nanoclaw.dev/channels/whatsapp.md): Connect NanoClaw to your personal WhatsApp with the native Baileys adapter — QR or pairing-code login, shared or dedicated number.
- [Architecture](https://docs.nanoclaw.dev/concepts/architecture.md): How NanoClaw works from the top down: a host process that routes messages between channel adapters and per-session agent containers, with SQLite files as the only transport.
- [Container lifecycle](https://docs.nanoclaw.dev/concepts/container-lifecycle.md): The full container story: how the agent image is built, what gets assembled at every spawn, how wakes are deduplicated, and what kills a container.
- [Contributing to NanoClaw](https://docs.nanoclaw.dev/concepts/contributing.md): How the nanoclaw repo is laid out, the dev loop, the three-branch model, and what kinds of contributions get accepted.
- [Entity model](https://docs.nanoclaw.dev/concepts/entity-model.md): The five entities behind every NanoClaw conversation — agent groups, messaging groups, wirings, users, and sessions — and how a message finds its way through them.
- [Isolation levels](https://docs.nanoclaw.dev/concepts/isolation-levels.md): A decision guide for how isolated your agents and conversations should be — from fully separate agent groups down to one shared conversation across channels.
- [Security model](https://docs.nanoclaw.dev/concepts/security.md): The threat model behind NanoClaw's design: assume the agent gets prompt-injected, then make sure a compromised agent has nothing to steal and nowhere to go.
- [Skills: how NanoClaw extends itself](https://docs.nanoclaw.dev/extend/overview.md): What a NanoClaw skill is in v2 — SKILL.md workflows that Claude Code executes in your checkout, fetching code additively from registry branches. Never a git merge.
- [Agent providers](https://docs.nanoclaw.dev/extend/providers.md): Swap the agent brain per group — Claude Code by default, OpenCode or Codex via provider skills, or a local Ollama model with no provider code at all.
- [Agent self-modification](https://docs.nanoclaw.dev/extend/self-modification.md): What agents can change about themselves — editing their own memory freely, and requesting packages or MCP servers through admin approval.
- [Give agents tools](https://docs.nanoclaw.dev/extend/tools.md): Two ways to add MCP tools to NanoClaw agents — install a tool skill like /add-gmail-tool, or register any MCP server yourself via the container config.
- [Writing skills](https://docs.nanoclaw.dev/extend/writing-skills.md): How to author a NanoClaw skill: SKILL.md anatomy, idempotent apply steps, REMOVE.md, registration tests, and the path from a private skill to an upstream PR.
- [Customize an agent](https://docs.nanoclaw.dev/guides/customize-an-agent.md): Hands-on tutorial: change an agent's personality through CLAUDE.local.md, swap its model and effort with ncl, and verify the changes landed.
- [Your first agent](https://docs.nanoclaw.dev/guides/first-agent.md): Hands-on tutorial: build an agent from parts with ncl — create the agent group, wire it to the CLI channel, talk to it, and inspect everything it created.
- [Build a multi-agent team](https://docs.nanoclaw.dev/guides/multi-agent-swarm.md): Hands-on tutorial: have an agent spawn a helper with create_agent, watch the approval gate, message between them, and scale the pattern to a worker/manager/supervisor trio.
- [Schedule recurring work](https://docs.nanoclaw.dev/guides/scheduled-tasks.md): Hands-on tutorial: have your agent schedule a recurring task in chat, understand what fires it, manage the series, gate frequent runs with a script, and inspect it all from the host.
- [Installation](https://docs.nanoclaw.dev/installation.md): Requirements, what the installer does under the hood, manual setup, service management, and where NanoClaw puts its files.
- [What is NanoClaw?](https://docs.nanoclaw.dev/introduction.md): A multi-agent Claude assistant. One host process, one Docker container per session, and a SQLite queue that carries every message in the system.
- [Migrate from v1 or OpenClaw](https://docs.nanoclaw.dev/migrate-from-v1.md): Move a NanoClaw v1 install to v2 with migrate-v2.sh and the /migrate-from-v1 skill, or import an OpenClaw setup with /migrate-from-openclaw.
- [Configuration](https://docs.nanoclaw.dev/operate/configuration.md): Configure a NanoClaw install — environment variables in .env and the service environment, plus per-group container config in the database.
- [Credentials](https://docs.nanoclaw.dev/operate/credentials.md): How NanoClaw keeps raw API keys out of agent containers — the OneCLI Agent Vault, credential stubs, approval cards, and the .env opt-out.
- [Hardening](https://docs.nanoclaw.dev/operate/hardening.md): Lock down a NanoClaw install — egress lockdown, the mount allowlist, sender policies, the command gate, and container resource limits.
- [The ncl admin CLI](https://docs.nanoclaw.dev/operate/ncl-cli.md): Administer a running NanoClaw host from the terminal — inspect and modify groups, wirings, users, sessions, and approvals over the ncl Unix socket.
- [Troubleshooting](https://docs.nanoclaw.dev/operate/troubleshooting.md): Diagnose NanoClaw v2 failures: host startup stops, container spawn errors, dropped messages, silent agents, and stuck sessions.
- [Upgrading](https://docs.nanoclaw.dev/operate/upgrading.md): Update NanoClaw and its skills with /update-nanoclaw and /update-skills — preview, backup, merge, validate, and restart.
- [Quick start](https://docs.nanoclaw.dev/quickstart.md): Get NanoClaw running in one command with the scripted installer.
- [Channel adapter interface](https://docs.nanoclaw.dev/reference/adapter-interface.md): The ChannelAdapter contract for building your own channel — lifecycle, delivery, registration, and the Chat SDK bridge.
- [Container configuration](https://docs.nanoclaw.dev/reference/container-config.md): Every per-group container config field — storage, defaults, spawn-time consumption, and when changes take effect.
- [Database schema](https://docs.nanoclaw.dev/reference/db-schema.md): Every table in NanoClaw's central database and the per-session inbound/outbound database pairs — columns, defaults, and intent.
- [Environment variables](https://docs.nanoclaw.dev/reference/environment-variables.md): Every environment variable NanoClaw reads — .env keys, host process environment, setup-time variables, and container-side overrides — with defaults and source locations.
- [Agent MCP tools](https://docs.nanoclaw.dev/reference/mcp-tools.md): Every MCP tool the agent can call inside its container — messaging, scheduling, interactive cards, sub-agents, and self-modification.
- [ncl CLI reference](https://docs.nanoclaw.dev/reference/ncl-cli.md): Every ncl resource, verb, flag, enum, and default — extracted from the v2 CLI registry.
- [Skills catalog](https://docs.nanoclaw.dev/reference/skills-catalog.md): Every skill that ships with NanoClaw — host-side workspace skills you invoke in Claude Code, and container skills mounted into every agent container.