openclaw setup

openclaw setup es el punto de entrada del agente del sistema. En un sistema configurado, ejecutar openclaw setup sin opciones abre un chat interactivo de OpenClaw. En un sistema nuevo, se inicia el proceso de incorporación guiado. Use -m/--message para una solicitud o --baseline para inicializar las carpetas de configuración y del espacio de trabajo sin el asistente.

Orden de enrutamiento:

1. Cualquier opción de incorporación (--wizard, --baseline, espacio de trabajo, restablecimiento, modo no interactivo, flujo, modo, Gateway, daemon, omisión, importación, acceso remoto u opciones de autenticación) ejecuta la incorporación exactamente igual que openclaw onboard.
2. -m/--message o --yes ejecuta el agente del sistema.
3. Sin ninguna opción de enrutamiento, un sistema interactivo configurado abre OpenClaw. Un sistema nuevo ejecuta la incorporación. En un sistema configurado, --json muestra la descripción general del sistema incluso sin una TTY; una opción de incorporación mantiene el resumen JSON de la incorporación.

En el modo guiado, --workspace <dir> es el espacio de trabajo propuesto a OpenClaw; solo se conserva después de aprobar la propuesta. La configuración básica, clásica y no interactiva conserva el espacio de trabajo indicado mediante su flujo normal en una instalación nueva. Cuando se reasignaría una lista de agentes existente, el asistente clásico requiere confirmación explícita; la configuración no interactiva mantiene el espacio de trabajo actual de la flota y muestra una advertencia.

La detección de inferencia guiada se ejecuta en el host del Gateway en macOS o Linux. La CLI y la aplicación para macOS llaman al mismo detector administrado por el Gateway, que comprueba los modelos configurados, los inicios de sesión de CLI compatibles, las variables de entorno de claves de API y los modelos de Ollama o LM Studio ya instalados. Esta ejecución automática nunca descarga modelos locales. Los entornos de ejecución locales detectados se prueban automáticamente después de los candidatos de CLI y claves de API; cuando hay varios modelos locales disponibles, OpenClaw prefiere la familia de instrucciones con llamadas a herramientas más potente. El candidato seleccionado debe responder a una completación real antes de guardar la configuración de su proveedor y modelo. También se informa de las CLI instaladas de Gemini, Antigravity, Pi y OpenCode cuando no pueden utilizarse como ruta de inferencia reutilizable para la configuración guiada.

setup acepta los mismos indicadores de incorporación que openclaw onboard, incluidos los de autenticación (--auth-choice, --token, indicadores de claves de proveedor), Gateway (--gateway-port, --gateway-bind, --gateway-auth, --install-daemon), Tailscale (--tailscale), restablecimiento (--reset, --reset-scope), flujo (--flow quickstart|advanced|manual|import) y omisión (--skip-channels, --skip-skills, --skip-bootstrap, --skip-search, --skip-health, --skip-ui, --skip-hooks). Pase --tui para usar la misma vía alternativa de terminal que openclaw onboard --tui. Consulte Incorporación y Automatización de la CLI para ver la referencia completa de indicadores y ejemplos no interactivos. openclaw onboard --modern sigue siendo una entrada de compatibilidad para el mismo asistente de OpenClaw sujeto a la comprobación de inferencia.

Opciones

--classic y --non-interactive son mutuamente excluyentes: el modo clásico abre el asistente con solicitudes de entrada, mientras que la configuración no interactiva usa la ruta de automatización. En la incorporación interactiva, --remote-url y --remote-token rellenan previamente el paso del Gateway remoto y tienen prioridad sobre los valores remotos almacenados para esa ejecución. Cambiar la URL no reutiliza las credenciales almacenadas, a menos que también se proporcione un token. El token permanece oculto y utiliza el modo de almacenamiento de texto sin formato o SecretRef seleccionado por el asistente.

Modo básico

openclaw setup --baseline conserva el comportamiento anterior limitado al modo básico: crea los directorios de configuración, espacio de trabajo y sesión, y después termina sin ejecutar la incorporación. Acepta --workspace y controles de salida inocuos, pero rechaza las opciones explícitas de incorporación, Gateway, autenticación, restablecimiento o daemon en lugar de ignorarlas silenciosamente. Si una configuración existente no es válida, la configuración básica la conserva y solicita ejecutar openclaw doctor antes de volver a intentarlo.

Ejemplos

openclaw setupopenclaw setup -m "status"openclaw setup -m "restart gateway" --yesopenclaw setup --jsonopenclaw setup --wizardopenclaw setup --baselineopenclaw setup --workspace ~/.openclaw/workspaceopenclaw setup --import-from hermes --import-source ~/.hermesopenclaw setup --non-interactive --accept-risk --mode remote --remote-url wss://gateway-host:18789 --remote-token <token>

Notas

• Después de la configuración básica, ejecute openclaw onboard para realizar todo el recorrido guiado, openclaw configure para aplicar cambios específicos o openclaw channels add para añadir cuentas de canales.
• Si se detecta un estado de Hermes, la incorporación interactiva puede ofrecer la migración automáticamente. La incorporación mediante importación requiere una configuración nueva; use Migración para obtener planes de ejecución de prueba, copias de seguridad y el modo de sobrescritura fuera de la incorporación.

Contenido relacionado

• Referencia de la CLI
• Incorporación
• Incorporación (CLI)
• Primeros pasos
• Descripción general de la instalación