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; solo el paso opcional de Plugins es exclusivo de la CLI por ahora. Los pasos obligatorios deben completarse antes de que se pueda crear el agente; los pasos opcionales pueden omitirse.
| 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ó. |
| Complementos | opcional | Plugins de herramientas del registro de plugins, instalados y configurados al crear el agente. Solo en compilaciones con soporte de plugins WASM (plugins-wasm), y solo en el Inicio rápido de la CLI por ahora; consulta Plugins. |
| 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.
Complementos
Las compilaciones con soporte de plugins WASM añaden una fila Plugins opcional a la lista de verificación de la CLI, después de Peer groups. La fila solo aparece cuando el binario se compila con la función plugins-wasm. Los archivos de lanzamiento actuales se compilan sin ella, así que su lista de verificación no tiene fila de Plugins. Una compilación desde el código fuente con --preset full y la imagen de contenedor all-features sí la incluyen. Por ahora, solo el Inicio rápido de la CLI ofrece esta fila: el Inicio rápido de zerocode y de la pasarela web todavía no enumeran los plugins. Dejar la fila sin visitar no cambia nada.
Al abrir la fila se obtiene el índice del registro de plugins, el mismo que usa zeroclaw plugin search (define ZEROCLAW_PLUGIN_REGISTRY_URL para usar otro registro), y se listan todos los plugins de herramientas que ofrece el registro o que ya están en esta máquina, marcando los instalados. Si no se puede obtener el índice del registro, puedes reintentar o continuar sin plugins. Elegir plugins no descarga ningún paquete ni cambia la configuración. Abrir la fila solo escribe la caché del índice del registro en el directorio de datos, como hace zeroclaw plugin search, y crea el directorio de plugins si no existe.
Si Quickstart no pudo leer la sección [plugins] del archivo de configuración, porque esa sección o el archivo completo está mal formado, la fila lo indica en lugar de consultar el registro. No ofrece nada para elegir, y Crear no instala ningún plugin. Repara el archivo y vuelve a ejecutar Quickstart para instalar plugins.
Si el archivo de configuración fue escrito por una versión anterior de ZeroClaw, Crear se detiene antes de instalar cualquier plugin o crear el agente, e imprime el comando zeroclaw config migrate que actualiza el archivo, igual que lo hace zeroclaw plugin bind. Ejecuta ese comando y luego vuelve a ejecutar Inicio rápido. Guardar la configuración de los plugins en el archivo antiguo lo marcaría como actual sin trasladar sus ajustes anteriores, que las ejecuciones posteriores dejarían de leer.
Al elegir Create, Quickstart instala los plugins seleccionados antes de crear el agente. Primero revisa el resto de tus opciones y la configuración en la que se guardarán, de la misma forma en que lo hará el paso del agente, incluida la comprobación de autorización que ese paso ejecuta antes de escribir nada. Si el paso del agente las rechazaría, por ejemplo porque un perfil de permisos nombra un agente que ya no existe, Quickstart informa de los problemas y se detiene antes de descargar o escribir cualquier plugin. Después instala los plugins uno por uno, a través del mismo proceso que usa zeroclaw plugin install:
- Resuelve el paquete desde el registro y rechaza una entrada del registro que no tenga un digest
sha256para su archivo, antes de solicitar el archivo.zeroclaw plugin installverifica el digest solo cuando el registro lo indica; Quickstart lo exige. - Descarga y verifica el archivo, confirma que el manifiesto proporciona una herramienta, admite el paquete, comprueba que su entrada de configuración puede sembrarse y ejecuta la comprobación de carga en el momento de la instalación. Si alguno de estos pasos falla, Quickstart lo informa, no escribe nada para ese plugin y pasa al siguiente. La comprobación de la entrada de configuración falla, por ejemplo, cuando la configuración todavía contiene la entrada previa a 1.0 del plugin, nombrada solo con el nombre del paquete, que
zeroclaw plugin removeconserva:zeroclaw plugin installse niega a crear una entrada junto a ella, y Quickstart informa del mismo motivo antes de preguntar nada sobre el plugin. Quickstart no tiene--no-verify: para un plugin que falla la comprobación de carga, muestra el comandozeroclaw plugin install <name> --no-verify, que instala un plugin que el daemon luego omite al iniciarse. Ese comando es la CLI de plugins, no Quickstart: no hace ninguna pregunta sobre firma ni sobre acceso a la red, y una entrada de configuración que crea se siembra con los destinos que el manifiesto declara parahttp_client. - Muestra qué es el plugin y qué solicita: nombre, versión, autor, descripción, capacidades, permisos y los destinos de red que declara su manifiesto. El texto del editor se limpia de secuencias de control de terminal antes de mostrarse.
- Verifica la firma del manifiesto con
plugins.security.trusted_publisher_keys, sin importar el valor deplugins.security.signature_mode, y añade una línea al resumen: verificada, con los primeros 16 caracteres de la clave de confianza; sin firmar; firmada con una clave que no es de confianza; o inválida. Salvo que la firma esté verificada, la línea del autor se marca como una afirmación propia del editor, y Quickstart pregunta si instalar el plugin de todos modos, antes de cualquier otra pregunta sobre él. La respuesta predeterminada es no, lo que omite el plugin y no escribe nada.signature_modesigue decidiendo qué rechaza la admisión: en modostrict, un plugin así se rechaza en el paso 2 en su lugar. Cuando Quickstart puede leer el directorio de plugins, un plugin elegido que ya está instalado muestra la misma línea, sin la pregunta. - Para un plugin que solicita
http_clienty declara destinos, puedes elegir conceder los destinos declarados, instalar sin acceso a la red u omitir el plugin. La elección comienza en instalar sin acceso a la red, por lo que aceptarla tal como se ofrece no concede nada. Instalar sin acceso a la red crea la entrada de configuración del plugin conegress_hostsvacío, por lo que el plugin no alcanza ningún destino, e imprime el comandozeroclaw config setexacto que concederá más adelante los destinos declarados. Es la decisión quezeroclaw plugin bind --egress noneregistra para una instancia de canal, y imprime el mismo comando. Un plugin que solicita acceso a la red pero no declara destinos no recibe ninguna pregunta; tras instalarlo, Quickstart imprime un comandozeroclaw config set --no-interactiveparaegress_hostsde la entrada sin valor: añade los hosts que usa tu despliegue como un único valor separado por comas. Ejecutado tal como se imprime, ese comando se rechaza por falta de valor y no escribe nada. Un plugin que declara destinos y solicitawebsocket_clientosocket_client, pero nohttp_client, tampoco recibe ninguna pregunta: su entrada de configuración no concede ninguno de ellos, y Quickstart imprime el comandozeroclaw config setque concede exactamente esos destinos. - Para un plugin cuyo manifiesto tiene un
config_schema, Quickstart solicita los ajustes que describe el esquema: primero las propiedades obligatorias y las opcionales solo si lo pides. Las propiedades marcadas conx-secretse enmascaran mientras escribes, y se eliminan los espacios o saltos de línea alrededor de un valor secreto, igual que hacezeroclaw config set. Un valor elegido de una lista se guarda exactamente como lo indica el esquema, incluida una cadena vacía, mientras que una respuesta escrita vacía deja sin definir un ajuste opcional. Los valores se comprueban contra el esquema antes de escribir nada; tras una comprobación fallida tienes un intento más y, después, Quickstart pregunta si quieres instalar el plugin sin ellos. Pulsar Esc en un ajuste obligatorio que sea secreto o se elija de una lista omite el plugin. Quickstart solo solicita propiedades cuyos nombres estén en la gramática portable de claves (hasta 128 letras, dígitos,.,-y_ASCII). Los demás se indican para que puedas definirlos más tarde conzeroclaw config set. Cuando una propiedad obligatoria es una de ellas, o un nombre que el esquema exige sin declararlo, ninguna respuesta podría superar la comprobación; por eso Quickstart no pide ajustes y pasa directamente a preguntar si quieres instalar el plugin sin ellos. Cuando el esquema exige un nombre que no declara, ninguna entrada de configuración puede satisfacerlo, sea lo que sea lo que escribazeroclaw config set; por eso esa pregunta indica que la herramienta del plugin no sería utilizable y pregunta si aun así quieres instalarlo. - Publica el paquete y crea su entrada de configuración inicial en la misma transacción que usa
zeroclaw plugin install, y luego guarda los ajustes de la misma forma quezeroclaw config set. Si falla la creación de la entrada, la transacción vuelve a eliminar el paquete. Si esa eliminación también falla, Quickstart indica que el plugin sigue instalado e imprime el comandozeroclaw plugin removecorrespondiente. Si falla el guardado de los ajustes, el plugin permanece instalado y Quickstart imprime el comandozeroclaw config setpara cada ajuste, que solicita el valor. Un plugin que también proporciona un canal recibe lo quezeroclaw plugin installmuestra para él: los comandoszeroclaw plugin bindque vinculan una instancia, o el estado de preparación de los alias que ya vinculan el paquete. Quickstart no vincula por sí mismo ninguna instancia de canal.
Los valores que escribes para los ajustes que no están marcados como x-secret se muestran en la pantalla al escribirlos, y en ese lugar se precarga un valor predeterminado del esquema. Los valores de los ajustes nunca se escriben en los registros ni en las líneas de estado que imprime Quickstart; estas solo nombran los ajustes.
Un plugin que ya está instalado no se descarga, no se actualiza y no se le vuelven a pedir los ajustes. Quickstart solo crea su entrada de configuración cuando esa entrada falta. Una entrada nueva equivale a una nueva concesión, así que, para un plugin que solicita http_client y declara destinos, primero se muestra qué es el plugin y se toma la misma decisión que en una instalación nueva: conceder los destinos declarados, crear la entrada sin acceso a la red o omitirla. Al omitirla, la entrada no se crea y se imprime el comando que la creará más adelante. Ese comando crea la entrada sin acceso a la red. El comando que concede los destinos declarados se imprime en su propia línea, para ejecutarlo después, de modo que ejecutar un comando impreso nunca conceda lo que se rechazó. Cualquier otra entrada que falte se inicializa igual que lo hace zeroclaw plugin install. Una entrada existente nunca se modifica, pertenezca a un plugin instalado o haya quedado de una instalación anterior, de modo que su concesión de salida a la red y sus ajustes permanecen exactamente como están. Por tanto, ejecutar Quickstart de nuevo con las mismas selecciones no descarga nada y deja esas entradas intactas. Si Quickstart no puede completar la configuración de un plugin que ya está instalado, por ejemplo porque la configuración aún contiene una entrada anterior a la 1.0 que solo lleva el nombre del paquete, o porque falla el guardado de la nueva entrada, no escribe nada para ese plugin e indica que el plugin sigue instalado, junto con el motivo.
Tras el último plugin, si al menos uno de los plugins seleccionados está instalado y plugins.enabled o plugins.auto_discover está desactivado, Quickstart pregunta una sola vez si se debe activar la activación de plugins. Primero muestra qué ajustes cambiarían y todo lo que quedaría activo como resultado: cada plugin de herramientas y de skills instalado, incluidos los instalados antes de esta ejecución y, cuando plugins.enabled está desactivado, cada canal [channels.plugin.<alias>] habilitado. La lista se lee del directorio de plugins, tal como lo cargaría un daemon en su próximo inicio, por lo que también incluye un plugin cuya instalación fallida no pudo deshacerse. Cada plugin listado cuya firma no esté verificada va seguido de su línea de firma del paso 4, incluso si es un plugin que esta ejecución no seleccionó. La respuesta por defecto es sí cuando la lista coincide con los plugins que esta ejecución instaló o conservó, y no cuando activaría cualquier otra cosa, incluido un plugin instalado cuya entrada de configuración faltante se omitió a propósito o que Quickstart no pudo terminar de configurar. Si no se puede leer el directorio de plugins, Quickstart indica que la lista podría estar incompleta y la respuesta por defecto es no. Si se rechaza, ambos ajustes permanecen sin cambios y se imprimen los comandos zeroclaw config set que los activarán más adelante. Cuando ambos ajustes ya están activados, no hay nada que preguntar.
Una vez creado el agente, Quickstart muestra el estado de cada plugin seleccionado que está instalado: admitido como herramienta, con su clave de entrada de configuración, o el motivo por el que no se admite, como que plugins.enabled o plugins.auto_discover estén desactivados o que se haya alcanzado el límite de plugins.max_active_instances. Un plugin solo se informa como admitido cuando su entrada de configuración supera la comprobación de ajustes que el runtime aplica en cada llamada. Admitido todavía no significa registrado: el registro de herramientas registra el plugin la próxima vez que se construya, y sigue rechazando un paquete cuyo nombre coincida con una herramienta ya registrada, como una herramienta integrada, o cuya descripción de herramienta no pueda leer. El log del runtime registra esos rechazos. Cuando la comprobación de ajustes falla, por ejemplo si instalaste el plugin sin sus ajustes obligatorios, su estado muestra el motivo que indica la comprobación, nombra los ajustes obligatorios que faltan e imprime el comando zeroclaw config set que solicita cada valor. Quickstart solo imprime comandos para nombres de ajustes que cumplen la gramática portable de claves, que son seguros de mostrar y de pegar en una shell. Un ajuste obligatorio con cualquier otro nombre se menciona sin comando: establécelo en el archivo de configuración o con un comando zeroclaw config set que entrecomillarás tú mismo. Un nombre obligatorio que el esquema del plugin no declara también se menciona, ya que ninguna entrada de configuración puede satisfacer ese esquema hasta que el editor del plugin lo corrija. Un plugin cuya entrada de configuración falta, por ejemplo porque omitiste crearla, tampoco se informa como activo: zeroclaw config set solo modifica entradas que ya existen, así que su estado imprime en su lugar el comando que crea la entrada. Ese comando no concede acceso a la red; para un plugin que solicita http_client y declara destinos, una línea aparte muestra el comando que concede esos destinos una vez que la entrada existe. Cuando la configuración todavía contiene la entrada pre-1.0 del plugin, nombrada solo por el paquete, su estado no imprime ninguno de los dos comandos, ya que una entrada nueva junto a la antigua dejaría los ajustes y la concesión de red de la entrada antigua en vigor. En su lugar indica la clave de instancia a la que debes renombrar la entrada antigua. Cuando zeroclaw plugin list imprime los pasos de actualización de esa entrada, lo cual ocurre con un plugin que solicita http_client salvo que la configuración del despliegue rechace la concesión de red de todos los plugins, el estado también indica ese comando: sus pasos incluyen cualquier concesión de red que la entrada renombrada aún necesite. Un plugin sin nada que configurar y sin acceso a la red no necesita entrada de configuración.
Un plugin seleccionado que ya estaba instalado puede no haber pasado nunca la comprobación de carga, por ejemplo cuando se instaló con zeroclaw plugin install --no-verify, por lo que Quickstart ejecuta la comprobación que realiza zeroclaw plugin info antes de informar del plugin. Cuando el plugin no se carga en este host, ZeroClaw lo omite al iniciar, por lo que su estado lo indica en lugar de mostrarlo como activo, y muestra el comando zeroclaw plugin info que indica el motivo.
Quickstart escribe el archivo de configuración y nunca notifica a un daemon en ejecución. Un daemon que ya está en ejecución conserva la configuración que cargó, por lo que las entradas de configuración, los ajustes, las concesiones de red y los cambios de activación de plugins que escribe una ejecución de Quickstart solo llegan a él después de que se reinicie o recargue su configuración. Si la activación de plugins ya estaba habilitada en la configuración que cargó el daemon, este puede cargar un plugin recién instalado antes, la próxima vez que construya su registro de herramientas (por ejemplo, para una nueva sesión). Entonces ejecuta el plugin con la entrada de configuración que cargó para ese plugin, nunca con una que haya escrito la ejecución: si no existe ninguna, el plugin no tiene ajustes ni concesión de red, y una entrada anterior, como la que zeroclaw plugin remove conservó de una instalación previa, se aplica con sus ajustes y su concesión de red. El mensaje de estado termina con el comando zeroclaw service restart, dirigido al mismo directorio de configuración, que reinicia un daemon que se ejecuta como servicio instalado. zeroclaw agent y otros comandos de una sola ejecución recogen los cambios la próxima vez que se inician.
Ctrl+C no funciona igual en todo el paso de plugins. En un ajuste secreto funciona como Esc: en un ajuste obligatorio cancela la configuración de ese plugin, de modo que el plugin se omite, y en un ajuste opcional deja el ajuste sin definir. Quickstart continúa después. En cualquier otra parte del paso, Ctrl+C termina Quickstart de inmediato, sin un resumen de lo que ya había hecho. Un plugin cuya instalación terminó permanece instalado y configurado, y zeroclaw plugin list lo muestra. Un plugin interrumpido después de su instalación, pero antes de que se escribiera su entrada de configuración, permanece instalado sin esa entrada; al volver a ejecutar Quickstart con la misma selección se crea la entrada, pidiendo confirmación antes si concedería destinos de red.
Si el paso del agente sigue fallando después de que el paso de plugins haya cambiado algo, Quickstart no afirma que nada cambió. Indica los plugins que siguen instalados, configurados o activados, e imprime el comando zeroclaw plugin remove para cada plugin que esta ejecución instaló, incluido uno cuya instalación fallida no pudo revertirse y que por eso permanece en el directorio de plugins. Volver a ejecutar Quickstart no los reinstala.
La hoja de ruta de arquitectura (FND-001, RFC #5574, entregable D4) pide que zeroclaw onboard instale plugins. zeroclaw quickstart, el comando mantenido al que ahora apunta zeroclaw onboard, cumple eso para los plugins de herramientas, en compilaciones con soporte de plugins. Instalar plugins de canal durante el onboarding y publicar artefactos de versión con soporte de plugins son entregables independientes.
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 |
También puedes elegir » Quickstart en la barra lateral del agente. Al pulsar Esc se vuelve al panel desde el que se abrió Quickstart, ya sea que hayas entrado desde la barra de modos del teclado, haciendo clic en la barra de modos o desde el lanzador de la barra lateral.
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.