LibreAI / AI Agents / nanoclaw
// agents · nanocoai/nanoclaw

nanoclaw

A lightweight, container-isolated personal AI agent for WhatsApp, Telegram, Slack and more

★ 30.9k stars⑂ 12.8k forksMITupdated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

nanoclaw is an open-source ai agents project by nanocoai (nanocoai/nanoclaw on GitHub). It has 30,899 GitHub stars and 12,768 forks, is released under the MIT license, and was last updated on GitHub on 6 October 2026.

GitHub stars
30,899
Forks
12,768
License
MIT
Last updated on GitHub
6 October 2026
Category
AI Agents
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Decide what you want to achieve with nanoclaw and check the README on GitHub for requirements before installing.

  2. Get the code

    Clone the repository from GitHub (or take the packaged install route in step 3 if the README offers one).

  3. Install and configure

    Follow the project's documented install commands — the Run section below lists the exact ones — and add any required API keys or models.

  4. Run your first task

    Work through the README's quickstart example end to end, then adapt it to your own project or data.

// features

Why people love it

Messaging-native

Talk to your agent from WhatsApp, Telegram, Slack, Discord, iMessage or a local CLI — one agent, many channels.

Container isolation

Agents run in containers, limiting what an agent session can touch on your machine.

Memory and scheduled jobs

Persistent memory plus scheduled tasks let the agent remember context and act proactively.

Guided one-script setup

nanoclaw.sh walks a fresh machine to a named, paired agent — installing dependencies and building the container for you.

Self-healing setup

If a setup step fails, Claude Code is invoked automatically to diagnose and resume, per the README.

Skills-based customization

Extend the agent with skills and per-agent configuration rather than forking the core.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Clone NanoClaw (the README clones it as nanoclaw-v2).

    git clone https://github.com/nanocoai/nanoclaw.git
    cd nanoclaw
  2. Run the setup script

    The script installs Node, pnpm and Docker if missing, registers your Anthropic credential and builds the agent container.

    bash nanoclaw.sh
  3. Pair your first channel

    Follow the script's prompts to pair Slack, Telegram, Discord, WhatsApp, iMessage or the local CLI, then message your agent.

    # pair a channel when nanoclaw.sh prompts you, then send your agent a message
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains nanoclaw?

nanoclaw is maintained by the nanocoai organization/account on GitHub, together with open-source contributors, in the public repository nanocoai/nanoclaw.

Is nanoclaw free to use?

Yes — the code is open source under the MIT license. You can use, modify and redistribute it under that license's terms.

Does nanoclaw need a paid API key?

Yes — NanoClaw runs on Anthropic's Agents SDK, so you need an Anthropic account/credential; usage is billed by Anthropic, while NanoClaw itself is free and MIT-licensed.

How does nanoclaw compare to OpenClaw?

OpenClaw is the heavier original; NanoClaw covers a similar personal-agent job with a much smaller codebase and container isolation as the default posture.

How do I get started with nanoclaw?

Clone the repository from GitHub, follow the install commands in the Run section (taken from the project's README), and complete the documented quickstart example before adapting it to your own use case.

// keep exploring

Similar tools

AI Agents

nanobot

Ultra-lightweight, open-source, self-hosted personal AI agent framework in Python with WebUI, tools, memory, MCP, multi-agent workflows, automation, and chat…

★ 48.8k starsMIT
View guide →
AI Agents

forkd

Fork() for AI agent microVMs — spawn 100 KVM-isolated children in ~100ms from a warm parent

★ 2.9k starsApache-2.0
View guide →
AI Agents

Agent-Reach

Give your AI agent eyes on the whole internet: Twitter, Reddit, YouTube, GitHub and more, one CLI

★ 94.0k starsMIT
View guide →
AI Agents

gini-agent

Gini: a personal agent runtime that remembers, learns skills, and reaches you with the right control in time.

★ 1.9k starsMIT
View guide →
AI Agents

Talorys

Talorys — your personal AI agent in your own Cloudflare account: chat, memory, tasks, notes and scheduled routines, deployed with one command

★ 1.1k starsMIT
View guide →
AI Agents

onecli

An open-source sandboxed agent harness for teams — a secured personal agent for every employee.

★ 3.6k starsApache-2.0
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if nanoclaw is not the right fit.

Get nanoclaw

Free and open — grab the source, star the repo, and start creating.