Guide d'installation

Lancez NanoClaw

Noyau léger en TypeScript, un seul chemin d'installation. Clonez, exécutez claude, utilisez /setup.

checklist Configuration requise

javascript Node.js

Node.js 20+ (version LTS recommandée)

computer OS

macOS ou Linux. Windows via WSL2 peut fonctionner mais n'est pas officiellement pris en charge.

memory RAM

512 Mo+ de RAM. Exécution légère, pas de compilation lourde.

hard_drive Disk

~50 Mo installé (node_modules). L'image conteneur ajoute ~500 Mo.

extension Optional

Requis : Apple Container (macOS) ou Docker (macOS/Linux). Requis : Claude Code CLI.

wifi Network

Connexion internet requise pour les appels à l'API Anthropic. Pas de mode hors ligne.

Clonez le dépôt et démarrez avec Claude CLI. Opérationnel en quelques minutes.

bolt

One-Liner

Requires Claude CLI. All platforms.

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

list_alt

Step-by-Step

Clone first, then configure. More control.

$ git clone https://github.com/qwibitai/NanoClaw.git

$ cd NanoClaw && npm install

$ # Run claude and use /setup for guided configuration

$ # Or edit .env and src/index.ts directly

verified Vérifiez votre installation

Exécutez ces commandes pour confirmer que NanoClaw est correctement installé.

$ node -e "console.log(require('./package.json').version)"

Devrait afficher le numéro de version installé.

$ npm test

Exécute la suite de tests (vitest) pour vérifier les dépendances et les fonctionnalités principales.

$ claude

Ouvre Claude Code. Exécutez /setup dans la session pour une configuration guidée.

settings Configuration initiale

Claude Code gère la configuration via /setup. Voici ce qu'il configure.

Installer les dépendances

Claude Code exécute npm install et construit l'image conteneur (nanoclaw-agent:latest) avec Chromium, agent-browser et Claude Code préinstallés.

Authentification

Définissez ANTHROPIC_API_KEY dans .env, ou authentifiez-vous via Claude Code OAuth. Les secrets sont transmis aux conteneurs à l'exécution, jamais chargés dans process.env.

Connecter WhatsApp

Exécutez 'npm run auth' pour l'appairage par QR code. WhatsApp est le canal intégré. Ajoutez Telegram, Discord ou Slack plus tard via les compétences (/add-telegram, /add-discord, /add-slack).

Démarrer l'agent

Exécutez 'npm start' pour lancer NanoClaw. Il se connecte à WhatsApp, démarre la boucle de traitement des messages et commence à traiter les messages dans des conteneurs isolés.

.env — NanoClaw n'utilise pas de fichiers de configuration. Pour apporter des modifications, dites à Claude Code ce que vous voulez. Le code est assez petit pour que Claude puisse le modifier en toute sécurité.

system_update_alt Mise à jour de NanoClaw

Maintenez NanoClaw à jour pour bénéficier des dernières fonctionnalités, intégrations et correctifs de sécurité.

Git + npm

$ cd NanoClaw && git pull && npm install

Docker

$ cd NanoClaw && git pull && docker compose up --build

Consultez le journal des modifications sur github.com/qwibitai/nanoclaw/releases pour découvrir les nouveautés de chaque version.

build Dépannage

Problèmes courants et comment les résoudre.

Besoin d'aide ?

Rejoignez notre communauté pour obtenir de l'aide à l'installation et au dépannage.

forum Rejoindre Discord menu_book Lire la documentation

hub Intégrations • article Blog • menu_book Documentation