campaign Aankondigingen

info Introductie

NanoClaw is een lichtgewicht, volledig autonome persoonlijke AI-assistent gebouwd op de Anthropic Claude Agent SDK. Agents draaien in geïsoleerde Linux-containers (Apple Container op macOS, Docker op Linux/macOS). WhatsApp ingebouwd, andere kanalen via skills. Persistent SQLite-geheugen, geplande taken, webtoegang en agent-zwermen.

download Installatie

NanoClaw is een TypeScript-project. Kloon de repo en installeer met 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

Snelle configuratie (aanbevolen)

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

Handmatig bouwen & installeren

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

Dev-terugval: voer 'npm run dev' uit voor ontwikkelmodus met hot reload.

rocket_launch Snelstart

Voer de onboarding eenmalig uit om je configuratie in te stellen en begin dan met chatten.

# 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

Configuratie gebeurt door de broncode direct te bewerken. API-sleutels gaan in .env, kanaalconfiguratie in src/index.ts.

terminal Commando's

NanoClaw gebruikt npm-scripts voor elke workflow.

forum Kanalen

WhatsApp is het ingebouwde kanaal (via Baileys-bibliotheek). Andere kanalen — Telegram, Discord, Slack — kunnen worden toegevoegd via Claude Code-skills (/add-telegram, /add-discord, /add-slack). Elke groep krijgt een eigen geïsoleerde container en CLAUDE.md-geheugen.

# 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

Tip: Voer /add-telegram of /add-discord uit in Claude Code om meer kanalen toe te voegen. Skills passen de broncode van je fork direct aan.

build Tools

Tools zijn mogelijkheden die de agent kan aanroepen tijdens een gesprek. Alle ingebouwde tools zijn standaard gesandboxed en werkruimtegebonden.

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

NanoClaw gebruikt SQLite (better-sqlite3) voor persistente opslag — berichten, groepen, sessies en geplande taken. Elke groep heeft ook een eigen CLAUDE.md-bestand voor geheugen per groep, gemount in de 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 Configuratie

NanoClaw gebruikt geen configuratiebestanden. Om wijzigingen aan te brengen, vertel Claude Code wat je wilt. De codebase is klein genoeg zodat Claude het veilig kan aanpassen. API-sleutels gaan in .env, al het andere staat in de broncode.

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

NanoClaw draait uitsluitend op de Anthropic Claude Agent SDK. Claude Code draait in elke container en biedt alle AI-mogelijkheden.

NanoClaw is bewust ontworpen voor één aanbieder. De Claude Agent SDK regelt modelselectie intern. Stel ANTHROPIC_API_KEY in via .env of authenticeer via Claude Code OAuth.

key Omgevingsvariabelen

Omgevingsvariabelen geconfigureerd in je lokale .env-bestand. Geheimen worden op aanvraag gelezen en nooit 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 Beveiliging

Agents draaien in containers, niet achter rechtencontroles op applicatieniveau. Ze hebben alleen toegang tot expliciet gemounte mappen.

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

Eén Node.js-proces. Agents voeren uit in geïsoleerde Linux-containers met bestandssysteemisolatie. Berichtenwachtrij per groep met gelijktijdigheidscontrole. IPC via bestandssysteem.

code Ontwikkeling

Standaard TypeScript/Node.js-workflow. Voer 'npm run dev' uit voor ontwikkeling met 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 Documentatiehub

Raadpleeg de docs-map in de officiële repository voor uitgebreide documentatie.

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