campaign Annunci

info Introduzione

NanoClaw è un assistente IA personale leggero e completamente autonomo basato su Anthropic Claude Agent SDK. Gli agenti operano in container Linux isolati (Apple Container su macOS, Docker su Linux/macOS). WhatsApp integrato, altri canali tramite skill. Memoria persistente SQLite, attività pianificate, accesso web e sciami di agenti.

download Installazione

NanoClaw è un progetto TypeScript. Clona il repository e installa con npm.

npm / CLI di Claude

# macOS / Linux — clone and setup
git clone https://github.com/qwibitai/NanoClaw.git
cd NanoClaw
claude
# Then run /setup in the Claude session

# Or install Claude CLI first:
npm install -g @anthropic-ai/claude-code

Configurazione rapida (consigliata)

git clone https://github.com/qwibitai/NanoClaw.git
cd NanoClaw
claude
# Run /setup inside the Claude session

# With environment variables pre-configured:
ANTHROPIC_API_KEY="sk-..." claude

# Quick start after setup:
npm start

Compilazione e installazione manuale

git clone https://github.com/qwibitai/NanoClaw.git
cd NanoClaw
npm install
# Edit src/index.ts to configure your settings
npm start

Alternativa per lo sviluppo: esegui 'npm run dev' per la modalità sviluppo con ricaricamento automatico.

rocket_launch Avvio rapido

Esegui l'onboarding una volta per configurare, poi inizia a chattare.

# Clone and setup
git clone https://github.com/qwibitai/NanoClaw.git
cd NanoClaw && npm install

# Run setup wizard
npm run setup

# Start NanoClaw
npm start

# Development mode (hot reload)
npm run dev

# Run tests
npm test

La configurazione avviene modificando direttamente il codice sorgente. Le chiavi API vanno nel file .env, la configurazione dei canali in src/index.ts.

terminal Comandi

NanoClaw usa script npm per ogni flusso di lavoro.

forum Canali

WhatsApp è il canale integrato (tramite libreria Baileys). Altri canali — Telegram, Discord, Slack — possono essere aggiunti tramite skill di Claude Code (/add-telegram, /add-discord, /add-slack). Ogni gruppo ha il proprio container isolato e memoria CLAUDE.md.

# WhatsApp (built-in via Baileys library)
# Run 'npm run auth' to pair via QR code
# Per-group containers with isolated CLAUDE.md memory

# Add more channels via Claude Code skills:
# /add-telegram — Telegram bot support
# /add-discord — Discord gateway support
# /add-slack — Slack Events API support

# Start the agent (connects WhatsApp)
npm start

Suggerimento: esegui /add-telegram o /add-discord in Claude Code per aggiungere altri canali. Le skill modificano direttamente il codice sorgente del tuo fork.

build Strumenti

Gli strumenti sono funzionalità che l'agente può invocare durante una conversazione. Tutti gli strumenti integrati sono sandboxed e limitati allo spazio di lavoro per impostazione predefinita.

# Built-in tools (provided by Claude Code inside containers):
# shell commands, file read/write, web search,
# web browsing (Chromium + agent-browser),
# agent delegation (swarms)

# Host-provided capabilities:
# SQLite memory, scheduled tasks (cron),
# WhatsApp messaging, IPC between host and containers

# Container image includes Chromium and agent-browser
# Apple Container on macOS, Docker on Linux

database Sistema di memoria

NanoClaw usa SQLite (better-sqlite3) per l'archiviazione persistente — messaggi, gruppi, sessioni e attività pianificate. Ogni gruppo ha anche il proprio file CLAUDE.md per la memoria per gruppo, montato nel suo container.

# SQLite database (better-sqlite3)
# Messages, groups, sessions, scheduled tasks, router state

# Per-group CLAUDE.md memory files
# Mounted into each group's container

# IPC via filesystem between host and containers
# No external database — everything is local

settings Configurazione

NanoClaw non usa file di configurazione. Per apportare modifiche, di' a Claude Code cosa vuoi. Il codice è abbastanza piccolo perché Claude possa modificarlo in sicurezza. Le chiavi API vanno nel file .env, tutto il resto è nel codice sorgente.

# NanoClaw doesn't use configuration files
# To make changes, tell Claude Code what you want

# Key files:
# src/index.ts — orchestrator, state, message loop
# src/config.ts — constants, trigger pattern, paths
# .env — API key and runtime settings

# Environment variables:
ANTHROPIC_API_KEY="sk-ant-..."
ASSISTANT_NAME="Andy"
CONTAINER_IMAGE="nanoclaw-agent:latest"

model_training Fornitori IA

NanoClaw funziona esclusivamente con Anthropic Claude Agent SDK. Claude Code opera all'interno di ogni container, fornendo tutte le funzionalità IA.

NanoClaw è a fornitore singolo per scelta progettuale. Claude Agent SDK gestisce internamente la selezione del modello. Imposta ANTHROPIC_API_KEY nel file .env o autenticati tramite Claude Code OAuth.

key Variabili d'ambiente

Variabili d'ambiente configurate nel tuo file .env locale. I segreti vengono letti su richiesta e mai caricati in process.env.

# Required
ANTHROPIC_API_KEY=sk-ant-...

# Optional
ASSISTANT_NAME=Andy
ASSISTANT_HAS_OWN_NUMBER=false
CONTAINER_IMAGE=nanoclaw-agent:latest
CONTAINER_TIMEOUT=1800000
TZ=America/New_York

shield Sicurezza

Gli agenti operano in container, non dietro controlli di permessi a livello applicativo. Possono accedere solo alle directory esplicitamente montate.

# Container isolation (Apple Container / Docker)
# Each agent runs in its own Linux container

# Secrets passed via stdin JSON, never in process.env
# Mount allowlists with symlink escape detection
# Containers run as non-root with read-only project mounts

account_tree Architettura

Singolo processo Node.js. Gli agenti operano in container Linux isolati con isolamento del filesystem. Coda messaggi per gruppo con controllo della concorrenza. IPC tramite filesystem.

code Sviluppo

Flusso di lavoro standard TypeScript/Node.js. Esegui 'npm run dev' per lo sviluppo con ricaricamento automatico.

# Clone the repo
git clone https://github.com/qwibitai/NanoClaw.git
cd NanoClaw

# Install dependencies
npm install

# Run in development mode
npm run dev

# Run tests
npm test

# Build for production
npm run build

menu_book Centro documentazione

Per la documentazione approfondita, consulta la directory docs nel repository ufficiale.

git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude