campaign Ogłoszenia

info Wprowadzenie

NanoClaw to lekki, w pełni autonomiczny osobisty asystent AI zbudowany na Anthropic Claude Agent SDK. Agenci działają w izolowanych kontenerach Linux (Apple Container na macOS, Docker na Linux/macOS). WhatsApp wbudowany, inne kanały przez umiejętności. Trwała pamięć SQLite, zaplanowane zadania, dostęp do sieci i roje agentów.

download Instalacja

NanoClaw to projekt TypeScript. Sklonuj repozytorium i zainstaluj przez 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

Szybka konfiguracja (zalecana)

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

Ręczne budowanie i instalacja

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

Tryb deweloperski: uruchom 'npm run dev' dla trybu deweloperskiego z automatycznym przeładowaniem.

rocket_launch Szybki start

Uruchom konfigurację raz, aby ustawić parametry, a potem zacznij rozmawiać.

# 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

Konfiguracja odbywa się przez bezpośrednią edycję kodu źródłowego. Klucze API trafiają do .env, konfiguracja kanałów do src/index.ts.

terminal Polecenia

NanoClaw używa skryptów npm do każdego przepływu pracy.

forum Kanały

WhatsApp to wbudowany kanał (przez bibliotekę Baileys). Inne kanały — Telegram, Discord, Slack — można dodać przez umiejętności Claude Code (/add-telegram, /add-discord, /add-slack). Każda grupa ma własny izolowany kontener i pamięć 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

Wskazówka: Uruchom /add-telegram lub /add-discord w Claude Code, aby dodać więcej kanałów. Umiejętności bezpośrednio modyfikują kod źródłowy Twojego forka.

build Narzędzia

Narzędzia to możliwości, które agent może wywoływać podczas rozmowy. Wszystkie wbudowane narzędzia są domyślnie izolowane w piaskownicy i ograniczone do przestrzeni roboczej.

# 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 System pamięci

NanoClaw używa SQLite (better-sqlite3) do trwałego przechowywania — wiadomości, grupy, sesje i zaplanowane zadania. Każda grupa ma też własny plik CLAUDE.md jako pamięć per grupa, montowany do kontenera.

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

NanoClaw nie używa plików konfiguracyjnych. Aby wprowadzić zmiany, powiedz Claude Code, czego potrzebujesz. Kod źródłowy jest na tyle mały, że Claude może go bezpiecznie modyfikować. Klucze API trafiają do .env, wszystko inne jest w kodzie źródłowym.

# 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 Dostawcy AI

NanoClaw działa wyłącznie na Anthropic Claude Agent SDK. Claude Code działa wewnątrz każdego kontenera, zapewniając wszystkie możliwości AI.

NanoClaw z założenia korzysta z jednego dostawcy. Claude Agent SDK zarządza wyborem modelu wewnętrznie. Ustaw ANTHROPIC_API_KEY w .env lub uwierzytelnij się przez Claude Code OAuth.

key Zmienne środowiskowe

Zmienne środowiskowe konfigurowane w lokalnym pliku .env. Sekrety są odczytywane na żądanie i nigdy ładowane do 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 Bezpieczeństwo

Agenci działają w kontenerach, nie za kontrolą uprawnień na poziomie aplikacji. Mają dostęp tylko do jawnie zamontowanych katalogów.

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

Pojedynczy proces Node.js. Agenci wykonują się w izolowanych kontenerach Linux z izolacją systemu plików. Kolejka wiadomości per grupa z kontrolą współbieżności. IPC przez system plików.

code Rozwój

Standardowy przepływ pracy TypeScript/Node.js. Uruchom 'npm run dev' dla trybu deweloperskiego z automatycznym przeładowaniem.

# 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 Centrum dokumentacji

Szczegółową dokumentację znajdziesz w katalogu docs w oficjalnym repozytorium.

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