selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

nanoclaw logo

Self-host nanoclaw

v2026.10.0

Chat-based AI agent with per-session container isolation

ReleaseOpen SourceMIT
Updatedlast month
LanguageTypescript
Setup difficultyModerate
Stars
31 118
RAM
4 GB+
Port
3000 (Local webhook server (WEBHOOK_PORT))
Install with Linux
nanoclaw screenshot 1nanoclaw screenshot 2

What is nanoclaw?

Should you self-host nanoclaw?

nanoclaw scores 77/100 on selfhost.directory (how scoring works) and ranks #9 of 120 in AI Assistant. It has 31 118 GitHub stars, +187 in the last 30 days.

It shipped 9 stable releases in the past year. The latest, v2026.10.0, came out on 9 October 2026. New versions land roughly every 2 weeks.

Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is AstrBot (88/100, 47 009 stars). It scores higher overall, so compare the two before you pick. See nanoclaw vs AstrBot side by side.

Features

  • Admin CLI
  • Agent templates
  • Background service install
  • Credential gateway (no raw API keys in agents)
  • Customization by code change
  • Egress LockdownOff by default (NANOCLAW_EGRESS_LOCKDOWN=false).
  • Multi-agent Teams
  • Multi-channel chat integrationAdapters live on the `channels` branch and are copied into your fork with /add-<channel> skills.
  • Multiple model providers
  • Per-agent memory and workspace
  • Per-group container config
  • Per-session container isolation
  • Scheduled Tasks
  • Terminal CLI channel
  • Web search and page fetch

nanoclaw README

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


How to install nanoclaw

Install nanoclaw with Linux

Environment variables
ASSISTANT_NAME, DEFAULT_AGENT_PROVIDER, TZ, LOG_LEVEL, WEBHOOK_PORT

git clone https://github.com/nanocoai/nanoclaw.git nanoclaw-v2 cd nanoclaw-v2 bash nanoclaw.sh

Runs as a systemd user service (or a nohup wrapper when systemd is unavailable); the wizard installs Docker Engine if missing.

How to configure nanoclaw

  • ASSISTANT_NAMEAndyAssistant name. Also sets the default trigger, `@<name>`.
  • ASSISTANT_HAS_OWN_NUMBERfalseSet `true` when the assistant runs on its own WhatsApp number instead of yours.
  • ONECLI_URLURL of the OneCLI Agent Vault. Read only when the OneCLI gateway is installed.
  • ONECLI_API_KEYAPI key for the vault. Read only when the OneCLI gateway is installed. See Credentials.
  • TZsystem timezone, else UTCIANA timezone for scheduled tasks and timestamps. Invalid values are skipped, not errored. Injected into every agent container at spawn.

nanoclaw releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

Is NanoClaw open source?

Yes, fully open source under MIT, with the whole codebase on GitHub and forking/customization actively encouraged.

How does NanoClaw compare to other AI agent frameworks?

It targets people who want an assistant they own and control: one Node.js host coordinating isolated per-session Docker containers, Claude by default, with Codex, OpenCode or local Ollama configurable per agent group.

How do I set up and configure NanoClaw?

Clone the repository and run bash nanoclaw.sh, which prepares Docker and the credential vault, asks which provider powers the first agent, and pairs a channel. Later changes are applied through repository skills.

Can I run NanoClaw on Linux or Windows?

Yes; on Windows it runs inside WSL2. You bring git and a provider credential, and the script installs Node.js, pnpm, Docker and OneCLI when missing.

What container runtimes are supported?

Docker only, on macOS, Linux and Windows through WSL2.

What messaging apps does NanoClaw support?

A long list including WhatsApp, Telegram, Discord, Slack, Teams, Signal, iMessage, Matrix, Mattermost, Google Chat and email via Resend; each adapter is installed on demand with a skill.

Is NanoClaw free?

The software is free under MIT; you only pay your model provider. Claude takes an API key or a subscription, Codex a ChatGPT subscription or OpenAI key, and local Ollama models avoid hosted-model bills.

Do I need to know how to code to use NanoClaw?

No - the installer handles dependencies, credentials, containers and channel pairing, though comfort with a terminal and git clone is expected.

Is NanoClaw secure?

Each session runs in its own unprivileged container and only sees the files you mount; credentials stay in the gateway. Egress lockdown, mount rules, sender policies and approvals narrow it further.

How is NanoClaw different from OpenClaw?

NanoClaw keeps a single Node.js host process with an auditable codebase and puts every active session behind OS-level container isolation, with channels and providers installed as skills.

What is NanoClaw?

A lightweight open-source personal AI agent that runs on your own machine, connects to the messaging apps you pick, and executes each session inside an isolated Docker container.

More in AI Assistant

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…