NanoClaw avec Venice | Documentation de l'API Venice

NanoClaw est un assistant IA léger et auto-hébergé qui fonctionne sur WhatsApp et Telegram. Ce fork ajoute la prise en charge de Venice AI afin que tout s’exécute en privé, sans abonnement Anthropic.

Paiement à l'usage

Pas d’abonnement. Payez uniquement ce que vous utilisez

Inférence privée

Zéro rétention de données sur les serveurs Venice

Isolation Docker

Chaque chat s’exécute dans son propre conteneur sécurisé

Pourquoi Venice AI ?

Venice est une plateforme IA orientée confidentialité. Ils ne stockent ni ne journalisent aucun prompt ou réponse sur leurs serveurs — vos conversations existent uniquement sur votre appareil. Les requêtes sont chiffrées de bout en bout à travers leur proxy vers des fournisseurs GPU décentralisés, sans aucune rétention de données. Cela signifie que les conversations avec votre assistant IA restent privées, même vis-à-vis de Venice elle-même. Venice fournit un accès anonymisé à des modèles de pointe (Claude Opus, Claude Sonnet) et un accès entièrement privé aux modèles open source (GLM, Qwen) via une seule API — basculez entre eux à tout moment.

	Venice AI	Fournisseurs d’IA traditionnels
Rétention des données	Aucune — zéro log	Oui
Confidentialité des prompts	Chiffrés, jamais stockés	Stockés sur les serveurs du fournisseur
Modèles open source	Oui (GLM, Qwen, et plus)	Non
Modèles de pointe	Claude, GPT et autres — anonymement	Uniquement via abonnements directs
Tarification	Paiement au token, sans abonnement. Ou stakez du DIEM pour des crédits quotidiens renouvelés	Abonnements à 20-200 $/mois ou API au token
Inférence non censurée	Oui (modèles open source)	Non

Pourquoi NanoClaw ?

NanoClaw est une alternative épurée et minimale aux plateformes plus volumineuses comme OpenClaw. Elle est conçue pour une personne exploitant un bot.

	NanoClaw (Venice)	OpenClaw
Codebase	~2 000 lignes, une poignée de fichiers	~500 000 lignes, 53 fichiers de config
Dépendances	~15 paquets	70+ paquets
Modèle de sécurité	Isolation de conteneur Docker au niveau OS	Allowlists et codes d’appairage au niveau applicatif
Isolation par groupe	Chaque groupe a son propre conteneur, système de fichiers et mémoire	Processus partagé, mémoire partagée
Installation	Un assistant (`/setup`), ~10 minutes	Configuration manuelle en plusieurs étapes
Fournisseur IA	Venice AI (privé, sans abonnement)	Anthropic (nécessite une clé API ou un abonnement)
Personnalisation	Modifiez le code directement — il est assez petit pour être lu	Fichiers de config et plugins
Utilisateur cible	Une personne, un bot	Plateforme multi-utilisateurs

Ce que vous obtenez

Un assistant IA personnel sur Telegram et/ou WhatsApp
Propulsé par Venice AI — pas besoin de compte Anthropic
Le bot s’exécute dans un conteneur Docker isolé (sandboxé, ne peut pas accéder à votre système)
Changement de modèle — dites au bot « switch to zai-org-glm-5 » ou « use opus » à tout moment
Tâches planifiées — définissez des rappels, des tâches récurrentes
Recherche et navigation web intégrées
Formatage Markdown dans les messages Telegram

Prérequis

Node.js 20+

Vérifiez avec node --version

Docker

Installez et ouvrez-le une fois pour qu’il tourne

CLI Claude Code

Vérifiez avec claude --version

Clé API Venice

Générez-la depuis votre compte Venice

Pour Telegram (recommandé pour la première utilisation) :

Ouvrez Telegram et cherchez @BotFather
Envoyez /newbot et suivez les instructions
Conservez le token que BotFather vous donne (ressemble à 123456789:ABCdef...)

Pour WhatsApp — utilisez un numéro virtuel, PAS votre numéro personnel :NanoClaw se connecte comme appareil lié sur votre numéro WhatsApp. Cela signifie que l’agent peut voir chaque message entrant et sortant — toutes vos conversations personnelles, conversations de groupe, photos, tout. Votre téléphone continue de fonctionner normalement, mais le bot a une visibilité totale sur l’ensemble de votre compte WhatsApp.Utilisez plutôt un numéro de téléphone virtuel. Ces applications vous donnent un deuxième numéro que vous pouvez entièrement dédier au bot :

App	Prix	Notes
Hushed	~5 $/mois	Fiable, fonctionne bien pour la vérification WhatsApp
Burner	~5 $/mois	Similaire à Hushed, numéros jetables
Google Voice	Gratuit	États-Unis uniquement, peut ne pas fonctionner pour la vérification WhatsApp dans tous les cas

Comment le configurer :

Obtenez un numéro virtuel via l’une des apps ci-dessus
Installez WhatsApp sur un deuxième appareil (vieux téléphone, tablette ou émulateur) en utilisant ce numéro virtuel
Pendant l’installation de NanoClaw, scannez le QR code avec ce second appareil — pas avec votre téléphone personnel

Installation

L’installation prend environ 10 minutes. Vous n’avez besoin que d’une seule fenêtre Terminal.

Cloner et installer

Ouvrez Terminal et exécutez :

git clone https://github.com/lorenzovenice/nanoclaw-venice.git
cd nanoclaw-venice
npm install

Attendez que npm install se termine sans erreurs.

Lancer Claude Code avec Venice

Remplacez your-key par votre clé API Venice et exécutez :

VENICE_API_KEY=your-key npm run venice

Cela démarre le proxy Venice et lance Claude Code à travers lui en une seule commande.

Claude Code utilise par défaut GLM 5 (zai-org-glm-5) pour limiter les coûts d’installation. Après installation, tapez /model dans Claude Code pour basculer vers claude-sonnet-4-6 ou claude-opus-4-6 pour de meilleures performances.

Si l’on vous demande « Do you want to use this API key? » — sélectionnez Yes.

Lancer l'assistant d'installation

Dans votre terminal Claude Code, tapez :

/setup

L’assistant vous guide à travers :

Bootstrap — vérifie Node.js et les dépendances
Clé API Venice — valide et enregistre votre clé
Choix du canal — sélectionnez WhatsApp, Telegram ou les deux
Build du conteneur — construit le conteneur Docker (prend quelques minutes la première fois)
Auth WhatsApp — scannez le QR code avec votre téléphone (si applicable)
Configuration Telegram — envoyez un message à votre bot pour qu’il détecte votre chat
Mot déclencheur — préfixe qui active le bot (par défaut : @Andy)
Répertoires montés — choisissez « No » pour l’instant (vous pouvez ajouter l’accès aux fichiers plus tard)
Démarrer les services — NanoClaw et le proxy Venice démarrent tous deux comme services en arrière-plan

L’assistant installe deux services en arrière-plan :

NanoClaw — le bot lui-même
Venice proxy — un petit serveur local (localhost:4001) qui traduit entre Claude Code et Venice AI

Tous deux démarrent automatiquement au boot et se redémarrent eux-mêmes en cas de crash.

Si l’assistant s’arrête entre les étapes, tapez « continue » ou « next step » pour le pousser en avant.

Commencer à discuter

Une fois l’installation terminée, ouvrez votre chat (Telegram ou WhatsApp) et envoyez :

@Andy hello, are you there?

Le bot devrait répondre en quelques secondes. Dans votre canal principal, vous pouvez taper normalement sans le préfixe @Andy.Vous pouvez maintenant fermer la fenêtre du terminal. Tout s’exécute comme services en arrière-plan et démarre automatiquement au démarrage de votre ordinateur.

Comment ça marche

Il y a deux couches dans NanoClaw :

Couche	Ce qu’elle fait
CLI Claude Code	Outil d’admin pour l’installation, le débogage et la personnalisation
Le bot	IA dans votre chat, s’exécutant à l’intérieur d’un conteneur Docker isolé

Pour ouvrir Claude Code à tout moment :

cd nanoclaw-venice
ANTHROPIC_BASE_URL=http://localhost:4001 ANTHROPIC_API_KEY=venice-proxy claude

Utilisez-le pour exécuter /setup, /debug, /customize, ou pour modifier le comportement du bot.

Modèles

Contexte	Modèle par défaut	Comment changer
Bot (en chat)	`claude-sonnet-4-6`	Dites au bot : « switch to opus » ou « use zai-org-glm-5 »
CLI Claude Code	`zai-org-glm-5` (GLM 5)	Utilisez `/model` dans Claude Code ou `claude --model <name>`

La CLI utilise par défaut GLM 5 pour limiter les coûts d’installation. Après installation, basculez vers claude-sonnet-4-6 ou claude-opus-4-6 pour de meilleures performances.

Consultez le catalogue de modèles pour tous les modèles Venice disponibles.

Dépannage

Le proxy n'est pas en cours d'exécution

Le proxy Venice s’exécute comme un service en arrière-plan et se redémarre automatiquement. S’il ne fonctionne pas :macOS :

# Vérifier qu'il tourne
launchctl list | grep venice-proxy

# Le redémarrer
launchctl kickstart -k gui/$(id -u)/com.nanoclaw.venice-proxy

# Consulter les logs
tail -f ~/nanoclaw-venice/logs/venice-proxy.log

Linux :

# Vérifier qu'il tourne
systemctl --user status nanoclaw-venice-proxy

# Le redémarrer
systemctl --user restart nanoclaw-venice-proxy

# Consulter les logs
tail -f ~/nanoclaw-venice/logs/venice-proxy.log

Cela signifie que Claude Code ne peut pas se connecter au proxy Venice.

Vérifiez que le proxy tourne. Voir l’étape de dépannage ci-dessus.
Assurez-vous d’être dans le bon dossier. Toujours cd nanoclaw-venice en premier.

Repartez à zéro : Fermez tous les terminaux et exécutez :

cd nanoclaw-venice
ANTHROPIC_BASE_URL=http://localhost:4001 ANTHROPIC_API_KEY=venice-proxy claude

Erreurs de modèle ('model does not exist')

Redémarrez le proxy et le bot :macOS :

# Redémarrer le proxy
launchctl kickstart -k gui/$(id -u)/com.nanoclaw.venice-proxy

# Redémarrer le bot
launchctl kickstart -k gui/$(id -u)/com.nanoclaw

Linux :

# Redémarrer le proxy
systemctl --user restart nanoclaw-venice-proxy

# Redémarrer le bot
systemctl --user restart nanoclaw

Vérifiez les modèles disponibles dans le catalogue de modèles.

Le bot ne répond pas aux messages

Parcourez ces étapes dans l’ordre :

Vérifiez votre mot déclencheur. Assurez-vous d’utiliser le bon préfixe (par ex. @Andy hello).
Vérifiez que Docker tourne. Exécutez docker info — s’il erre, ouvrez Docker Desktop.
Vérifiez que le proxy tourne. Voir « Le proxy n’est pas en cours d’exécution » ci-dessus.
Consultez les logs : tail -f logs/nanoclaw.log dans le dossier du projet.
Consultez les logs du conteneur. Ouvrez le dossier nanoclaw-venice/groups/main/logs/. Ouvrez le fichier le plus récent qui commence par container-.
Redémarrez tout : Redémarrez le proxy et le bot (voir ci-dessus).

Le build du conteneur échoue pendant l'installation

Assurez-vous que Docker Desktop est ouvert et en cours d’exécution. Attendez 10 secondes que Docker démarre complètement, puis tapez continue dans l’assistant pour réessayer.

WhatsApp déconnecté

Votre session WhatsApp peut expirer. Pour vous reconnecter :

cd nanoclaw-venice
npm run auth

Scannez le QR code avec WhatsApp (Paramètres → Appareils liés → Lier un appareil), puis redémarrez le bot :

macOS : launchctl kickstart -k gui/$(id -u)/com.nanoclaw
Linux : systemctl --user restart nanoclaw

Avancé

Donner au bot accès à des fichiers de votre ordinateur

Par défaut, le bot est complètement isolé de votre ordinateur — il ne peut voir que sa propre mémoire et son historique de conversation.

Pendant l’installation : Lorsqu’on vous interroge sur l’accès aux répertoires, choisissez « Yes »
Après l’installation : Exécutez /customize dans Claude Code

Démarrer/arrêter le bot manuellement

NanoClaw exécute deux services en arrière-plan qui démarrent automatiquement au boot.macOS :

Action	Commande
Démarrer le bot	`launchctl load ~/Library/LaunchAgents/com.nanoclaw.plist`
Arrêter le bot	`launchctl unload ~/Library/LaunchAgents/com.nanoclaw.plist`
Redémarrer le bot	`launchctl kickstart -k gui/$(id -u)/com.nanoclaw`
Démarrer le proxy	`launchctl load ~/Library/LaunchAgents/com.nanoclaw.venice-proxy.plist`
Arrêter le proxy	`launchctl unload ~/Library/LaunchAgents/com.nanoclaw.venice-proxy.plist`
Redémarrer le proxy	`launchctl kickstart -k gui/$(id -u)/com.nanoclaw.venice-proxy`

Linux :

Action	Commande
Démarrer le bot	`systemctl --user start nanoclaw`
Arrêter le bot	`systemctl --user stop nanoclaw`
Redémarrer le bot	`systemctl --user restart nanoclaw`
Démarrer le proxy	`systemctl --user start nanoclaw-venice-proxy`
Arrêter le proxy	`systemctl --user stop nanoclaw-venice-proxy`
Redémarrer le proxy	`systemctl --user restart nanoclaw-venice-proxy`

Utiliser Claude Code via Venice (sans bot)

Si vous voulez juste Claude Code avec Venice et n’avez pas besoin de WhatsApp/Telegram, le service proxy doit tourner. Si vous avez déjà exécuté /setup, il tourne déjà comme service en arrière-plan.

cd nanoclaw-venice
ANTHROPIC_BASE_URL=http://localhost:4001 ANTHROPIC_API_KEY=venice-proxy claude

Astuce : Ajoutez ceci à votre ~/.zshrc (ou ~/.bashrc) pour pouvoir basculer rapidement n’importe quel terminal sur Venice :

alias venice='export ANTHROPIC_BASE_URL=http://localhost:4001 && export ANTHROPIC_API_KEY=venice-proxy && echo "Using Venice API"'
alias anthropic='unset ANTHROPIC_BASE_URL && unset ANTHROPIC_API_KEY && echo "Using Anthropic API"'

Ensuite, tapez simplement venice dans n’importe quel terminal avant d’exécuter claude pour utiliser Venice, ou anthropic pour revenir en arrière.

Exécuter plusieurs bots

Vous pouvez exécuter plusieurs bots NanoClaw sur la même machine (par ex. un pour usage personnel et un pour une équipe). Clonez simplement le dépôt dans un dossier différent et relancez l’installation. Note : ils partagent la même image Docker, donc reconstruire l’un affecte tous les autres.

Commandes développeur

Pour les personnes qui veulent modifier le code de NanoClaw :

npm run dev          # Démarrer proxy + NanoClaw avec hot reload
npm run proxy        # Démarrer uniquement le proxy Venice
npm run build        # Compiler le TypeScript
npm test             # Exécuter les tests
./container/build.sh # Reconstruire le conteneur de l'agent

Architecture

Vous (WhatsApp/Telegram)
        ↓
   NanoClaw (Node.js)
        ↓
   Conteneur Docker (sandbox isolé)
        ↓
   Proxy Venice (localhost:4001)
        ↓
   api.venice.ai (inférence privée)

Fichier	Objectif
`proxy/venice-proxy.ts`	Traduit le format Anthropic vers le format OpenAI pour Venice
`src/index.ts`	Orchestrateur principal — boucle de messages, invocation d’agent
`src/channels/whatsapp.ts`	Connexion WhatsApp via baileys
`src/channels/telegram.ts`	Bot Telegram via grammy
`src/container-runner.ts`	Lance des conteneurs d’agents isolés

FAQ

Pourquoi ai-je besoin d'un proxy ?

Le Claude Agent SDK parle le format de messages d’Anthropic. Venice parle le format d’OpenAI. Le proxy fait la traduction entre les deux afin que tout fonctionne sans modifier le SDK.

Puis-je utiliser des modèles open source ?

Oui. Venice héberge de nombreux modèles. Dites au bot « switch to zai-org-glm-5 » ou n’importe quel ID de modèle Venice. Consultez le catalogue de modèles.

Est-ce sécurisé ?

Les agents s’exécutent dans des conteneurs Docker avec une véritable isolation au niveau OS. La clé API Venice est transmise via stdin, jamais écrite sur disque à l’intérieur des conteneurs. Chaque groupe a son propre environnement isolé.

Ai-je besoin d'un abonnement Anthropic ?

Non. Tout passe par Venice AI. Vous n’avez besoin que d’une clé API Venice.

Puis-je l'utiliser sur un serveur ?

Oui. Cela fonctionne sur n’importe quelle machine Linux avec Docker. Utilisez le service systemd pour un démarrage automatique au boot.

Ressources

Dépôt NanoClaw Venice

Code source et README complet

NanoClaw original

Projet en amont par qwibitai

Catalogue de modèles Venice

Parcourir les modèles disponibles

Confidentialité Venice

Comment Venice protège vos données

Guides

Getting Started

Text & Chat

Image & Video

Agents & Integrations

Agent Tooling

Coding Tools

SDKs & Frameworks

Projects

NanoClaw

Paiement à l'usage

Inférence privée

Isolation Docker

Pourquoi Venice AI ?

Pourquoi NanoClaw ?

Ce que vous obtenez

Prérequis

Node.js 20+

Docker

CLI Claude Code

Clé API Venice

Installation

Comment ça marche

Modèles

Dépannage

Avancé

Architecture

FAQ

Ressources

Dépôt NanoClaw Venice

NanoClaw original

Catalogue de modèles Venice

Confidentialité Venice

Paiement à l'usage

Inférence privée

Isolation Docker

​Pourquoi Venice AI ?

​Pourquoi NanoClaw ?

​Ce que vous obtenez

​Prérequis

Node.js 20+

Docker

CLI Claude Code

Clé API Venice

​Installation

​Comment ça marche

​Modèles

​Dépannage

​Avancé

​Architecture

​FAQ

​Ressources

Dépôt NanoClaw Venice

NanoClaw original

Catalogue de modèles Venice

Confidentialité Venice

Pourquoi Venice AI ?

Pourquoi NanoClaw ?

Ce que vous obtenez

Prérequis

Installation

Comment ça marche

Modèles

Dépannage

Avancé

Architecture

FAQ

Ressources