macOS

Instalar, actualizar, ejecutar como LaunchAgent y desinstalar en macOS (Intel o Apple Silicon).

Instalar

./install.sh

Eso es toda la instalación. Ejecútelo desde un clon, o canalícelo desde curl:

sh

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

Las rutas de instalación canónicas explican las rutas rápida y guiada, la alternativa del código fuente, la selección de la aplicación, la transferencia de PATH y el siguiente paso de Inicio rápido.

Homebrew

sh

brew install zeroclaw

Te proporciona la integración con brew services. El binario se encuentra en $HOMEBREW_PREFIX/bin/zeroclaw.

Cuidado con la ubicación del espacio de trabajo: con Homebrew, el usuario del servicio y el usuario de la CLI pueden ser diferentes, por lo que el espacio de trabajo se encuentra en $HOMEBREW_PREFIX/var/zeroclaw/ en lugar de ~/.zeroclaw/. Dirige las invocaciones de la CLI al mismo espacio de trabajo:

sh

export ZEROCLAW_WORKSPACE="$HOMEBREW_PREFIX/var/zeroclaw"

Agrega eso a tu perfil de shell si quieres que sea permanente.

Dependencias del sistema

La mayoría de las funciones funcionan con una instalación estándar de macOS. Extras opcionales:

Característica	Instalar
Traducción de documentos	`brew install gettext`
Herramienta del navegador	Playwright descarga automáticamente Chromium en el primer uso
Hardware	No hay GPIO nativo en macOS; usa una placa conectada por USB. Consulta Hardware
canal de iMessage	Requiere macOS 11+. Consulta Canales → Otras plataformas de chat

Ejecutándose como un servicio

sh

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

Los registros van a ~/.zeroclaw/logs/ (instalaciones de Homebrew: $HOMEBREW_PREFIX/var/zeroclaw/logs/):

sh

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

Para las instalaciones de Homebrew, se prefiere:

sh

brew services start zeroclaw
brew services info zeroclaw

Ambos métodos producen el mismo estado final, un LaunchAgent cargado que se inicia al iniciar sesión. Elige uno y mantenlo.

Detalles completos: Gestión de servicios.

Actualizar

Vuelva a ejecutar el instalador; este detecta la instalación existente y la actualiza en el mismo lugar:

sh

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

O desde un clon:

sh

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

Si se instaló a través de Homebrew en su lugar:

sh

brew update && brew upgrade zeroclaw
brew services restart zeroclaw

Desinstalar

sh

# detener y desregistrar el servicio
zeroclaw service stop
zeroclaw service uninstall

# Homebrew
brew uninstall zeroclaw

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

Eliminar configuración y espacio de trabajo (opcional: esto borra el historial de conversaciones):

sh

# Espacio de trabajo de Homebrew
rm -rf "$HOMEBREW_PREFIX/var/zeroclaw"

# Espacio de trabajo predeterminado (incluye registros en ~/.zeroclaw/logs)
rm -rf ~/.zeroclaw ~/.config/zeroclaw

Cosas a tener en cuenta

Discrepancia en la ruta de configuración de Homebrew. El daemon de brew services lee la configuración desde $HOMEBREW_PREFIX/var/zeroclaw/, no desde ~/.zeroclaw/. Si su servicio está leyendo una configuración obsoleta, verifique cuál de ellas ve el daemon y configure ZEROCLAW_WORKSPACE en consecuencia.
La primera ejecución de la herramienta del navegador descarga Chromium (~150 MB) a través de Playwright.
Apple Silicon e Intel: el script de arranque detecta la arquitectura y usa un artefacto precompilado correspondiente de la versión cuando hay uno disponible. Si la versión no tiene ningún artefacto correspondiente, recurre a una compilación desde el código fuente. Homebrew selecciona el paquete adecuado para el sistema host.

ZeroClaw Docs