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
Le flake amont fournit la CLI ZeroClaw. Avec Nix et les flakes activés :
nix run github:zeroclaw-labs/zeroclaw -- --version
Consultez NixOS pour les compilations à partir des sources, le paquet Nixpkgs et le module de service NixOS multi-instances. Pour les binaires précompilés, utilisez le programme d’installation décrit ci-dessus.
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
Les mises à jour standard de la version incluent les adaptateurs natifs pour les paramètres d’outils minimal et complet. Complet reste la valeur par défaut pour les installations nouvelles et existantes, y compris les configurations sans [tools]. Minimal, avec onze outils dans Chat et huit dans Code/ACP, est accessible sur demande via optional = []. Les sélections explicites sont conservées ; les entrées nommées sélectionnent des extras individuels. Complet préserve les prérequis d’intégration existants et les contrôles d’autorisation. Les compilations depuis les sources avec les seules valeurs par défaut de Cargo, y compris une formule Homebrew qui n’utilise que ces valeurs par défaut, peuvent toujours omettre les adaptateurs. Voir outils minimal/complet et récupération de build.
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