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
El flake de origen proporciona la CLI de ZeroClaw. Con Nix y flakes habilitados:
nix run github:zeroclaw-labs/zeroclaw -- --version
Consulte NixOS para compilaciones desde el código fuente, el paquete de Nixpkgs y el módulo de servicio de NixOS para múltiples instancias. Para binarios precompilados, use el instalador descrito arriba.
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
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:
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