campaign Avisos

info Introdução

NanoClaw é um assistente pessoal de IA leve e totalmente autônomo, construído com o Anthropic Claude Agent SDK. Agentes rodam em containers Linux isolados (Apple Container no macOS, Docker no Linux/macOS). WhatsApp integrado, outros canais via skills. Memória persistente em SQLite, tarefas agendadas, acesso web e Enxames de Agentes.

download Instalação

NanoClaw é um projeto TypeScript. Clone o repo e instale com npm.

npm / Claude CLI

# 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

Configuração Rápida (Recomendado)

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

Build e Instalação Manual

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

Alternativa dev: execute 'npm run dev' para modo de desenvolvimento com hot reload.

rocket_launch Início Rápido

Execute o onboarding uma vez para configurar, depois comece a conversar.

# 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

A configuração é feita editando o código-fonte diretamente. Chaves de API vão no .env, configuração de canais em src/index.ts.

terminal Comandos

NanoClaw usa scripts npm para todo fluxo de trabalho.

forum Canais

WhatsApp é o canal integrado (via biblioteca Baileys). Outros canais — Telegram, Discord, Slack — podem ser adicionados via skills do Claude Code (/add-telegram, /add-discord, /add-slack). Cada grupo tem seu próprio container isolado e memória 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

Dica: Execute /add-telegram ou /add-discord no Claude Code para adicionar mais canais. Skills modificam o código-fonte do seu fork diretamente.

build Ferramentas

Ferramentas são capacidades que o agente pode invocar durante uma conversa. Todas as ferramentas integradas são sandboxed e com escopo de workspace por padrão.

# 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 de Memória

NanoClaw usa SQLite (better-sqlite3) para armazenamento persistente — mensagens, grupos, sessões e tarefas agendadas. Cada grupo também tem seu próprio arquivo CLAUDE.md para memória por grupo, montado no seu 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 Configuração

NanoClaw não usa arquivos de configuração. Para fazer alterações, diga ao Claude Code o que você quer. O código é pequeno o suficiente para o Claude modificar com segurança. Chaves de API vão no .env, todo o resto está no código-fonte.

# 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 Provedores de IA

NanoClaw roda exclusivamente no Anthropic Claude Agent SDK. O Claude Code roda dentro de cada container, fornecendo todas as capacidades de IA.

NanoClaw é de provedor único por design. O Claude Agent SDK gerencia a seleção de modelo internamente. Configure ANTHROPIC_API_KEY no .env ou autentique via Claude Code OAuth.

key Variáveis de Ambiente

Variáveis de ambiente configuradas no seu arquivo .env local. Secrets são lidos sob demanda e nunca carregados em 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 Segurança

Agentes rodam em containers, não atrás de verificações de permissão no nível da aplicação. Eles só podem acessar diretórios explicitamente montados.

# 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 Arquitetura

Processo Node.js único. Agentes executam em containers Linux isolados com isolamento de sistema de arquivos. Fila de mensagens por grupo com controle de concorrência. IPC via sistema de arquivos.

code Desenvolvimento

Fluxo de trabalho padrão TypeScript/Node.js. Execute 'npm run dev' para desenvolvimento com hot reload.

# 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 Hub de Docs

Para documentação detalhada, consulte o diretório docs no repositório oficial.

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