Guía de Instalación

Pon ZeroClaw a Funcionar

Un solo binario Rust, múltiples formas de instalar. Elige la que te funcione.

checklist Requisitos del Sistema

build Rust

Toolchain de Rust (stable) vía rustup.rs — solo necesario para compilar desde fuente

computer OS

Linux (x86_64, aarch64, armv7), macOS (x86_64, aarch64), Windows (x86_64)

memory RAM

Runtime: <5MB de RAM. Compilar desde fuente: 2GB+ de RAM, 4GB recomendado

hard_drive Disk

Binario: ~8.8MB. Compilar desde fuente: 6GB de disco libre, 10GB recomendado

extension Optional

Opcional: Docker (para runtime en sandbox), Git (para compilar desde fuente)

wifi Network

Internet para llamadas a APIs de IA. Modelos locales vía Ollama funcionan completamente offline.

Scripts de una línea que hacen todo. Recomendado para la mayoría.

bolt

Remote One-Liner

macOS / Linux. Single command.

$ curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash
rocket_launch

Local Bootstrap

Clone first, then bootstrap. More options.

$ git clone https://github.com/zeroclaw-labs/zeroclaw.git
$ cd zeroclaw && ./bootstrap.sh
$ # With system deps + Rust: ./bootstrap.sh --install-system-deps --install-rust
$ # With onboarding: ./bootstrap.sh --onboard --api-key "sk-..." --provider openrouter

verified Verifica Tu Instalación

Ejecuta estos comandos para confirmar que ZeroClaw está instalado correctamente.

1
$ zeroclaw --version

Debería mostrar la versión instalada. Se ejecuta en ~0.02s con ~3.9MB de memoria pico.

2
$ zeroclaw doctor

Ejecuta diagnósticos del sistema: versión de Rust, archivos de config, conectividad de proveedores, salud de canales.

3
$ zeroclaw onboard --interactive

Asistente de configuración interactivo para API keys, selección de proveedor y configuración de canales.

settings Configuración Inicial

Después de instalar, el asistente de onboard te guía en la configuración. Esto es lo que hace cada paso.

1

Elige Tu Proveedor de IA

Selecciona del catálogo de proveedores: OpenAI, Anthropic, Google Gemini, xAI, Mistral, DeepSeek, OpenRouter (100+ modelos), o cualquier endpoint compatible con OpenAI incluyendo Ollama para modelos locales.

2

Agrega Tu API Key

Pega tu API key. Las keys se guardan localmente en config.toml — nunca se envían a ningún lado excepto al proveedor de IA. También se soporta autenticación por suscripción (OpenAI Codex, Anthropic) con perfiles cifrados.

3

Conecta un Canal

Vincula Telegram (pega el token del bot), Discord (pega el token del bot), Slack (app de workspace), WhatsApp (código QR), o cualquiera de los 17+ canales soportados. Política de allowlist deny-by-default.

4

Inicia el Agente

Ejecuta 'zeroclaw agent -m "¡Hola!"' para una prueba rápida, 'zeroclaw daemon' para el runtime autónomo completo, o 'zeroclaw service install' para servicio en segundo plano.

.env — Toda la configuración se guarda en ~/.zeroclaw/config.toml. Edita directamente para cambiar proveedores, canales, backends de memoria, túneles y configuración de seguridad. Consulta docs/reference/README.md para la referencia completa.

system_update_alt Actualizar ZeroClaw

Mantén ZeroClaw al día para obtener las últimas funciones, integraciones y parches de seguridad.

Homebrew
$ brew upgrade zeroclaw
Cargo
$ cargo install zeroclaw --force
Git
$ cd zeroclaw && git pull && cargo build --release --locked
Docker
$ ./bootstrap.sh --docker --skip-build

Revisa el changelog en github.com/zeroclaw-labs/zeroclaw/releases para ver las novedades de cada versión.

build Solución de Problemas

Problemas comunes y cómo resolverlos.

¿Necesitas Ayuda?

Únete a nuestra comunidad para soporte de instalación y solución de problemas.

Mantente al Día

Recibe actualizaciones sobre nuevos lanzamientos, integraciones e infraestructura de agentes en Rust. Sin spam, cancela cuando quieras.