Linux
Installer, mettre à jour, exécuter en tant que service et désinstaller, sur toutes les distributions Linux.
Installer
./install.sh
C’est là toute l’installation. Exécutez-le depuis un clone, ou redirigez-le depuis curl :
sh
curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | sh
Les chemins d’installation canoniques expliquent les parcours rapide et guidé, le recours aux sources en dernier ressort, la sélection de l’application, le transfert de PATH et l’étape suivante du guide de démarrage rapide.
Homebrew (Linuxbrew)
sh
brew install zeroclaw
Les installations Homebrew-on-Linux suivent la convention de chemin de service de Homebrew, votre espace de travail se trouve sous $HOMEBREW_PREFIX/var/zeroclaw/ au lieu de ~/.zeroclaw/. Consultez Gestion des services pour comprendre pourquoi c’est important.
NixOS
Un module NixOS multi-instance est fourni dans l’arborescence du projet. Voir NixOS.
Remarque sur cargo binstall et nix run
Aucune des deux options ne fonctionne pour l’instant. cargo binstall zeroclaw résout les métadonnées du crate depuis crates.io, mais ZeroClaw n’y est pas publié (publish = false), il n’y a donc rien à récupérer ; nix run github:zeroclaw-labs/zeroclaw ne lance pas l’agent car le flake n’expose qu’une chaîne d’outils de développement, pas un paquet exécutable (#5987). install.sh fait déjà ce que binstall ferait (télécharger un binaire de release précompilé), il reste donc la commande en une ligne officiellement prise en charge.
Dépendances système
Le binaire principal est lié statiquement dans la mesure du possible. Certaines fonctionnalités nécessitent des bibliothèques système :
| Fonctionnalité | Package (Debian/Ubuntu) | Paquet (Arch) | Paquet (Fedora) |
|---|---|---|---|
Traduction de la documentation (cargo mdbook sync) | gettext | gettext | gettext |
| Outil de navigateur (Playwright) | libnss3, libatk1.0-0, libcups2 (voir playwright --help) | nss, atk, cups | nss, atk, cups |
| Audio (TTS, canaux vocaux) | libasound2-dev | alsa-lib | alsa-lib-devel |
La fonctionnalité matérielle (GPIO / I2C / SPI sur un Pi) utilise le pilote rppal en pur Rust et ne nécessite aucune bibliothèque système supplémentaire ; elle communique directement avec /dev/gpiomem, /dev/spidev* et /dev/i2c-*. Ce dont elle a besoin, c’est d’un accès aux périphériques : activez les interfaces SPI/I2C et ajoutez l’utilisateur du service aux groupes gpio, spi et i2c (voir SBC / Raspberry Pi ci-dessous).
La plupart des déploiements n’ont besoin d’aucun de ces éléments.
Exécution en tant que service
Systemd est la solution par défaut. OpenRC est détecté et pris en charge en tant que solution de secours.
sh
zeroclaw service install
zeroclaw service start
zeroclaw service status
Les journaux sont envoyés par défaut au journal systemd :
sh
journalctl --user -u zeroclaw -f
Détails complets : Gestion des services.
SBC / Raspberry Pi
Sur un Raspberry Pi ou un SBC similaire, compilez avec la fonctionnalité matérielle :
sh
./install.sh --source --features hardware
Pour accéder au matériel sans s’exécuter en tant que root, l’utilisateur du service doit appartenir aux groupes gpio, spi et i2c. L’unité de niveau utilisateur que zeroclaw service install écrit ne définit pas ces groupes ; utilisez le modèle d’unité Pi de niveau système disponible dans scripts/zeroclaw.service, qui inclut SupplementaryGroups=gpio spi i2c. Dans les deux cas, vérifiez que votre utilisateur appartient à ces groupes :
sh
getent group gpio spi i2c
sudo usermod -aG gpio,spi,i2c $USER
# re-login pour que les modifications de groupe prennent effet
Mettre à jour
Relancez le programme d’installation, il détecte l’installation existante et effectue la mise à niveau sur place :
sh
curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | sh -s -- --skip-quickstart
Ou depuis un clone :
sh
cd /path/to/zeroclaw
git pull
./install.sh --skip-quickstart
Si installé via Homebrew :
sh
brew update && brew upgrade zeroclaw
Après la mise à jour, redémarrez le service :
sh
zeroclaw service restart
Désinstaller
Si vous avez installé avec le script bootstrap, utilisez le même script pour désinstaller :
sh
./install.sh --uninstall
Arrêter et supprimer le service :
sh
zeroclaw service stop
zeroclaw service uninstall
Supprimer le binaire :
sh
# cargo install / bootstrap
rm ~/.cargo/bin/zeroclaw
# Homebrew
brew uninstall zeroclaw
Supprimer la configuration et l’espace de travail (optionnel : cela supprime l’historique des conversations) :
sh
rm -rf ~/.zeroclaw ~/.config/zeroclaw
Suivant
- Gestion du service : détails de l’unité systemd, journaux, démarrage automatique
- Démarrage rapide : une fois installé, commencer à discuter
- Opérations → Vue d’ensemble : exécution en production