First steps
Primeros pasos
Instala OpenClaw, ejecuta la incorporación y chatea con tu asistente de IA, todo en unos 5 minutos. Al final tendrás un Gateway en ejecución, autenticación configurada y una sesión de chat funcional.
Lo que necesitas
- Node.js: se recomienda Node 24 (también se admite Node 22.19+)
- Una clave de API de un proveedor de modelos (Anthropic, OpenAI, Google, etc.); la incorporación te la pedirá
Configuración rápida
Instalar OpenClaw
macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bashWindows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iexEjecutar la incorporación
openclaw onboard --install-daemonEl asistente te guía para elegir un proveedor de modelos, definir una clave de API
y configurar el Gateway. QuickStart suele tomar solo unos minutos, pero
el inicio de sesión del proveedor, el emparejamiento de canales, la instalación del daemon, las descargas de red, Skills
o los plugins opcionales pueden hacer que la incorporación completa tarde más. Puedes omitir los pasos opcionales
y volver más tarde con openclaw configure.
Consulta Incorporación (CLI) para ver la referencia completa.
Verificar que el Gateway esté en ejecución
openclaw gateway statusDeberías ver el Gateway escuchando en el puerto 18789.
Abrir el panel
openclaw dashboardEsto abre la Control UI en tu navegador. Si se carga, todo está funcionando.
Enviar tu primer mensaje
Escribe un mensaje en el chat de la Control UI y deberías recibir una respuesta de IA.
¿Quieres chatear desde tu teléfono en su lugar? El canal más rápido de configurar es Telegram (solo un token de bot). Consulta Canales para ver todas las opciones.
Avanzado: montar una compilación personalizada de la Control UI
Si mantienes una compilación localizada o personalizada del panel, apunta
gateway.controlUi.root a un directorio que contenga tus recursos estáticos
compilados e index.html.
mkdir -p "$HOME/.openclaw/control-ui-custom"# Copy your built static files into that directory.Luego configura:
{"gateway": { "controlUi": { "enabled": true, "root": "$HOME/.openclaw/control-ui-custom" }}}Reinicia el Gateway y vuelve a abrir el panel:
openclaw gateway restartopenclaw dashboardQué hacer a continuación
Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo y más.
Controla quién puede enviar mensajes a tu agente.
Modelos, herramientas, sandbox y ajustes avanzados.
Navegador, exec, búsqueda web, Skills y plugins.
Avanzado: variables de entorno
Si ejecutas OpenClaw como una cuenta de servicio o quieres rutas personalizadas:
OPENCLAW_HOME: directorio de inicio para la resolución de rutas internasOPENCLAW_STATE_DIR: sobrescribe el directorio de estadoOPENCLAW_CONFIG_PATH: sobrescribe la ruta del archivo de configuración
Referencia completa: Variables de entorno.