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:

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

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:

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:

Ejecutándose como un servicio

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/):

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

Para las instalaciones de Homebrew, se prefiere:

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

Las versiones estándar incluyen los adaptadores nativos para las configuraciones de herramientas mínima y completa. La configuración completa sigue siendo la predeterminada para las instalaciones nuevas y existentes, incluidas las configuraciones sin [tools]. La configuración mínima, con once herramientas en Chat y ocho en Code/ACP, es opcional y se activa mediante optional = []. Las selecciones explícitas se conservan; las entradas con nombre seleccionan extras individuales. La configuración completa conserva los requisitos previos de integración existentes y los controles de permisos. Las compilaciones desde código fuente con los valores predeterminados de Cargo, incluida una fórmula de Homebrew que usa solo esos valores predeterminados, aún pueden omitir los adaptadores. Consulte herramientas mínimas/completas y recuperación de compilación.

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

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

O desde un clon:

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

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

brew update && brew upgrade zeroclaw
brew services restart zeroclaw

Desinstalar

# 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):

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

Siguiente

• Gestión de servicios
• Inicio rápido
• Operaciones → Resumen