Instala OpenClaw: Guía rápida de configuración inicial

¿Me he quedado atascado? ¿Cuál es la forma más rápida de solucionarlo?

Usa un agente de AI local que pueda ver tu máquina. Esto es mucho más efectivo que preguntar en Discord, ya que la mayoría de los casos donde alguien “se queda trabado” son problemas de configuración local o del entorno que los ayudantes remotos no pueden inspeccionar.

Claude Code: https://www.anthropic.com/claude-code/
OpenAI Codex: https://openai.com/codex/

Estas herramientas pueden leer el repo, ejecutar comandos, inspeccionar logs y ayudarte a arreglar la configuración a nivel de máquina (PATH, servicios, permisos, archivos de autenticación). Dales acceso al source checkout completo mediante la instalación hackeable (git):

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

Empieza con estos comandos (comparte los resultados cuando pidas ayuda):

openclaw status
openclaw models status
openclaw doctor

¿Cuál es la forma recomendada de instalar y configurar OpenClaw?

El repo recomienda ejecutar desde el código fuente y usar el asistente de onboarding:

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

El asistente también puede compilar los assets de la UI automáticamente. Tras el onboarding, lo normal es ejecutar el Gateway en el puerto 18789.

Desde el código fuente (contribuidores/dev):

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build
openclaw onboard

¿Cómo abro el dashboard después del onboarding?

El asistente abre tu navegador con una URL del dashboard que ya incluye el token justo después del onboarding; también imprime el enlace completo (con el token) en el resumen. Mantén esa pestaña abierta; si no se abrió, copia y pega la URL que aparece en la terminal en esa misma máquina.

¿Cómo autentico el dashboard (token) en localhost o en remoto?

Localhost (misma máquina):

Abre http://127.0.0.1:18789/
Si te pide autenticación, ejecuta openclaw dashboard y usa el enlace con token (?token=...)

Fuera de localhost:

Tailscale Serve (recomendado): mantén el bind en loopback y ejecuta openclaw gateway --tailscale serve
Tailnet bind: ejecuta openclaw gateway --bind tailnet --token "<token>"
SSH tunnel: ssh -N -L 18789:127.0.0.1:18789 user@host

¿Qué runtime necesito?

Necesitas Node >= 22. Te recomiendo usar pnpm. No te recomiendo usar Bun para el Gateway.

¿Funciona en Raspberry Pi?

Sí. El Gateway es ligero: la documentación indica que 512MB-1GB de RAM, 1 núcleo y unos 500MB de disco son suficientes para uso personal. Una Raspberry Pi 4 puede ejecutarlo.

Si quieres un poco más de margen (logs, archivos multimedia u otros servicios), te recomiendo 2GB.

Consejo: una Pi pequeña o un VPS pueden alojar el Gateway, y puedes vincular nodes en tu portátil o móvil para usar la pantalla, cámara o canvas local.

¿Algún consejo para instalaciones en Raspberry Pi?

Usa un sistema operativo de 64 bits y mantén Node >= 22
Prefiere la instalación hackable (git) para que puedas ver los logs y actualizar rápido
Empieza sin channels ni skills, y luego ve añadiéndolos uno a uno
Si tienes problemas extraños con binarios, normalmente es un error de compatibilidad con ARM

Se queda bloqueado en “wake up my friend” / el onboarding no carga. ¿Qué hago?

Esa pantalla depende de que el Gateway esté accesible y autenticado.

Reinicia el Gateway:
Ventana de terminal
```
openclaw gateway restart
```

Revisa el estado y la autenticación:

openclaw status
openclaw models status
openclaw logs --follow

Si sigue colgado, ejecuta:
Ventana de terminal
```
openclaw doctor
```

¿Puedo migrar mi configuración a una máquina nueva (Mac mini) sin repetir el onboarding?

Sí. Copia el state directory y el workspace, luego ejecuta Doctor una vez:

Instala OpenClaw en la máquina nueva
Copia $OPENCLAW_STATE_DIR (por defecto: ~/.openclaw) desde la máquina antigua
Copia tu workspace (por defecto: ~/.openclaw/workspace)
Ejecuta openclaw doctor y reinicia el servicio Gateway

Eso mantiene la configuración, los perfiles de autenticación, las credenciales de WhatsApp, las sesiones y la memoria.

¿Dónde puedo ver las novedades de la última versión?

Revisa el changelog en GitHub: https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md

¿Cuál es la diferencia entre stable y beta?

Stable y beta son npm dist-tags, no líneas de código separadas:

latest = estable
beta = versión temprana para pruebas

Publicamos las versiones en beta, las probamos y, cuando funcionan bien, promocionamos esa misma versión a latest.

¿Cómo instalo la versión beta?

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta

Para una instalación modificable (git):

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

AI Setup Assistant

¿Cuánto tiempo toma la instalación y el onboarding?

Instalación: 2-5 minutos
Onboarding: 5-15 minutos, dependiendo de cuántos canales y modelos configures

¿Instalador bloqueado? ¿Cómo obtengo más información?

Vuelve a ejecutar el instalador con verbose output:

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

Windows dice “git not found” o “openclaw no se reconoce”

1) npm error spawn git / git not found

Instala Git for Windows y asegúrate de que git esté en tu PATH
Cierra y vuelve a abrir PowerShell, luego ejecuta el instalador de nuevo

2) openclaw no se reconoce después de instalar

Tu carpeta global bin de npm no está en el PATH
Revisa la ruta: npm config get prefix
Asegúrate de que <prefix>\bin esté en el PATH

Si buscas la configuración más estable en Windows, te recomiendo usar WSL2 en lugar de Windows nativo.

¿Cómo instalo OpenClaw en Linux?

Sigue la guía de Linux y luego ejecuta el asistente de onboarding:

Ruta rápida de Linux + instalación del servicio: Linux
Guía completa: Getting Started

AI Setup Assistant

Próximos pasos

¿Cómo instalo OpenClaw en un VPS?

Cualquier VPS Linux funciona. Instálalo en el servidor y luego usa SSH o Tailscale para acceder al Gateway.

Guías: Hetzner, Fly.io, exe.dev

¿Puedo pedirle a OpenClaw que se actualice solo?

Respuesta corta: es posible, pero no recomendable. El proceso de actualización puede reiniciar el Gateway (lo que corta la sesión activa) y requerir un git checkout limpio, o bien solicitar confirmaciones manuales. Es más seguro ejecutar las actualizaciones desde una terminal como operador.

openclaw update
openclaw update status
openclaw update --channel stable|beta|dev

¿Qué hace realmente el asistente de onboarding?

openclaw onboard te guía a través de:

Configuración de modelos/autenticación (Anthropic setup-token, OpenAI Codex OAuth, API keys, modelos locales)
Ubicación del Workspace y archivos bootstrap
Ajustes del Gateway (bind/puerto/auth/tailscale)
Providers (WhatsApp, Telegram, Discord, Signal, iMessage)
Instalación del daemon (LaunchAgent en macOS; unidad de usuario de systemd en Linux/WSL2)
Health checks y selección de skills

¿Necesito una suscripción a Claude o OpenAI para usarlo?

No. Puedes ejecutar OpenClaw con API keys (Anthropic/OpenAI/otros) o con modelos locales para que tus datos se queden en tu dispositivo. Las suscripciones son formas opcionales de autenticarse con esos proveedores.

¿Puedo usar la suscripción de Claude Max sin una API key?

Sí. Puedes autenticarte con un setup-token en lugar de una API key. Este es el camino para quienes usan la suscripción.

¿Cómo funciona la autenticación por setup-token de Anthropic?

El comando claude setup-token genera una cadena de token mediante el Claude Code CLI (no está disponible en la consola web). Puedes ejecutarlo en cualquier máquina. Elige Anthropic token (paste setup-token) en el wizard o pégalo con:

openclaw models auth paste-token --provider anthropic

¿Dónde encuentro un setup-token de Anthropic?

No está en la Anthropic Console. El setup-token se genera con el Claude Code CLI:

claude setup-token

Copia el token que aparece y luego elige Anthropic token (paste setup-token) en el wizard.

¿Por qué veo un error `HTTP 429: rate_limit_error` de Anthropic?

Tu cuota o límite de velocidad (rate limit) de Anthropic se ha agotado para el periodo actual. Si usas una suscripción de Claude, espera a que se reinicie el periodo o mejora tu plan. Si usas una API key de Anthropic, revisa el uso y la facturación en la Anthropic Console.

Consejo: configura un fallback model para que OpenClaw siga respondiendo mientras un proveedor tiene el límite excedido.

¿Es compatible AWS Bedrock?

Sí, a través del proveedor Amazon Bedrock (Converse) de pi-ai con manual config. Tienes que proporcionar las credenciales y la región de AWS en el host del Gateway y añadir una entrada del proveedor Bedrock en tu configuración de modelos.

¿Cómo funciona la autenticación de Codex?

OpenClaw admite OpenAI Code (Codex) mediante OAuth (inicio de sesión de ChatGPT). El asistente puede ejecutar el flujo de OAuth y establecerá el modelo predeterminado en openai-codex/gpt-5.2 cuando sea necesario.

¿Cómo configuro el OAuth de Gemini CLI?

Gemini CLI utiliza un plugin auth flow:

openclaw plugins enable google-gemini-cli-auth
openclaw models auth login --provider google-gemini-cli --set-default

¿Está bien usar un modelo local para chats casuales?

Normalmente no. OpenClaw necesita un contexto amplio y una seguridad sólida; las tarjetas pequeñas truncan y filtran información. Si no tienes otra opción, ejecuta la versión de MiniMax M2.1 más grande que puedas de forma local (LM Studio).

Advertencia seria: Los modelos más pequeños o cuantizados aumentan el riesgo de prompt-injection.

¿Tengo que comprar un Mac Mini para instalar esto?

No. OpenClaw funciona en macOS o Linux (Windows mediante WSL2). Un Mac mini es opcional; hay quien compra uno como host para tenerlo siempre encendido, pero un VPS pequeño, un servidor doméstico, una Raspberry Pi o hardware similar también sirven.

Solo necesitas un Mac para herramientas exclusivas de macOS. Para iMessage, usa BlueBubbles (recomendado).

¿Necesito un Mac mini para el soporte de iMessage?

Necesitas algún dispositivo con macOS que tenga la sesión iniciada en Messages. No tiene por qué ser un Mac mini; cualquier Mac funciona. Usa BlueBubbles (recomendado) para iMessage.

¿Puedo usar Bun?

No te recomendamos usar Bun. Hemos detectado errores en el tiempo de ejecución, sobre todo con WhatsApp y Telegram. Usa Node para que los Gateway sean estables.

Telegram: ¿qué pongo en `allowFrom`?

channels.telegram.allowFrom es el ID de usuario de Telegram de la persona que envía el mensaje (numérico, recomendado) o el @username. No es el nombre de usuario del bot.

Formas de encontrar tu ID:

Envía un mensaje directo a tu bot, luego ejecuta openclaw logs --follow y lee from.id
Llama a https://api.telegram.org/bot<bot_token>/getUpdates y lee message.from.id

¿Pueden varias personas usar un mismo número de WhatsApp con diferentes instancias de OpenClaw?

Sí, mediante multi-agent routing. Vincula el DM de WhatsApp de cada remitente a un agentId diferente. Así, cada persona tendrá su propio espacio de trabajo y almacenamiento de sesiones.

¿Puedo ejecutar un agente de “fast chat” y un agente de “Opus para programar”?

Sí. Usa multi-agent routing: asigna a cada agente su propio modelo predeterminado y luego vincula las rutas entrantes a cada uno.

¿Cuál es la diferencia entre la instalación hackable (git) y la instalación por npm?

Instalación hackable (git): descarga completa del código fuente, editable, ideal para colaboradores. Ejecutas las builds localmente y puedes parchear el código o la documentación.
Instalación npm: instalación global de la CLI, sin repositorio, ideal para “simplemente ejecutarlo”. Las actualizaciones llegan desde los dist-tags de npm.

¿Puedo cambiar entre las instalaciones de npm y git más adelante?

Sí. Instala la otra versión y luego ejecuta Doctor para que el servicio Gateway apunte al nuevo punto de entrada. Esto no borra tus datos, solo cambia la instalación del código de OpenClaw.

¿Debería ejecutar el Gateway en mi laptop o en un VPS?

Si quieres fiabilidad 24/7, usa un VPS. Si buscas la menor fricción y no te importa que el sistema se suspenda o se reinicie, ejecútalo de forma local.

Laptop (Gateway local)

Pros: sin costes de servidor y con acceso directo a tus archivos locales, además de contar con ventana de navegador en vivo.
Contras: la suspensión del equipo o las caídas de red causan desconexiones; las actualizaciones del OS y los reinicios interrumpen el proceso.

VPS / cloud

Pros: siempre encendido con una red estable, sin los problemas de suspensión de una laptop.
Contras: a menudo funcionan en modo headless (tendrás que usar capturas de pantalla) y solo permiten acceso remoto a los archivos.

¿Qué tan importante es ejecutar OpenClaw en una máquina dedicada?

No es obligatorio, pero se recomienda para mayor fiabilidad y aislamiento.

Host dedicado (VPS/Mac mini/Pi): siempre encendido y con menos interrupciones.
Laptop/desktop compartido: funciona perfectamente para pruebas y uso activo.

¿Cuáles son los requisitos mínimos del VPS y el OS recomendado?

OpenClaw es ligero:

Mínimo absoluto: 1 vCPU, 1GB RAM, ~500MB de disco.
Recomendado: 1-2 vCPU, 2GB RAM o más.

OS: usa Ubuntu LTS (o cualquier distribución moderna de Debian/Ubuntu).

¿Puedo ejecutar OpenClaw en una VM y cuáles son los requisitos?

Sí. Trata a una VM igual que a un VPS: necesita estar siempre encendida, ser accesible y tener suficiente RAM para el Gateway y cualquier canal que habilites.

Mínimo absoluto: 1 vCPU, 1GB RAM.
Recomendado: 2GB RAM o más.

Si usas Windows, WSL2 es la configuración de estilo VM más sencilla.

OpenClaw Expert

Sigues atascado?

Si esta pagina no resolvio tu caso, pregunta a OpenClaw Expert para pasos concretos.