<p align="center">
  <img src="https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/docs/assets/zeroclaw-banner.png" alt="ZeroClaw" width="600" />
</p>

<h1 align="center">🦀 ZeroClaw — Assistant Personnel IA</h1>

<p align="center">
  <strong>Zéro overhead. Zéro compromis. 100% Rust. 100% Agnostique.</strong><br>
  ⚡️ <strong>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 !</strong>
</p>

<p align="center">
  <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a>
  <a href="https://github.com/zeroclaw-labs/zeroclaw/graphs/contributors"><img src="https://img.shields.io/github/contributors/zeroclaw-labs/zeroclaw?color=green" alt="Contributors" /></a>
  <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a>
  <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a>
  <a href="https://www.facebook.com/groups/zeroclawlabs"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a>
  <a href="https://discord.com/invite/wDshRVqRjx"><img src="https://img.shields.io/badge/Discord-Join-5865F2?style=flat&logo=discord&logoColor=white" alt="Discord" /></a>
  <a href="https://www.instagram.com/therealzeroclaw"><img src="https://img.shields.io/badge/Instagram-%40therealzeroclaw-E4405F?style=flat&logo=instagram&logoColor=white" alt="Instagram: @therealzeroclaw" /></a>
  <a href="https://www.tiktok.com/@zeroclawlabs"><img src="https://img.shields.io/badge/TikTok-%40zeroclawlabs-000000?style=flat&logo=tiktok&logoColor=white" alt="TikTok: @zeroclawlabs" /></a>
  <a href="https://www.rednote.com/user/profile/69b735e6000000002603927e"><img src="https://img.shields.io/badge/RedNote-Official-FF2442?style=flat" alt="RedNote" /></a>
  <a href="https://www.reddit.com/r/zeroclawlabs/"><img src="https://img.shields.io/badge/Reddit-r%2Fzeroclawlabs-FF4500?style=flat&logo=reddit&logoColor=white" alt="Reddit: r/zeroclawlabs" /></a>
</p>

<p align="center">
Construit par des étudiants et membres des communautés de Harvard, MIT et Sundai.Club.
</p>

<p align="center">
  🌐 <strong>Langues :</strong>
  <a href="README.md">🇺🇸 English</a> ·
  <a href="README.zh-CN.md">🇨🇳 简体中文</a> ·
  <a href="README.ja.md">🇯🇵 日本語</a> ·
  <a href="README.ko.md">🇰🇷 한국어</a> ·
  <a href="README.vi.md">🇻🇳 Tiếng Việt</a> ·
  <a href="README.tl.md">🇵🇭 Tagalog</a> ·
  <a href="README.es.md">🇪🇸 Español</a> ·
  <a href="README.pt.md">🇧🇷 Português</a> ·
  <a href="README.it.md">🇮🇹 Italiano</a> ·
  <a href="README.de.md">🇩🇪 Deutsch</a> ·
  <a href="README.fr.md">🇫🇷 Français</a> ·
  <a href="README.ar.md">🇸🇦 العربية</a> ·
  <a href="README.hi.md">🇮🇳 हिन्दी</a> ·
  <a href="README.ru.md">🇷🇺 Русский</a> ·
  <a href="README.bn.md">🇧🇩 বাংলা</a> ·
  <a href="README.he.md">🇮🇱 עברית</a> ·
  <a href="README.pl.md">🇵🇱 Polski</a> ·
  <a href="README.cs.md">🇨🇿 Čeština</a> ·
  <a href="README.nl.md">🇳🇱 Nederlands</a> ·
  <a href="README.tr.md">🇹🇷 Türkçe</a> ·
  <a href="README.uk.md">🇺🇦 Українська</a> ·
  <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> ·
  <a href="README.th.md">🇹🇭 ไทย</a> ·
  <a href="README.ur.md">🇵🇰 اردو</a> ·
  <a href="README.ro.md">🇷🇴 Română</a> ·
  <a href="README.sv.md">🇸🇪 Svenska</a> ·
  <a href="README.el.md">🇬🇷 Ελληνικά</a> ·
  <a href="README.hu.md">🇭🇺 Magyar</a> ·
  <a href="README.fi.md">🇫🇮 Suomi</a> ·
  <a href="README.da.md">🇩🇰 Dansk</a> ·
  <a href="README.nb.md">🇳🇴 Norsk</a>
</p>

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.

<p align="center">
  <a href="https://zeroclawlabs.ai">Site web</a> ·
  <a href="docs/README.md">Documentation</a> ·
  <a href="docs/architecture.md">Architecture</a> ·
  <a href="#démarrage-rapide">Premiers pas</a> ·
  <a href="#migration-depuis-openclaw">Migration depuis OpenClaw</a> ·
  <a href="docs/ops/troubleshooting.md">Dépannage</a> ·
  <a href="https://discord.com/invite/wDshRVqRjx">Discord</a>
</p>

> **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](#démarrage-rapide)

### Authentification par abonnement (OAuth)

- **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](#démarrage-rapide).

Configuration des modèles + CLI : [Référence des fournisseurs](docs/reference/api/providers-reference.md)
Rotation des profils d'authentification (OAuth vs clés API) + failover : [Failover des modèles](docs/reference/api/providers-reference.md)

## Installation (recommandée)

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

### Homebrew (macOS/Linuxbrew)

```bash
brew install zeroclaw
```

### Bootstrap en un clic

```bash
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.

## Démarrage rapide (TL;DR)

Guide complet pour débutants (authentification, appairage, canaux) : [Premiers pas](docs/setup-guides/one-click-bootstrap.md)

```bash
# 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.

### Depuis le code source (développement)

```bash
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`).

## Migration depuis OpenClaw

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

```bash
# 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.

## Paramètres de sécurité par défaut (accès DM)

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](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 :**

| Niveau | Comportement |
|--------|--------------|
| `ReadOnly` | L'agent peut observer mais pas agir |
| `Supervised` (par défaut) | L'agent agit avec approbation pour les opérations à risque moyen/élevé |
| `Full` | L'agent agit de manière autonome dans les limites de la politique |

**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).

<!-- BEGIN:WHATS_NEW -->
<!-- END:WHATS_NEW -->

### 📢 Annonces

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

| Date (UTC) | Niveau       | Avis                                                                                                                                                                                                                                                                                                                                                 | Action                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ---------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |   |
| 2026-02-19 | _Critique_  | Nous ne sommes **pas affiliés** à `openagen/zeroclaw`, `zeroclaw.org` ou `zeroclaw.net`. Les domaines `zeroclaw.org` et `zeroclaw.net` pointent actuellement vers le fork `openagen/zeroclaw`, et ce domaine/dépôt usurpent l'identité de notre site web/projet officiel.                                                                                       | Ne faites pas confiance aux informations, binaires, collectes de fonds ou annonces provenant de ces sources. Utilisez uniquement [ce dépôt](https://github.com/zeroclaw-labs/zeroclaw) et nos comptes sociaux vérifiés.                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 2026-02-21 | _Important_ | Notre site web officiel est maintenant en ligne : [zeroclawlabs.ai](https://zeroclawlabs.ai). Merci de votre patience pendant que nous préparions le lancement. Nous continuons de voir des tentatives d'usurpation d'identité, donc ne participez **pas** à des activités d'investissement ou de collecte de fonds utilisant le nom ZeroClaw sauf si elles sont publiées via nos canaux officiels.                            | Utilisez [ce dépôt](https://github.com/zeroclaw-labs/zeroclaw) comme seule source de vérité. Suivez [X (@zeroclawlabs)](https://x.com/zeroclawlabs?s=21), [Facebook (Groupe)](https://www.facebook.com/groups/zeroclawlabs) et [Reddit (r/zeroclawlabs)](https://www.reddit.com/r/zeroclawlabs/) pour les mises à jour officielles. |
| 2026-02-19 | _Important_ | Anthropic a mis à jour les conditions d'Authentification et d'Utilisation des Identifiants le 2026-02-19. Les jetons OAuth de Claude Code (Free, Pro, Max) sont destinés exclusivement à Claude Code et Claude.ai ; utiliser des jetons OAuth de Claude Free/Pro/Max dans tout autre produit, outil ou service (y compris Agent SDK) n'est pas autorisé et peut violer les Conditions d'Utilisation du Consommateur. | Veuillez éviter temporairement les intégrations OAuth de Claude Code pour prévenir les pertes potentielles. Clause originale : [Authentication and Credential Use](https://code.claude.com/docs/en/legal-and-compliance#authentication-and-credential-use).                                                                                                                                                                                                                                                                                                                                                                                    |

## Points forts

- **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.

### Pourquoi les équipes choisissent ZeroClaw

- **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.

## Résumé des benchmarks (ZeroClaw vs OpenClaw, reproductible)

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

|                           | OpenClaw      | NanoBot        | PicoClaw        | ZeroClaw 🦀          |
| ------------------------- | ------------- | -------------- | --------------- | -------------------- |
| **Langage**               | TypeScript    | Python         | Go              | **Rust**             |
| **RAM**                   | > 1Go         | > 100Mo        | < 10Mo          | **< 5Mo**            |
| **Démarrage (core 0.8GHz)** | > 500s      | > 30s          | < 1s            | **< 10ms**           |
| **Taille du binaire**     | ~28Mo (dist)  | N/A (Scripts)  | ~8Mo            | **~8.8 Mo**          |
| **Coût**                  | Mac Mini $599 | Linux SBC ~$50 | Linux Board $10 | **N'importe quel matériel $10** |

> 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.

<p align="center">
  <img src="docs/assets/zeroclaw-comparison.jpeg" alt="ZeroClaw vs OpenClaw Comparison" width="800" />
</p>

### Mesure locale reproductible

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

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

## Tout ce que nous avons construit jusqu'ici

### Plateforme centrale

- 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

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

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

### Cibles firmware

| Cible | Plateforme | Objectif |
|-------|------------|----------|
| ESP32 | Espressif ESP32 | Agent périphérique sans fil |
| ESP32-UI | ESP32 + Display | Agent avec interface visuelle |
| STM32 Nucleo | STM32 (ARM Cortex-M) | Périphérique industriel |
| Arduino | Arduino | Pont capteurs/actionneurs basique |
| Uno Q Bridge | Arduino Uno | Pont série vers l'agent |

### Outils + automatisation

- **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)

### Runtime + sécurité

- **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é.

### Opérations + packaging

- 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).


## Configuration

`~/.zeroclaw/config.toml` minimal :

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

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

### Configuration des canaux

**Telegram :**
```toml
[channels.telegram]
bot_token = "123456:ABC-DEF..."
```

**Discord :**
```toml
[channels.discord]
token = "your-bot-token"
```

**Slack :**
```toml
[channels.slack]
bot_token = "xoxb-..."
app_token = "xapp-..."
```

**WhatsApp :**
```toml
[channels.whatsapp]
enabled = true
```

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

**Signal :**
```toml
[channels.signal]
phone_number = "+1234567890"
```

### Configuration des tunnels

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

Détails : [Référence des canaux](docs/reference/api/channels-reference.md) · [Référence de configuration](docs/reference/api/config-reference.md)

### Support runtime (actuel)

- **`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.

## Authentification par abonnement (OpenAI Codex / Claude Code / Gemini)

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`)

```bash
# 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"
```

## Workspace de l'agent + skills

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`.

```bash
# 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
```

## Commandes CLI

```bash
# 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](docs/reference/cli/commands-reference.md)

<!-- markdownlint-disable MD001 MD024 -->

## Prérequis

<details>
<summary><strong>Windows</strong></summary>

#### Requis

1. **Visual Studio Build Tools** (fournit le linker MSVC et le SDK Windows) :

    ```powershell
    winget install Microsoft.VisualStudio.2022.BuildTools
    ```

    Pendant l'installation (ou via le Visual Studio Installer), sélectionnez la charge de travail **"Développement Desktop en C++"**.

2. **Toolchain Rust :**

    ```powershell
    winget install Rustlang.Rustup
    ```

    Après l'installation, ouvrez un nouveau terminal et exécutez `rustup default stable` pour vous assurer que la toolchain stable est active.

3. **Vérifiez** que les deux fonctionnent :
    ```powershell
    rustc --version
    cargo --version
    ```

#### Optionnel

- **Docker Desktop** — requis uniquement si vous utilisez le [runtime sandbox Docker](#support-runtime-actuel) (`runtime.kind = "docker"`). Installez via `winget install Docker.DockerDesktop`.

</details>

<details>
<summary><strong>Linux / macOS</strong></summary>

#### Requis

1. **Outils de compilation essentiels :**
    - **Linux (Debian/Ubuntu) :** `sudo apt install build-essential pkg-config`
    - **Linux (Fedora/RHEL) :** `sudo dnf group install development-tools && sudo dnf install pkg-config`
    - **macOS :** Installez Xcode Command Line Tools : `xcode-select --install`

2. **Toolchain Rust :**

    ```bash
    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
    ```

    Voir [rustup.rs](https://rustup.rs) pour les détails.

3. **Vérifiez** que les deux fonctionnent :
    ```bash
    rustc --version
    cargo --version
    ```

#### Installateur en une ligne

Ou passez les étapes ci-dessus et installez tout (dépendances système, Rust, ZeroClaw) en une seule commande :

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

#### Besoins en ressources pour la compilation

Compiler depuis le code source nécessite plus de ressources que l'exécution du binaire résultant :

| Ressource      | Minimum | Recommandé  |
| -------------- | ------- | ----------- |
| **RAM + swap** | 2 Go    | 4 Go+       |
| **Disque libre**| 6 Go   | 10 Go+      |

Si votre hôte est en dessous du minimum, utilisez les binaires précompilés :

```bash
./install.sh --prefer-prebuilt
```

Pour exiger une installation binaire uniquement sans compilation de secours :

```bash
./install.sh --prebuilt-only
```

#### Optionnel

- **Docker** — requis uniquement si vous utilisez le [runtime sandbox Docker](#support-runtime-actuel) (`runtime.kind = "docker"`). Installez via votre gestionnaire de paquets ou [docker.com](https://docs.docker.com/engine/install/).

> **Note :** Le `cargo build --release` par défaut utilise `codegen-units=1` pour réduire la pression maximale de compilation. Pour des builds plus rapides sur des machines puissantes, utilisez `cargo build --profile release-fast`.

</details>

<!-- markdownlint-enable MD001 MD024 -->

### Binaires précompilés

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>

## Documentation

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](docs/README.md) pour la navigation et "qu'est-ce qui est où."
- Lisez la [vue d'ensemble de l'architecture](docs/architecture.md) pour le modèle complet du système.
- Utilisez la [référence de configuration](docs/reference/api/config-reference.md) quand vous avez besoin de chaque clé et exemple.
- Exécutez le Gateway selon les règles avec le [runbook opérationnel](docs/ops/operations-runbook.md).
- Suivez [ZeroClaw Onboard](#démarrage-rapide) pour une configuration guidée.
- Déboguez les erreurs courantes avec le [guide de dépannage](docs/ops/troubleshooting.md).
- Consultez les [conseils de sécurité](docs/security/README.md) avant d'exposer quoi que ce soit.

### Documentation de référence

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

### Documentation de collaboration

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

### Déploiement + opérations

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

## Smooth Crab 🦀

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](https://zeroclawlabs.ai)
- [@zeroclawlabs](https://x.com/zeroclawlabs)

## Soutenir ZeroClaw

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

<a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=for-the-badge&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a>

### 🙏 Remerciements spéciaux

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. 🦀❤️

## Contribuer

Nouveau sur ZeroClaw ? Recherchez les issues étiquetées [`good first issue`](https://github.com/zeroclaw-labs/zeroclaw/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) — consultez notre [Guide de contribution](CONTRIBUTING.md#first-time-contributors) pour savoir comment commencer. Les PRs IA/vibe-coded sont les bienvenus ! 🤖

Voir [CONTRIBUTING.md](CONTRIBUTING.md) et [CLA.md](docs/contributing/cla.md). Implémentez un trait, soumettez un PR :

- Guide du workflow CI : [docs/contributing/ci-map.md](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>/`

<!-- BEGIN:RECENT_CONTRIBUTORS -->
<!-- END:RECENT_CONTRIBUTORS -->

## ⚠️ Dépôt officiel et avertissement d'usurpation

**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](docs/maintainers/trademark.md).

Si vous rencontrez une usurpation d'identité ou un usage abusif de la marque, veuillez [ouvrir une issue](https://github.com/zeroclaw-labs/zeroclaw/issues).

---

## Licence

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

| Licence | Cas d'utilisation |
|---|---|
| [MIT](LICENSE-MIT) | Open source, recherche, académique, usage personnel |
| [Apache 2.0](LICENSE-APACHE) | Protection par brevet, institutionnel, déploiement commercial |

Vous pouvez choisir l'une ou l'autre licence. **Les contributeurs accordent automatiquement des droits sous les deux** — voir [CLA.md](docs/contributing/cla.md) pour l'accord complet des contributeurs.

### Marque déposée

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](docs/maintainers/trademark.md) pour les usages autorisés et interdits.

### Protections des contributeurs

- 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](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. 🦀

## Contributeurs

<a href="https://github.com/zeroclaw-labs/zeroclaw/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=zeroclaw-labs/zeroclaw" alt="ZeroClaw contributors" />
</a>

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

## Historique des étoiles

<p align="center">
  <a href="https://www.star-history.com/#zeroclaw-labs/zeroclaw&type=date&legend=top-left">
    <picture>
     <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&theme=dark&legend=top-left" />
     <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" />
     <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" />
    </picture>
  </a>
</p>
