Instala y usa OpenClaw

Del terminal a tu primera respuesta

Vas a instalar OpenClaw, conectar un proveedor de IA y enviar un mensaje desde el panel del navegador. Empieza en tu ordenador. Cuando funcione, la sección opcional sobre servidores explica cómo mantenerlo activo en otra máquina.

01Instalar Pon OpenClaw en tu ordenador.02Conectar Elige la IA que te responderá.03Usar Abre el panel y recibe una respuesta.

Antes de empezar

Un Mac, PC con Windows u ordenador Linux con conexión a internet.
Acceso a un proveedor de IA. La configuración puede detectar sesiones compatibles o pedirte que conectes un proveedor. El uso de API puede facturarse por separado.
Un terminal y tiempo para completar el inicio de sesión. No necesitas una aplicación de mensajería para esta lección.

Ejecutarlo localmente no significa que la IA funcione sin conexión. OpenClaw se ejecuta en tu máquina; si eliges un modelo en la nube, las solicitudes se envían a ese proveedor. El ordenador también debe permanecer encendido y sin suspenderse.

Instala según tu sistema operativo

Abre Terminal en macOS o tu aplicación de terminal en Linux. Pega este comando y pulsa Intro.

Terminal

curl -fsSL https://openclaw.ai/install.sh | bash

El comando descarga y ejecuta el instalador oficial. Instala OpenClaw, comprueba Node.js e inicia la configuración. Documentación del instalador.

El instalador debería abrir la configuración inicial. Si termina sin hacerlo, ejecuta:

Terminal

openclaw onboard

Conecta tu proveedor de IA

Elige Custom setup para revisar las opciones de conexión y acceso. Selecciona una conexión detectada o sigue el inicio de sesión del proveedor elegido. Introduce credenciales solo en el flujo de acceso del proveedor o en el terminal de configuración local.

Espera a que termine la comprobación de conexión. Si falla, resuelve el problema de autenticación o de la cuenta antes de continuar. Tener el comando instalado no demuestra que la conexión con la IA funcione.

Revisa los permisos con atención: Quick start utiliza acceso completo actualmente. Los permisos dependen del modo de acceso, las herramientas y las integraciones que actives. Empieza con lo necesario y consulta la documentación de configuración y las recomendaciones de seguridad de herramientas antes de ampliar el acceso.

Abre el panel y recibe una respuesta

La configuración puede abrir el panel automáticamente. Para volver a abrirlo, ejecuta este comando en un segundo terminal mientras el Gateway sigue activo. El Gateway es el proceso que conecta el panel con tu agente.

Terminal

openclaw dashboard

Usa la dirección que proporciona el comando. La dirección local predeterminada es http://127.0.0.1:18789, pero el enlace generado tiene en cuenta tu configuración. Trata cualquier token de ese enlace como una contraseña.

En el chat, envía algo sencillo: “Responde con una frase confirmando que puedes leer este mensaje.” El resultado esperado es una respuesta real de la IA. Que el panel cargue es solo la primera comprobación.

Si el navegador no conecta, comprueba el servicio:

Terminal

openclaw gateway status

La guía del panel explica los detalles de autenticación y conexión.

Déjalo funcionando en segundo plano

Si el Gateway sigue ejecutándose en el terminal tras la configuración, Ctrl+C lo detiene sin borrar tus ajustes. Detén ese proceso e instala el servicio en segundo plano:

Terminal

openclaw gateway install
openclaw gateway status

Confirma que el estado indica un Gateway activo. Abre de nuevo el panel y envía otro mensaje. El servicio permite cerrar el terminal, pero no mantiene conectado un portátil suspendido. La guía de primeros pasos explica el servicio de cada plataforma.

Opcional: ejecútalo en un servidor Linux

Usa un servidor cuando necesites OpenClaw disponible con el portátil apagado. Necesitarás acceso SSH a un servidor Linux, una cuenta de usuario normal y tener en cuenta el coste del alojamiento. Si aún no tienes un servidor, empieza por la guía oficial de servidores Linux.

Conéctate al servidor y sigue los pasos de instalación Linux, configuración y servicio anteriores dentro de esa sesión SSH. Las credenciales del proveedor de tu portátil no están disponibles automáticamente en el servidor.

Mantén el Gateway limitado a la interfaz local y con autenticación activada. Desde un terminal en tu portátil, abre un túnel. Sustituye user y your-server por tus datos SSH:

Terminal · en tu portátil

ssh -N -L 18789:127.0.0.1:18789 user@your-server

Deja ese terminal abierto. Visita http://127.0.0.1:18789 en el portátil y autentícate con las credenciales del Gateway del servidor. Si una instalación local ya usa ese puerto, elige otro puerto local según la guía de acceso remoto. No necesitas exponer el puerto 18789 a internet.

¿Algo falla? Empieza por el síntoma

“Command not found”: vuelve a abrir el terminal tras instalar y ejecuta openclaw --version. Si sigue fallando, revisa la salida final del instalador.
El panel no conecta: ejecuta openclaw gateway status. Comprueba que la dirección corresponde a la máquina donde se ejecuta el Gateway.
El panel abre, pero el chat falla: comprueba la autenticación del proveedor, la disponibilidad del modelo y los límites de la cuenta. Revisa la conexión con openclaw onboard.

Para un diagnóstico más amplio, ejecuta el siguiente comando y lee los resultados antes de aplicar cambios. Consulta también la guía de solución de problemas.

Terminal

openclaw doctor

Has terminado cuando: el Gateway está activo, el panel conecta y has recibido una respuesta de la IA. Ya puedes conectar un canal de mensajería en la próxima lección.

Instala y usa OpenClaw

Del terminal a tu primera respuesta

Antes de empezar

Instala según tu sistema operativo

Conecta tu proveedor de IA

Abre el panel y recibe una respuesta

Déjalo funcionando en segundo plano

Opcional: ejecútalo en un servidor Linux

¿Algo falla? Empieza por el síntoma

Instala y usa OpenClaw

Comentarios