NanoClaw

by NanoCoAgentGet updates sent to me

Runs a personal Claude agent you message from WhatsApp, Telegram, Slack and more

About NanoClaw

NanoClaw is a small open-source personal AI assistant you message from WhatsApp, Telegram, Slack and similar apps. Each agent runs in its own Docker container and sees only the folders you allow.

For Technical usersPeople who self-hostClaude Code users

Made by NanoCo

NanoCo is the company that maintains NanoClaw, which is open source under the MIT licence. Its GitHub profile describes it as building AI-native infrastructure.

Stars: ★ 31k
License: MIT
Cost: Usage-based
Platforms: Mac · Linux · Win
Level: Advanced

Overview

NanoClaw is a small, open-source personal assistant that you message from chat apps such as WhatsApp, Telegram, Slack, Discord or iMessage. Each agent runs in its own Docker container and sees only the folders you allow, with its own memory and scheduled tasks, such as a weekday briefing. It uses Claude through Claude Code by default, and other model providers can be added. A setup script installs what it needs, and you change its behaviour by asking Claude Code to edit the code. It suits technical users who want a self-hosted assistant they can read and change.

Its codebase is small enough to read, and each agent works inside its own container instead of on your whole computer.

Try these first

Start with the first one: it is a small task you can check easily.

@Andy which folders can you see? List them and don't change anything.First try · read-only
@Andy every Monday at 8am, collect news about [topic] and message me a briefing.sends messages
@Andy list all scheduled tasks across groups.
In Claude Code: change the trigger word to @Bob.edits code

Example prompts written by Agent Flows Hub.

Features

From the creator's documentation.

Feature	What it does	Runs
Chat channels	WhatsApp, Telegram, Discord, Slack, iMessage and more, each added with an /add- skill	Your chat accounts
Container isolation	Each agent runs in its own Docker container and sees only the folders you allow	Your computer
Scheduled tasks	Recurring jobs the agent runs and reports back on	Your computer
Memory	Each agent group keeps its own instructions and memory	Your computer
Web access	Searches and fetches content from the web	Internet
Models	Claude by default; Codex, OpenCode, Cursor or Ollama can be added	Provider API

Good to know

Run a personal assistant on your own machine that you reach from a chat app, for jobs such as a weekday briefing or a weekly summary. Each agent group works in its own container with only the folders you mount.

Limits

Setup needs Docker, Claude Code and an Anthropic credential, and may install Homebrew, Node.js, pnpm and OneCLI's credential gateway. Each chat app is added separately with an /add- skill in Claude Code.
There is no settings screen: changes are code edits that Claude Code makes in your copy of NanoClaw.

Notes by Agent Flows Hub (original project name: NanoClaw), written from the creator's documentation, not from running it ourselves. NanoClaw: README, requirements and quick start · NanoClaw documentation

Stuck setting it up?

Tell us what happened. We take a look first; if it needs paid work, you get an estimate before anything starts.

Get help

How to start

Install itPaste the install request into an AI agent you already use, or run the official command yourself or follow the official guide.macOS, Linux, Windowsgit clone https://github.com/nanocoai/nanoclaw.git nanoclaw-v2 cd nanoclaw-v2 bash nanoclaw.sh
Set it upFollow the first-run steps in the official guide.
Give it a first taskAfter setup, pair the local CLI channel and ask the agent which folders it can see. Confirm it lists only what you mounted before connecting a chat app.

Steps follow the creator's instructions. The request tells your agent to read them first and wait for your OK.

Before you start

A computer with macOS, Linux or Windows.
macOS or Linux; on Windows, WSL2
Docker Desktop or Docker Engine
Claude Code installed, and an Anthropic credential for Claude
Setup may also install Node.js, pnpm and OneCLI's credential gateway
Pay per use. The AI service it calls charges for what you use.

Details

Made by: NanoCo
License: MIT Terms
Platforms: macOS, Linux, Windows
Runs on: Your computer, Self-hosted server

View source Official docs Report a problem

For AI agents

This page as a Markdown install brief:

/en/library/nanoclaw/install.md

Other agents

nanoMuse Gives you a personal AI agent on your phone and computer that works through your apps
Notion AI Writes, searches and does multi-step work across your Notion pages and connected apps
Octop Runs your own team of AI assistants that you can reach from WeChat, Feishu or the web
OhMyGame Turns a game idea into art, code and a playable web game you can share by link
OpenClaw Lets you message an AI assistant on WhatsApp, Telegram or Slack that runs on your computer
OpenCode Lets you hand coding tasks to an open source AI agent that works with many model providers

See all 61 agents · Install your first AI agent

GitHub