macOS

Installer, mettre à jour, exécuter en tant que LaunchAgent et désinstaller sur macOS (Intel ou Apple Silicon).

Installer

./install.sh

C’est là toute l’installation. Exécutez-le depuis un clone, ou redirigez-le depuis curl :

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

brew install zeroclaw

Vous permet d’intégrer brew services. Le binaire se trouve dans $HOMEBREW_PREFIX/bin/zeroclaw.

Piège lié à l’emplacement de l’espace de travail : avec Homebrew, l’utilisateur du service et l’utilisateur de la CLI peuvent être différents, donc l’espace de travail se trouve dans $HOMEBREW_PREFIX/var/zeroclaw/ plutôt que dans ~/.zeroclaw/. Pointez les invocations de la CLI vers le même espace de travail :

export ZEROCLAW_WORKSPACE="$HOMEBREW_PREFIX/var/zeroclaw"

Ajoutez cela à votre profil de shell si vous souhaitez que ce soit permanent.

Dépendances système

La plupart des fonctionnalités fonctionnent avec une installation standard de macOS. Extensions optionnelles :

Exécution en tant que service

zeroclaw service install   # écrit ~/Library/LaunchAgents/com.zeroclaw.daemon.plist
zeroclaw service start
zeroclaw service status

Les journaux sont enregistrés dans ~/.zeroclaw/logs/ (installations Homebrew : $HOMEBREW_PREFIX/var/zeroclaw/logs/) :

tail -f ~/.zeroclaw/logs/daemon.stdout.log

Pour les installations via Homebrew, privilégiez :

brew services start zeroclaw
brew services info zeroclaw

Les deux méthodes produisent le même état final : un LaunchAgent chargé qui démarre à la connexion. Choisissez-en une et tenez-vous-y.

Détails complets : Gestion des services.

Mettre à jour

Relancez le programme d’installation, il détecte l’installation existante et effectue la mise à niveau sur place :

curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | sh -s -- --skip-quickstart
zeroclaw service restart

Ou depuis un clone :

cd /path/to/zeroclaw
git pull
./install.sh --skip-quickstart
zeroclaw service restart

Si installé via Homebrew :

brew update && brew upgrade zeroclaw
brew services restart zeroclaw

Désinstaller

# arrêter et désinscrire le service
zeroclaw service stop
zeroclaw service uninstall

# Homebrew
brew uninstall zeroclaw

# bootstrap / cargo
rm ~/.cargo/bin/zeroclaw

Supprimer la configuration et l’espace de travail (optionnel : cela supprime l’historique des conversations) :

# Espace de travail Homebrew
rm -rf "$HOMEBREW_PREFIX/var/zeroclaw"

# Espace de travail par défaut (inclut les journaux dans ~/.zeroclaw/logs)
rm -rf ~/.zeroclaw ~/.config/zeroclaw

Pièges

• Discordance de chemin de configuration Homebrew. Le démon brew services lit la configuration depuis $HOMEBREW_PREFIX/var/zeroclaw/, et non depuis ~/.zeroclaw/. Si votre service lit une configuration obsolète, vérifiez laquelle le démon voit et définissez ZEROCLAW_WORKSPACE en conséquence.
• Première exécution de l’outil de navigateur télécharge Chromium (~150 Mo) via Playwright.
• Apple Silicon et Intel : le script d’amorçage détecte l’architecture et utilise l’artefact précompilé correspondant de la version lorsqu’il est disponible. Si la version ne comporte aucun artefact correspondant, il effectue une compilation depuis les sources. Homebrew sélectionne le package approprié pour l’hôte.

Suivant

• Gestion des services
• Démarrage rapide
• Opérations → Vue d’ensemble