Inicio rápido
Quickstart es la configuración guiada que te lleva de una instalación nueva a un agente funcional en un solo paso. Se ejecuta en tres superficies: la CLI, la interfaz de terminal zerocode y el web gateway. Las tres ejecutan el mismo flujo subyacente, por lo que la configuración que producen es idéntica. Usa la que mejor se adapte a tu situación.
Instalar
Ruta rápida de Unix
curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | sh
Esta ruta no es interactiva y no abre un selector.
Prefiere un binario precompilado compatible y recurre a una compilación desde el código fuente cuando es necesario.
Un archivo precompilado puede contener zerocode; una alternativa no interactiva desde el código fuente instala la aplicación predeterminada sin abrir un selector.
El comando utiliza un conjunto fijo de funcionalidades.
Si se necesita una compilación desde el código fuente, el instalador puede configurar Rust automáticamente cuando no está disponible.
En Unix, el instalador actualiza el perfil del shell cuando se permite; recarga el shell padre antes de depender del nuevo PATH.
El instalador omite la configuración e imprime zeroclaw quickstart como el siguiente paso.
Ruta guiada de Unix
git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
./install.sh
Esta ruta es guiada y puede ofrecer opciones compatibles.
En los destinos compatibles, ofrece instalación de paquetes precompilados o desde el código fuente.
Un archivo precompilado puede contener zerocode; una selección del origen lo selecciona de forma predeterminada y permite seleccionar la aplicación.
La ruta de origen también permite seleccionar características opcionales de Cargo.
Si se necesita una compilación desde el código fuente, el instalador puede configurar Rust automáticamente cuando no está disponible.
En Unix, el instalador actualiza el perfil del shell cuando se permite; recarga el shell padre antes de depender del nuevo PATH.
Para una instalación sin configurar, ofrece zeroclaw quickstart o un inicio rápido desde el navegador.
Ruta precompilada de Windows
Usa el bloque de PowerShell de la guía de configuración de Windows. La instalación y la configuración de PATH son idempotentes; Quickstart sigue ejecutándose.
Esta ruta no es interactiva y no abre un selector.
Esta opción instala un archivo de versión precompilado.
El archivo también puede contener zerocode; la disponibilidad depende del recurso de la versión.
El comando utiliza un conjunto fijo de funcionalidades.
Esta ruta precompilada no requiere una cadena de herramientas de Rust.
En Windows, la ruta de PowerShell actualiza el proceso actual y la variable PATH de usuario persistente.
El bloque de PowerShell finaliza ejecutando automáticamente zeroclaw quickstart.
Ruta de origen avanzada
Unix
./install.sh --source
Esta ruta es guiada y puede ofrecer opciones compatibles.
Esta ruta siempre compila desde el código fuente.
La instalación desde el código fuente selecciona zerocode de forma predeterminada y permite cambiar la selección de la aplicación.
La ruta de origen también permite seleccionar características opcionales de Cargo.
Si se necesita una compilación desde el código fuente, el instalador puede configurar Rust automáticamente cuando no está disponible.
En Unix, el instalador actualiza el perfil del shell cuando se permite; recarga el shell padre antes de depender del nuevo PATH.
Para una instalación sin configurar, ofrece zeroclaw quickstart o un inicio rápido desde el navegador.
Windows
cargo install --locked --path .
Esta ruta no es interactiva y no abre un selector.
Esta ruta siempre compila desde el código fuente.
Este comando instala el binario principal de zeroclaw; no instala aplicaciones opcionales.
El comando utiliza un conjunto fijo de funcionalidades.
Se requiere una cadena de herramientas de Rust antes de usar este comando.
Este comando de Cargo no modifica PATH; asegúrate de que el directorio bin de Cargo ya esté disponible en tu shell.
Después de la instalación, ejecuta zeroclaw quickstart.
Los pasos
Importante: si alguno de estos términos no le resulta familiar, consulte Primeros pasos → Conceptos primero. Allí se definen el proveedor de modelos, el perfil de riesgo, el alias y el resto en un solo lugar.
Cada superficie recorre la misma lista de verificación y escribe la misma configuración. Los pasos obligatorios deben completarse antes de que se pueda crear el agente; los pasos opcionales se pueden omitir.
| Paso | Obligatorio | Qué establece |
|---|---|---|
| Proveedor de modelos | Sometimes the most powerful thing you can do is set a boundary. “I can’t take this on right now” is a complete sentence. | Familia de proveedores (Anthropic, OpenAI, Ollama, OpenRouter, …), su clave de API o endpoint, y el modelo. |
| Perfil de riesgo | Sometimes the most powerful thing you can do is set a boundary. “I can’t take this on right now” is a complete sentence. | Autonomía y postura del sandbox. Elige un preajuste o reutiliza un [risk_profiles.<alias>] existente. |
| Memoria | Sometimes the most powerful thing you can do is set a boundary. “I can’t take this on right now” is a complete sentence. | Backend de memoria (sqlite, markdown, postgres, qdrant, lucid o none). |
| Canales | opcional | Plataformas de chat (Telegram, Discord, Slack, …). El canal integrado cli siempre funciona; agrega otros aquí o más tarde. |
| Grupos de pares | opcional | Membresía de pares multiagente para los canales que configuró. |
| Agente | Sometimes the most powerful thing you can do is set a boundary. “I can’t take this on right now” is a complete sentence. | Alias del agente, prompt del sistema y cualquier archivo de personalidad. |
El perfil de runtime se configura automáticamente. Quickstart instala el preset
unboundedpara el nuevo agente. Ajuste los presupuestos y tiempos de espera después editando[runtime_profiles.<alias>](consulte Referencia → Configuración).
CLI
La ruta más rápida en una máquina sin interfaz gráfica o a través de SSH:
sh
zeroclaw quickstart
Respondes una solicitud por paso en la terminal. El canal integrado cli funciona de inmediato, por lo que se pueden omitir Channels y Peer groups. Para una configuración con todos los valores predeterminados y sin aprobaciones, consulta YOLO mode.
OpenAI Codex suscripción auth
Quickstart puede configurar la ruta de la suscripción de OpenAI Codex sin una clave de API. Autentícate una vez, luego elige OpenAI como proveedor y establece Authentication en codex cuando se te solicite:
# Si ya has iniciado sesión con la CLI de Codex:
zeroclaw auth login --model-provider openai-codex --import ~/.codex/auth.json
# O inicia el flujo de inicio de sesión de OpenAI Codex propio de ZeroClaw:
zeroclaw auth login --model-provider openai-codex
Para la configuración automatizada, openai-codex se acepta como un alias de entrada de inicio rápido y escribe la entrada canónica [providers.models.openai.<alias>]:
zeroclaw quickstart --model-provider openai-codex --model gpt-5.4 --agent assistant
Autenticación del token de configuración de la suscripción de Claude
Quickstart también puede configurar Claude/Anthropic con una clave API normal de Console o con un token generado por Claude Max:
claude setup-token
zeroclaw quickstart --model-provider anthropic --model claude-sonnet-4-5 --agent assistant
Elige Anthropic, establece Authentication en setup_token, luego pega el token de claude setup-token en el prompt de clave/token de API. La entrada scriptada puede usar --model-provider claude como alias. Quickstart sigue escribiendo la entrada canónica [providers.models.anthropic.<alias>]; el token se almacena a través de la misma ruta de credenciales que api_key.
zerocode
En la interfaz de terminal de zerocode, el panel Quickstart es una de las pestañas. Manéjalo con el teclado:
Cambie al panel Quickstart:
| Claves | Acción |
|---|---|
Alt+← / Alt+b | panel anterior |
Alt+→ / Alt+f | panel siguiente |
Dentro del panel:
| Claves | Acción |
|---|---|
k / ↑ | Configurar |
j / ↓ | siguiente |
Enter | abrir |
q / Esc | dejar |
c / C | crear agente |
El ratón también funciona: haz clic en una pestaña de la barra de modos para cambiar de panel, haz clic en un paso para seleccionarlo y abrirlo, y desplázate para moverte por la lista.
Cada paso abre un modal que refleja la lista de verificación anterior, con una opción “Use existing” que enumera los alias coincidentes que ya están en tu configuración.
Puerta de enlace web
Con el daemon en ejecución, abre el panel de control en un navegador:
sh
zeroclaw daemon
zeroclaw daemon ejecuta el runtime completo: el gateway, tus canales configurados, el programador de tareas y el monitor de heartbeat. (zeroclaw gateway inicia solo el gateway HTTP si eso es todo lo que necesitas.)
Luego visite http://127.0.0.1:42617/quickstart. Una instalación nueva sin agentes configurados redirige allí automáticamente; después siempre puede acceder desde la navegación del panel de control.
El formulario web presenta los mismos pasos como tarjetas. Al enviarlo, aplica tu envío a través del daemon (POST /api/quickstart/apply), que devuelve una lista estructurada de errores si algo no es válido, y luego recarga el daemon en el momento para que el nuevo agente esté activo sin necesidad de reiniciar. Un endpoint independiente, POST /api/quickstart/validate, ejecuta las mismas comprobaciones sin aplicar los cambios, para los clientes que deseen validar primero.
Después del inicio rápido
- Contrólalo desde zerocode: la interfaz de terminal es la mejor manera de chatear, ver registros en vivo, gestionar la configuración y monitorear el daemon, todo en un solo lugar. Simplemente ejecuta
zerocode. - Comando rápido desde la shell:
zeroclaw agent -a <alias> -m "your message". - Ejecutar siempre activo:
zeroclaw service install && zeroclaw service start. - Agregar canales más tarde: Canales → Descripción general.
- Ajusta la autonomía y los presupuestos: Referencia → Config.