Guide d'installation

Lancer ZeroClaw

Un seul binaire Rust, plusieurs méthodes d'installation. Choisissez celle qui vous convient.

checklist Configuration système requise

build Rust

Toolchain Rust (stable) via rustup.rs — uniquement nécessaire pour la compilation depuis les sources

computer OS

Linux (x86_64, aarch64, armv7), macOS (x86_64, aarch64), Windows (x86_64)

memory RAM

Runtime : <5 Mo de RAM. Compilation depuis les sources : 2 Go+ de RAM, 4 Go recommandés

hard_drive Disk

Binaire : ~8,8 Mo. Compilation depuis les sources : 6 Go d'espace libre, 10 Go recommandés

extension Optional

Optionnel : Docker (pour le runtime sandboxé), Git (pour la compilation depuis les sources)

wifi Network

Connexion internet pour les appels API IA. Les modèles locaux via Ollama fonctionnent entièrement hors ligne.

Scripts en une ligne qui font tout. Recommandé pour la plupart des utilisateurs.

bolt

Remote One-Liner

macOS / Linux. Single command.

$ curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash
rocket_launch

Local Bootstrap

Clone first, then bootstrap. More options.

$ git clone https://github.com/zeroclaw-labs/zeroclaw.git
$ cd zeroclaw && ./bootstrap.sh
$ # With system deps + Rust: ./bootstrap.sh --install-system-deps --install-rust
$ # With onboarding: ./bootstrap.sh --onboard --api-key "sk-..." --provider openrouter

verified Vérifiez votre installation

Lancez ces commandes pour confirmer que ZeroClaw est correctement installé.

1
$ zeroclaw --version

Devrait afficher la version installée. S'exécute en ~0,02 s avec ~3,9 Mo de mémoire en pic.

2
$ zeroclaw doctor

Lance un diagnostic système : version Rust, fichiers de configuration, connectivité des providers, état des canaux.

3
$ zeroclaw onboard --interactive

Assistant de configuration interactif pour les clés API, la sélection du provider et la configuration des canaux.

settings Configuration initiale

Après l'installation, l'assistant d'onboarding vous guide. Voici ce que fait chaque étape.

1

Choisissez votre fournisseur IA

Sélectionnez dans le catalogue de providers : OpenAI, Anthropic, Google Gemini, xAI, Mistral, DeepSeek, OpenRouter (100+ modèles), ou tout endpoint compatible OpenAI y compris Ollama pour les modèles locaux.

2

Ajoutez votre clé API

Collez votre clé API. Les clés sont stockées localement dans config.toml — jamais envoyées ailleurs qu'au fournisseur IA. L'authentification par abonnement (OpenAI Codex, Anthropic) est aussi supportée avec des profils chiffrés.

3

Connectez un canal

Liez Telegram (collez le token du bot), Discord (collez le token du bot), Slack (app workspace), WhatsApp (QR code), ou l'un des 17+ canaux supportés. Politique de liste d'autorisation deny-by-default.

4

Démarrez l'agent

Lancez 'zeroclaw agent -m "Bonjour !"' pour un test rapide, 'zeroclaw daemon' pour le runtime autonome complet, ou 'zeroclaw service install' pour le service en arrière-plan.

.env — Toute la configuration est stockée dans ~/.zeroclaw/config.toml. Éditez directement pour changer les providers, canaux, backends mémoire, tunnels et paramètres de sécurité. Consultez docs/reference/README.md pour la référence complète.

system_update_alt Mettre à jour ZeroClaw

Gardez ZeroClaw à jour pour profiter des dernières fonctionnalités, intégrations et correctifs de sécurité.

Homebrew
$ brew upgrade zeroclaw
Cargo
$ cargo install zeroclaw --force
Git
$ cd zeroclaw && git pull && cargo build --release --locked
Docker
$ ./bootstrap.sh --docker --skip-build

Consultez le changelog sur github.com/zeroclaw-labs/zeroclaw/releases pour les nouveautés de chaque version.

build Dépannage

Problèmes courants et comment les résoudre.

Besoin d'aide ?

Rejoignez notre communauté pour du support à l'installation et au dépannage.

Restez informé

Recevez les mises à jour sur les nouvelles releases, intégrations et l'infrastructure d'agents en Rust. Pas de spam, désinscription à tout moment.