Linux
Instalar, actualizar, ejecutar como servicio y desinstalar, todas las distribuciones de Linux.
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 (Linuxbrew)
sh
brew install zeroclaw
Las instalaciones de Homebrew-on-Linux siguen la convención de rutas de servicio de Homebrew, tu espacio de trabajo se encuentra en $HOMEBREW_PREFIX/var/zeroclaw/ en lugar de ~/.zeroclaw/. Consulta Gestión de servicios para saber por qué esto es importante.
NixOS
Un módulo NixOS multi-instancia se incluye en el árbol del proyecto. Consulta NixOS.
Una nota sobre cargo binstall y nix run
Ninguno de los dos funciona todavía. cargo binstall zeroclaw resuelve los metadatos del crate desde crates.io, pero ZeroClaw no está publicado allí (publish = false), por lo que no hay nada que pueda descargar; nix run github:zeroclaw-labs/zeroclaw no inicia el agente porque el flake expone solo un toolchain de desarrollo, no un paquete ejecutable (#5987). install.sh ya hace lo que haría binstall (descargar un binario precompilado de la release), por lo que sigue siendo el comando de una sola línea con soporte oficial.
Dependencias del sistema
El binario principal está enlazado estáticamente siempre que sea posible. Algunas características requieren bibliotecas del sistema:
| Característica | Paquete (Debian/Ubuntu) | Paquete (Arch) | Paquete (Fedora) |
|---|---|---|---|
Traducción de documentación (cargo mdbook sync) | gettext | gettext | gettext |
| Herramienta del navegador (Playwright) | libnss3, libatk1.0-0, libcups2 (consulta playwright --help) | nss, atk, cups | nss, atk, cups |
| Audio (TTS, canales de voz) | libasound2-dev | alsa-lib | alsa-lib-devel |
La función de hardware (GPIO / I2C / SPI en una Pi) usa el controlador rppal escrito puramente en Rust y no necesita ninguna biblioteca de sistema adicional; se comunica directamente con /dev/gpiomem, /dev/spidev* y /dev/i2c-*. Lo que sí necesita es acceso a los dispositivos: habilite las interfaces SPI/I2C y agregue el usuario del servicio a los grupos gpio, spi e i2c (vea SBC / Raspberry Pi más abajo).
La mayoría de los despliegues no necesitan ninguno de estos.
Ejecutándose como un servicio
Systemd es el predeterminado. OpenRC se detecta y se admite como alternativa.
sh
zeroclaw service install
zeroclaw service start
zeroclaw service status
Los registros se envían al diario de systemd de forma predeterminada:
sh
journalctl --user -u zeroclaw -f
Detalles completos: Gestión de servicios.
SBC / Raspberry Pi
En una Raspberry Pi o una SBC similar, compila con la característica de hardware:
sh
./install.sh --source --features hardware
Para acceder al hardware sin ejecutar como root, el usuario del servicio necesita los grupos gpio, spi e i2c. La unidad a nivel de usuario que escribe zeroclaw service install no los configura; use la plantilla de unidad de Pi a nivel de sistema en scripts/zeroclaw.service, que incluye SupplementaryGroups=gpio spi i2c. En cualquier caso, verifique que su usuario esté en esos grupos:
sh
getent group gpio spi i2c
sudo usermod -aG gpio,spi,i2c $USER
# volver a iniciar sesión para que los cambios de grupo surtan efecto
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
O desde un clon:
sh
cd /path/to/zeroclaw
git pull
./install.sh --skip-quickstart
Si se instaló a través de Homebrew en su lugar:
sh
brew update && brew upgrade zeroclaw
Después de actualizar, reinicia el servicio:
sh
zeroclaw service restart
Desinstalar
Si instalaste con el script de arranque, usa el mismo script para desinstalar:
sh
./install.sh --uninstall
Detener y eliminar el servicio:
sh
zeroclaw service stop
zeroclaw service uninstall
Eliminar el binario:
sh
# cargo install / bootstrap
rm ~/.cargo/bin/zeroclaw
# Homebrew
brew uninstall zeroclaw
Eliminar configuración y espacio de trabajo (opcional: esto borra el historial de conversaciones):
sh
rm -rf ~/.zeroclaw ~/.config/zeroclaw
Siguiente
- Gestión de servicios: detalles de la unidad de systemd, registros, inicio automático
- Inicio rápido: una vez instalado, empieza a conversar
- Operaciones → Visión general: ejecución en producción