🦀 ZeroClaw — Assistant Personnel IA

Zéro overhead. Zéro compromis. 100% Rust. 100% Agnostique.
⚡️ Fonctionne sur du matériel à $10 avec <5Mo de RAM : 99% de mémoire en moins qu'OpenClaw et 98% moins cher qu'un Mac mini !

Construit par des étudiants et membres des communautés de Harvard, MIT et Sundai.Club.

🌐 Langues : 🇺🇸 English · 🇨🇳 简体中文 · 🇯🇵 日本語 · 🇰🇷 한국어 · 🇻🇳 Tiếng Việt · 🇵🇭 Tagalog · 🇪🇸 Español · 🇧🇷 Português · 🇮🇹 Italiano · 🇩🇪 Deutsch · 🇫🇷 Français · 🇸🇦 العربية · 🇮🇳 हिन्दी · 🇷🇺 Русский · 🇧🇩 বাংলা · 🇮🇱 עברית · 🇵🇱 Polski · 🇨🇿 Čeština · 🇳🇱 Nederlands · 🇹🇷 Türkçe · 🇺🇦 Українська · 🇮🇩 Bahasa Indonesia · 🇹🇭 ไทย · 🇵🇰 اردو · 🇷🇴 Română · 🇸🇪 Svenska · 🇬🇷 Ελληνικά · 🇭🇺 Magyar · 🇫🇮 Suomi · 🇩🇰 Dansk · 🇳🇴 Norsk

ZeroClaw est un assistant personnel IA que vous exécutez sur vos propres appareils. Il vous répond sur les canaux que vous utilisez déjà (WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work et plus). Il dispose d'un tableau de bord web pour le contrôle en temps réel et peut se connecter à des périphériques matériels (ESP32, STM32, Arduino, Raspberry Pi). Le Gateway n'est que le plan de contrôle — le produit est l'assistant.

Si vous voulez un assistant personnel, mono-utilisateur, qui soit local, rapide et toujours disponible, c'est celui-ci.

Site web · Documentation · Architecture · Premiers pas · Migration depuis OpenClaw · Dépannage · Discord

Configuration recommandée : exécutez zeroclaw onboard dans votre terminal. ZeroClaw Onboard vous guide étape par étape dans la configuration du gateway, du workspace, des canaux et du fournisseur. C'est le chemin de configuration recommandé et fonctionne sur macOS, Linux et Windows (via WSL2). Nouvelle installation ? Commencez ici : Premiers pas

• OpenAI Codex (abonnement ChatGPT)
• Gemini (Google OAuth)
• Anthropic (clé API ou jeton d'authentification)

Note sur les modèles : bien que de nombreux fournisseurs/modèles soient supportés, pour la meilleure expérience utilisez le modèle de dernière génération le plus puissant disponible. Voir Onboarding.

Configuration des modèles + CLI : Référence des fournisseurs Rotation des profils d'authentification (OAuth vs clés API) + failover : Failover des modèles

Prérequis : toolchain Rust stable. Un seul binaire, aucune dépendance d'exécution.

brew install zeroclaw

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
./install.sh

zeroclaw onboard s'exécute automatiquement après l'installation pour configurer votre workspace et fournisseur.

Guide complet pour débutants (authentification, appairage, canaux) : Premiers pas

# Installer + onboard
./install.sh --api-key "sk-..." --provider openrouter

# Démarrer le gateway (serveur webhook + tableau de bord web)
zeroclaw gateway                # par défaut : 127.0.0.1:42617
zeroclaw gateway --port 0       # port aléatoire (sécurité renforcée)

# Parler à l'assistant
zeroclaw agent -m "Hello, ZeroClaw!"

# Mode interactif
zeroclaw agent

# Démarrer le runtime autonome complet (gateway + canaux + cron + hands)
zeroclaw daemon

# Vérifier le statut
zeroclaw status

# Exécuter les diagnostics
zeroclaw doctor

Mise à jour ? Exécutez zeroclaw doctor après la mise à jour.

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw

cargo build --release --locked
cargo install --path . --force --locked

zeroclaw onboard

Alternative pour le développement (sans installation globale) : préfixez les commandes avec cargo run --release -- (exemple : cargo run --release -- status).

ZeroClaw peut importer votre workspace, mémoire et configuration OpenClaw :

# Aperçu de ce qui sera migré (sûr, lecture seule)
zeroclaw migrate openclaw --dry-run

# Exécuter la migration
zeroclaw migrate openclaw

Cela migre vos entrées de mémoire, fichiers du workspace et configuration de ~/.openclaw/ vers ~/.zeroclaw/. La configuration est convertie de JSON en TOML automatiquement.

ZeroClaw se connecte à de vraies surfaces de messagerie. Traitez les DM entrants comme des entrées non fiables.

Guide complet de sécurité : SECURITY.md

Comportement par défaut sur tous les canaux :

• Appairage DM (par défaut) : les expéditeurs inconnus reçoivent un court code d'appairage et le bot ne traite pas leur message.
• Approuver avec : zeroclaw pairing approve <channel> <code> (l'expéditeur est alors ajouté à une liste d'autorisation locale).
• Les DM publics entrants nécessitent une activation explicite dans config.toml.
• Exécutez zeroclaw doctor pour détecter les politiques DM risquées ou mal configurées.

Niveaux d'autonomie :

Couches de sandboxing : isolation du workspace, blocage de la traversée de chemins, listes de commandes autorisées, chemins interdits (/etc, /root, ~/.ssh), limitation de débit (max actions/heure, plafonds de coût/jour).

Utilisez ce tableau pour les avis importants (changements incompatibles, avis de sécurité, fenêtres de maintenance et bloqueurs de version).

• Runtime léger par défaut — les flux de travail courants CLI et statut s'exécutent dans une enveloppe mémoire de quelques mégaoctets en builds release.
• Déploiement économique — conçu pour des cartes à $10 et de petites instances cloud, pas de dépendances d'exécution lourdes.
• Démarrage à froid rapide — le runtime Rust à binaire unique maintient le démarrage des commandes et du daemon quasi instantané.
• Architecture portable — un binaire pour ARM, x86 et RISC-V avec fournisseurs/canaux/outils interchangeables.
• Gateway local-first — plan de contrôle unique pour les sessions, canaux, outils, cron, SOPs et événements.
• Boîte de réception multicanal — WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work, WebSocket et plus.
• Orchestration multi-agent (Hands) — essaims d'agents autonomes qui s'exécutent selon un planning et deviennent plus intelligents avec le temps.
• Procédures Opérationnelles Standard (SOPs) — automatisation des flux de travail pilotée par événements avec MQTT, webhook, cron et déclencheurs de périphériques.
• Tableau de bord web — interface web React 19 + Vite avec chat en temps réel, navigateur de mémoire, éditeur de configuration, gestionnaire cron et inspecteur d'outils.
• Périphériques matériels — ESP32, STM32 Nucleo, Arduino, Raspberry Pi GPIO via le trait Peripheral.
• Outils de première classe — shell, E/S fichiers, navigateur, git, web fetch/search, MCP, Jira, Notion, Google Workspace et plus de 70 autres.
• Hooks de cycle de vie — interceptez et modifiez les appels LLM, les exécutions d'outils et les messages à chaque étape.
• Plateforme de skills — skills intégrés, communautaires et du workspace avec audit de sécurité.
• Support de tunnels — Cloudflare, Tailscale, ngrok, OpenVPN et tunnels personnalisés pour l'accès distant.

• Léger par défaut : petit binaire Rust, démarrage rapide, faible empreinte mémoire.
• Sécurisé par conception : appairage, sandboxing strict, listes d'autorisation explicites, portée du workspace.
• Entièrement interchangeable : les systèmes centraux sont des traits (fournisseurs, canaux, outils, mémoire, tunnels).
• Pas de vendor lock-in : support de fournisseurs compatibles OpenAI + endpoints personnalisés enfichables.

Benchmark rapide sur machine locale (macOS arm64, fév 2026) normalisé pour du matériel edge à 0.8GHz.

Notes : Les résultats de ZeroClaw sont mesurés sur des builds release avec /usr/bin/time -l. OpenClaw nécessite le runtime Node.js (typiquement ~390Mo de surcharge mémoire supplémentaire), tandis que NanoBot nécessite le runtime Python. PicoClaw et ZeroClaw sont des binaires statiques. Les chiffres de RAM ci-dessus sont la mémoire à l'exécution ; les besoins de compilation sont plus élevés.

cargo build --release
ls -lh target/release/zeroclaw

/usr/bin/time -l target/release/zeroclaw --help
/usr/bin/time -l target/release/zeroclaw status

• Plan de contrôle Gateway HTTP/WS/SSE avec sessions, présence, configuration, cron, webhooks, tableau de bord web et appairage.
• Surface CLI : gateway, agent, onboard, doctor, status, service, migrate, auth, cron, channel, skills.
• Boucle d'orchestration de l'agent avec dispatch des outils, construction des prompts, classification des messages et chargement de la mémoire.
• Modèle de session avec application des politiques de sécurité, niveaux d'autonomie et validation conditionnelle.
• Wrapper de fournisseur résilient avec failover, retry et routage des modèles sur plus de 20 backends LLM.

Canaux : WhatsApp (natif), Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, DingTalk, Lark, Mattermost, Nextcloud Talk, Nostr, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work, WATI, Mochat, Linq, Notion, WebSocket, ClawdTalk.

Activés par feature gate : Matrix (channel-matrix), Lark (channel-lark), Nostr (channel-nostr).

Tableau de bord web React 19 + Vite 6 + Tailwind CSS 4 servi directement depuis le Gateway :

• Dashboard — vue d'ensemble du système, état de santé, uptime, suivi des coûts
• Chat de l'agent — chat interactif avec l'agent
• Mémoire — parcourir et gérer les entrées de mémoire
• Configuration — voir et modifier la configuration
• Cron — gérer les tâches planifiées
• Outils — parcourir les outils disponibles
• Logs — voir les journaux d'activité de l'agent
• Coûts — utilisation des tokens et suivi des coûts
• Doctor — diagnostics de santé du système
• Intégrations — statut et configuration des intégrations
• Appairage — gestion de l'appairage des appareils

• Core : shell, lecture/écriture/édition de fichiers, opérations git, recherche glob, recherche de contenu
• Web : contrôle du navigateur, web fetch, web search, capture d'écran, informations d'image, lecture PDF
• Intégrations : Jira, Notion, Google Workspace, Microsoft 365, LinkedIn, Composio, Pushover
• MCP : Model Context Protocol tool wrapper + ensembles d'outils différés
• Planification : cron add/remove/update/run, outil de planification
• Mémoire : recall, store, forget, knowledge, project intel
• Avancé : delegate (agent vers agent), swarm, changement/routage de modèles, opérations de sécurité, opérations cloud
• Matériel : board info, memory map, memory read (activé par feature gate)

• Niveaux d'autonomie : ReadOnly, Supervised (par défaut), Full.
• Sandboxing : isolation du workspace, blocage de la traversée de chemins, listes de commandes autorisées, chemins interdits, Landlock (Linux), Bubblewrap.
• Limitation de débit : max actions par heure, max coût par jour (configurable).
• Validation conditionnelle : approbation interactive pour les opérations à risque moyen/élevé.
• Arrêt d'urgence : capacité d'arrêt d'urgence.
• 129+ tests de sécurité en CI automatisé.

• Tableau de bord web servi directement depuis le Gateway.
• Support de tunnels : Cloudflare, Tailscale, ngrok, OpenVPN, commande personnalisée.
• Adaptateur runtime Docker pour exécution conteneurisée.
• CI/CD : beta (automatique au push) → stable (dispatch manuel) → Docker, crates.io, Scoop, AUR, Homebrew, tweet.
• Binaires précompilés pour Linux (x86_64, aarch64, armv7), macOS (x86_64, aarch64), Windows (x86_64).

~/.zeroclaw/config.toml minimal :

default_provider = "anthropic"
api_key = "sk-ant-..."

Référence complète de configuration : docs/reference/api/config-reference.md.

Telegram :

[channels.telegram]
bot_token = "123456:ABC-DEF..."

Discord :

[channels.discord]
token = "your-bot-token"

Slack :

[channels.slack]
bot_token = "xoxb-..."
app_token = "xapp-..."

WhatsApp :

[channels.whatsapp]
enabled = true

Matrix :

[channels.matrix]
homeserver_url = "https://matrix.org"
username = "@bot:matrix.org"
password = "..."

Signal :

[channels.signal]
phone_number = "+1234567890"

[tunnel]
kind = "cloudflare"  # ou "tailscale", "ngrok", "openvpn", "custom", "none"

Détails : Référence des canaux · Référence de configuration

• native (par défaut) — exécution directe des processus, chemin le plus rapide, idéal pour les environnements de confiance.
• docker — isolation complète en conteneur, politiques de sécurité imposées, nécessite Docker.

Définissez runtime.kind = "docker" pour un sandboxing strict ou l'isolation réseau.

ZeroClaw supporte les profils d'authentification natifs par abonnement (multi-compte, chiffrés au repos).

• Fichier de stockage : ~/.zeroclaw/auth-profiles.json
• Clé de chiffrement : ~/.zeroclaw/.secret_key
• Format d'id de profil : <provider>:<profile_name> (exemple : openai-codex:work)

# OpenAI Codex OAuth (abonnement ChatGPT)
zeroclaw auth login --provider openai-codex --device-code

# Gemini OAuth
zeroclaw auth login --provider gemini --profile default

# Anthropic setup-token
zeroclaw auth paste-token --provider anthropic --profile default --auth-kind authorization

# Vérifier / rafraîchir / changer de profil
zeroclaw auth status
zeroclaw auth refresh --provider openai-codex --profile default
zeroclaw auth use --provider openai-codex --profile work

# Exécuter l'agent avec l'authentification par abonnement
zeroclaw agent --provider openai-codex -m "hello"
zeroclaw agent --provider anthropic -m "hello"

Racine du workspace : ~/.zeroclaw/workspace/ (configurable via config).

Fichiers de prompt injectés :

• IDENTITY.md — personnalité et rôle de l'agent
• USER.md — contexte et préférences de l'utilisateur
• MEMORY.md — faits et leçons à long terme
• AGENTS.md — conventions de session et règles d'initialisation
• SOUL.md — identité centrale et principes opérationnels

Skills : ~/.zeroclaw/workspace/skills/<skill>/SKILL.md ou SKILL.toml.

# Lister les skills installés
zeroclaw skills list

# Installer depuis git
zeroclaw skills install https://github.com/user/my-skill.git

# Audit de sécurité avant installation
zeroclaw skills audit https://github.com/user/my-skill.git

# Supprimer un skill
zeroclaw skills remove my-skill

# Gestion du workspace
zeroclaw onboard              # Assistant de configuration guidée
zeroclaw status               # Afficher le statut du daemon/agent
zeroclaw doctor               # Exécuter les diagnostics système

# Gateway + daemon
zeroclaw gateway              # Démarrer le serveur gateway (127.0.0.1:42617)
zeroclaw daemon               # Démarrer le runtime autonome complet

# Agent
zeroclaw agent                # Mode chat interactif
zeroclaw agent -m "message"   # Mode message unique

# Gestion des services
zeroclaw service install      # Installer comme service OS (launchd/systemd)
zeroclaw service start|stop|restart|status

# Canaux
zeroclaw channel list         # Lister les canaux configurés
zeroclaw channel doctor       # Vérifier la santé des canaux
zeroclaw channel bind-telegram 123456789

# Cron + planification
zeroclaw cron list            # Lister les tâches planifiées
zeroclaw cron add "*/5 * * * *" --prompt "Check system health"
zeroclaw cron remove <id>

# Mémoire
zeroclaw memory list          # Lister les entrées de mémoire
zeroclaw memory get <key>     # Récupérer une mémoire
zeroclaw memory stats         # Statistiques de la mémoire

# Profils d'authentification
zeroclaw auth login --provider <name>
zeroclaw auth status
zeroclaw auth use --provider <name> --profile <profile>

# Périphériques matériels
zeroclaw hardware discover    # Scanner les appareils connectés
zeroclaw peripheral list      # Lister les périphériques connectés
zeroclaw peripheral flash     # Flasher le firmware sur l'appareil

# Migration
zeroclaw migrate openclaw --dry-run
zeroclaw migrate openclaw

# Complétion shell
source <(zeroclaw completions bash)
zeroclaw completions zsh > ~/.zfunc/_zeroclaw

Référence complète des commandes : docs/reference/cli/commands-reference.md

curl -LsSf https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | bash

./install.sh --prefer-prebuilt

./install.sh --prebuilt-only

Les assets de release sont publiés pour :

• Linux : x86_64, aarch64, armv7
• macOS : x86_64, aarch64
• Windows : x86_64

Téléchargez les derniers assets depuis : https://github.com/zeroclaw-labs/zeroclaw/releases/latest

Utilisez ces ressources lorsque vous avez dépassé le flux d'onboarding et voulez la référence approfondie.

• Commencez par l'index de la documentation pour la navigation et "qu'est-ce qui est où."
• Lisez la vue d'ensemble de l'architecture pour le modèle complet du système.
• Utilisez la référence de configuration quand vous avez besoin de chaque clé et exemple.
• Exécutez le Gateway selon les règles avec le runbook opérationnel.
• Suivez ZeroClaw Onboard pour une configuration guidée.
• Déboguez les erreurs courantes avec le guide de dépannage.
• Consultez les conseils de sécurité avant d'exposer quoi que ce soit.

• Hub de documentation : docs/README.md
• TOC unifiée des docs : docs/SUMMARY.md
• Référence des commandes : docs/reference/cli/commands-reference.md
• Référence de configuration : docs/reference/api/config-reference.md
• Référence des fournisseurs : docs/reference/api/providers-reference.md
• Référence des canaux : docs/reference/api/channels-reference.md
• Runbook opérationnel : docs/ops/operations-runbook.md
• Dépannage : docs/ops/troubleshooting.md

• Guide de contribution : CONTRIBUTING.md
• Politique de workflow PR : docs/contributing/pr-workflow.md
• Guide du workflow CI : docs/contributing/ci-map.md
• Manuel du réviseur : docs/contributing/reviewer-playbook.md
• Politique de divulgation de sécurité : SECURITY.md
• Modèle de documentation : docs/contributing/doc-template.md

• Guide de déploiement réseau : docs/ops/network-deployment.md
• Manuel de l'agent proxy : docs/ops/proxy-agent-playbook.md
• Guides matériels : docs/hardware/README.md

ZeroClaw a été construit pour le crabe lisse 🦀, un assistant IA rapide et efficace. Construit par Argenis De La Rosa et la communauté.

• zeroclawlabs.ai
• @zeroclawlabs

Si ZeroClaw vous aide dans votre travail et que vous souhaitez soutenir le développement continu, vous pouvez faire un don ici :

Un sincère remerciement aux communautés et institutions qui inspirent et alimentent ce travail open source :

• Harvard University — pour nourrir la curiosité intellectuelle et repousser les limites du possible.
• MIT — pour défendre le savoir ouvert, l'open source et la conviction que la technologie doit être accessible à tous.
• Sundai Club — pour la communauté, l'énergie et la volonté incessante de construire des choses qui comptent.
• Le Monde et Au-delà 🌍✨ — à chaque contributeur, rêveur et constructeur qui fait de l'open source une force pour le bien. C'est pour vous.

Nous construisons ouvertement parce que les meilleures idées viennent de partout. Si vous lisez ceci, vous en faites partie. Bienvenue. 🦀❤️

Nouveau sur ZeroClaw ? Recherchez les issues étiquetées good first issue — consultez notre Guide de contribution pour savoir comment commencer. Les PRs IA/vibe-coded sont les bienvenus ! 🤖

Voir CONTRIBUTING.md et CLA.md. Implémentez un trait, soumettez un PR :

• Guide du workflow CI : docs/contributing/ci-map.md
• Nouveau Provider → src/providers/
• Nouveau Channel → src/channels/
• Nouveau Observer → src/observability/
• Nouveau Tool → src/tools/
• Nouveau Memory → src/memory/
• Nouveau Tunnel → src/tunnel/
• Nouveau Peripheral → src/peripherals/
• Nouveau Skill → ~/.zeroclaw/workspace/skills/<name>/

Ceci est le seul dépôt officiel de ZeroClaw :

https://github.com/zeroclaw-labs/zeroclaw

Tout autre dépôt, organisation, domaine ou package prétendant être "ZeroClaw" ou impliquant une affiliation avec ZeroClaw Labs est non autorisé et non affilié à ce projet. Les forks non autorisés connus seront listés dans TRADEMARK.md.

Si vous rencontrez une usurpation d'identité ou un usage abusif de la marque, veuillez ouvrir une issue.

ZeroClaw est sous double licence pour une ouverture maximale et la protection des contributeurs :

Vous pouvez choisir l'une ou l'autre licence. Les contributeurs accordent automatiquement des droits sous les deux — voir CLA.md pour l'accord complet des contributeurs.

Le nom et le logo ZeroClaw sont des marques de ZeroClaw Labs. Cette licence n'accorde pas la permission de les utiliser pour impliquer un soutien ou une affiliation. Voir TRADEMARK.md pour les usages autorisés et interdits.

• Vous conservez le copyright de vos contributions
• Concession de brevet (Apache 2.0) vous protège des revendications de brevets d'autres contributeurs
• Vos contributions sont attribuées de manière permanente dans l'historique des commits et NOTICE
• Aucun droit de marque n'est transféré en contribuant

ZeroClaw — Zéro overhead. Zéro compromis. Déployez partout. Échangez n'importe quoi. 🦀

Cette liste est générée à partir du graphique des contributeurs GitHub et se met à jour automatiquement.