campaign Ankündigungen

info Einführung

NanoClaw ist ein schlanker, vollständig autonomer persönlicher KI-Assistent, der auf dem Anthropic Claude Agent SDK basiert. Agenten laufen in isolierten Linux-Containern (Apple Container auf macOS, Docker auf Linux/macOS). WhatsApp integriert, weitere Kanäle über Skills. Dauerhafter SQLite-Speicher, geplante Aufgaben, Webzugriff und Agenten-Schwärme.

download Installation

NanoClaw ist ein TypeScript-Projekt. Klonen Sie das Repository und installieren Sie mit 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

Schnelleinrichtung (Empfohlen)

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

Manuelles Erstellen & Installieren

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

Entwickler-Alternative: 'npm run dev' für den Entwicklungsmodus mit automatischem Neuladen ausführen.

rocket_launch Schnellstart

Führen Sie die Einrichtung einmal aus, um Ihre Konfiguration vorzunehmen, dann können Sie loschatten.

# 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

Die Konfiguration erfolgt durch direkte Bearbeitung des Quellcodes. API-Schlüssel gehören in .env, Kanalkonfiguration in src/index.ts.

terminal Befehle

NanoClaw verwendet npm-Skripte für jeden Arbeitsablauf.

forum Kanäle

WhatsApp ist der integrierte Kanal (über die Baileys-Bibliothek). Weitere Kanäle — Telegram, Discord, Slack — können über Claude Code Skills hinzugefügt werden (/add-telegram, /add-discord, /add-slack). Jede Gruppe erhält ihren eigenen isolierten Container und CLAUDE.md-Speicher.

# 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

Tipp: Führen Sie /add-telegram oder /add-discord in Claude Code aus, um weitere Kanäle hinzuzufügen. Skills ändern den Quellcode Ihres Forks direkt.

build Werkzeuge

Werkzeuge sind Fähigkeiten, die der Agent während einer Konversation aufrufen kann. Alle integrierten Werkzeuge sind standardmäßig in einer Sandbox und auf den Arbeitsbereich beschränkt.

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

NanoClaw verwendet SQLite (better-sqlite3) für dauerhafte Speicherung — Nachrichten, Gruppen, Sitzungen und geplante Aufgaben. Jede Gruppe hat außerdem ihre eigene CLAUDE.md-Datei für gruppenspezifischen Speicher, der in ihren Container eingebunden wird.

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

NanoClaw verwendet keine Konfigurationsdateien. Um Änderungen vorzunehmen, sagen Sie Claude Code, was Sie möchten. Die Codebasis ist klein genug, damit Claude sie sicher ändern kann. API-Schlüssel gehören in .env, alles andere steht im Quellcode.

# 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 KI-Anbieter

NanoClaw läuft ausschließlich auf dem Anthropic Claude Agent SDK. Claude Code läuft in jedem Container und stellt alle KI-Fähigkeiten bereit.

NanoClaw ist als Einzelanbieter-System konzipiert. Das Claude Agent SDK verwaltet die Modellauswahl intern. Setzen Sie ANTHROPIC_API_KEY in .env oder authentifizieren Sie sich über Claude Code OAuth.

key Umgebungsvariablen

Umgebungsvariablen, die in Ihrer lokalen .env-Datei konfiguriert werden. Geheimnisse werden bei Bedarf gelesen und nie in process.env geladen.

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

Agenten laufen in Containern, nicht hinter Berechtigungsprüfungen auf Anwendungsebene. Sie können nur auf explizit eingebundene Verzeichnisse zugreifen.

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

Einzelner Node.js-Prozess. Agenten werden in isolierten Linux-Containern mit Dateisystem-Isolation ausgeführt. Nachrichtenwarteschlange pro Gruppe mit Nebenläufigkeitskontrolle. IPC über Dateisystem.

code Entwicklung

Standard TypeScript/Node.js-Arbeitsablauf. Führen Sie 'npm run dev' für die Entwicklung mit automatischem Neuladen aus.

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

Für ausführliche Dokumentation verweisen wir auf das docs-Verzeichnis im offiziellen Repository.

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