Tutorial de OpenClaw - Capítulo 2: Instalación paso a paso

Indice Tutorial >>

En este capítulo vamos a instalar OpenClaw en tu ordenador y dejarlo completamente configurado y funcionando. Da igual si usas Windows, macOS o Linux: en unos 15 minutos tendrás tu asistente listo para hablar con él.

Antes de empezar: ¿qué necesitas?

OpenClaw necesita dos cosas para funcionar:

Node.js versión 22 o superior: Es el motor que hace funcionar OpenClaw. Si no lo tienes, te enseño a instalarlo a continuación.
Una cuenta en un proveedor de IA: Te recomendamos DeepSeek (la opción más económica) o Gemini de Google. En el Paso 3 te enseñamos a configurar ambas opciones.

Paso 1: Instalar Node.js

Node.js es un programa que permite ejecutar aplicaciones JavaScript en tu ordenador. OpenClaw está construido con Node.js, así que es imprescindible.

En Windows

Ve a https://nodejs.org
Descarga la versión LTS (la que dice «Recommended for most users»)
Ejecuta el instalador y sigue los pasos (puedes dejar todo por defecto)
Cuando termine, abre el Símbolo del sistema (busca «cmd» en el menú inicio) y escribe:

node --version

Debería mostrarte algo como v22.x.x. Si ves un número 22 o superior, perfecto.

💡 ¿Por qué usamos el Símbolo del sistema (CMD) en lugar de PowerShell? PowerShell tiene restricciones de seguridad que pueden causar errores con algunos comandos. El Símbolo del sistema (CMD) es más sencillo y funciona sin problemas. Usaremos CMD para todos los pasos de este tutorial en Windows.

En macOS

Abre la aplicación Terminal (la encuentras en Aplicaciones > Utilidades, o buscando «Terminal» en Spotlight). Luego escribe:

brew install node

Si no tienes Homebrew instalado (es el gestor de paquetes más popular de macOS), instálalo primero con:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Alternativa: también puedes descargar el instalador desde https://nodejs.org igual que en Windows.

En Linux (Ubuntu/Debian)

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

Comprueba que se ha instalado correctamente:

node --version
npm --version

Paso 2: Instalar OpenClaw

Ya tienes Node.js. Ahora instalamos OpenClaw. Hay dos métodos:

Método 1: Instalador automático (recomendado para macOS y Linux)

Abre la terminal y ejecuta este comando:

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

Este script descarga e instala OpenClaw automáticamente. Solo tienes que esperar a que termine.

Método 2: Instalación con npm (recomendado para Windows)

Abre el Símbolo del sistema (en Windows) o la Terminal (en macOS/Linux) y ejecuta:

npm install -g openclaw@latest

El -g significa «global»: podrás usar OpenClaw desde cualquier carpeta.

💡 ¿Te sale un error de permisos? En Windows, cierra el Símbolo del sistema y ábrelo como Administrador: busca «cmd» en el menú inicio, haz clic derecho sobre «Símbolo del sistema» y selecciona «Ejecutar como administrador». Luego ejecuta el comando de nuevo.

Paso 3: Elegir y configurar tu modelo de IA

OpenClaw necesita un modelo de inteligencia artificial para «pensar» y responderte. Tienes dos opciones recomendadas para empezar, elige la que prefieras:

Opción A: DeepSeek (la más económica)

DeepSeek es una empresa china que ofrece modelos de IA de excelente calidad a precios ridículamente bajos. Con una recarga de solo 2$ (~2€) tendrás para meses de uso. En el momento de escribir este libro, es la opción con mejor relación calidad-precio del mercado.

Ve a https://platform.deepseek.com
Crea una cuenta (puedes usar tu email o cuenta de Google)
Ve a la sección «API Keys» y crea una nueva clave
Copia la clave (empieza por sk-...)
Ve a la sección «Top Up» y recarga un mínimo de 2$ (aceptan tarjeta de crédito/débito)
Guarda la clave en un lugar seguro

💡 ¿Por qué hay que recargar? DeepSeek no tiene plan gratuito, pero su precio es tan bajo que con 2$ puedes usar el asistente durante meses. Para que te hagas una idea: una conversación normal cuesta menos de 0,001€.

⚠️ Nota sobre privacidad: Tus datos pasan por servidores de DeepSeek en China. Si esto te preocupa, elige la Opción B (Gemini) o consulta el capítulo 6 para más alternativas.

Opción B: Google Gemini (alternativa)

Gemini es el modelo de IA de Google. Aunque tiene un plan gratuito limitado, en la práctica es probable que te pida activar la facturación para poder usar la API. El coste es bajo (similar a DeepSeek para uso ligero), y tiene la ventaja de estar respaldado por Google.

Ve a https://aistudio.google.com/api-keys
Inicia sesión con tu cuenta de Google
Haz clic en «Create API key»
Copia la clave (empieza por AIza...)
Guarda la clave en un lugar seguro

💡 Google puede pedirte que actives la facturación antes de poder usar la API. El coste depende del uso que hagas y de cómo OpenClaw gestione las peticiones internamente, así que revisa tu facturación en https://console.cloud.google.com/billing para no llevarte sorpresas. En el capítulo 6 explicamos todas las opciones en detalle.

En el capítulo 6 encontrarás una comparativa completa de todos los proveedores disponibles, incluyendo Claude de Anthropic, GPT de OpenAI y modelos locales con Ollama.

Paso 4: Configuración inicial

Vamos a configurar OpenClaw paso a paso. Ejecuta el asistente de configuración:

openclaw onboard --install-daemon

El asistente te irá guiando. Esto es lo que verás en cada paso:

4.1 — Aviso de seguridad

Lo primero que verás es un aviso de seguridad. OpenClaw te informa de que es un proyecto en fase beta y de que, por defecto, está pensado para uso personal (un solo usuario). Te recuerda que el bot puede leer archivos y ejecutar acciones si activas las herramientas.

No te preocupes: para uso personal (que es nuestro caso), la configuración por defecto es perfectamente segura. Simplemente selecciona «Yes» para continuar. En el capítulo de seguridad veremos cómo proteger tu asistente si decides exponerlo a internet o compartirlo con más personas.

4.2 — Modo de configuración

Te preguntará qué modo de configuración prefieres:

QuickStart: Configura lo esencial rápidamente. Podrás ajustar los detalles más adelante.
Manual: Te pregunta absolutamente todo paso a paso.

Selecciona QuickStart (debería estar ya seleccionado por defecto). Es más que suficiente para empezar.

4.3 — Configuración automática del Gateway

Al seleccionar QuickStart, verás un resumen de la configuración automática del Gateway:

Gateway port: 18789
Gateway bind: Loopback (127.0.0.1)
Gateway auth: Token (default)
Tailscale exposure: Off

No tienes que tocar nada aquí. OpenClaw configura automáticamente un token de seguridad y el Gateway solo escuchará en tu ordenador local (127.0.0.1), lo que significa que nadie de fuera puede acceder. Perfecto para empezar.

4.4 — Elegir el proveedor de IA

Te mostrará una lista de proveedores de IA.

Si elegiste DeepSeek (Opción A): Selecciona DeepSeek en la lista. Te pedirá tu clave API. Pega la clave que copiaste en el Paso 3. Cuando te pregunte el modelo, selecciona deepseek-chat.

Si elegiste Gemini (Opción B): Selecciona Google en la lista. Te pedirá tu clave API. Pega la clave que copiaste en el Paso 3. Cuando te pregunte el modelo, selecciona gemini-2.5-flash.

4.5 — Elegir canal de mensajería (Telegram)

OpenClaw te mostrará un resumen de todos los canales disponibles (Telegram, WhatsApp, Discord, Slack y muchos más) y te pedirá que elijas uno para configurar.

Selecciona Telegram (Bot API). Es la opción más fácil de configurar y te permitirá hablar con tu asistente desde el móvil.

Para crear tu bot de Telegram, sigue estos pasos:

Abre Telegram en tu móvil o en el ordenador
Busca @BotFather (es el bot oficial de Telegram para crear bots)
Dale al botón Start y escribe /newbot
Te pedirá un nombre para tu bot (por ejemplo: «Mi Asistente OpenClaw»)
Te pedirá un username que termine en «bot» (por ejemplo: mi_asistente_openclaw_bot). Tiene que ser único en todo Telegram.
BotFather te dará un token que se ve así: 123456789:ABCdefGhIjKlmNoPqRsTuVwXyZ
Copia ese token

De vuelta en el onboarding de OpenClaw, pega el token que acabas de copiar y pulsa Enter.

En los capítulos 4 y 5 veremos cómo configurar también WhatsApp, Discord y otros canales.

4.6 — Búsqueda web, skills y hooks

El onboarding te preguntará por varias funciones opcionales:

Search provider (búsqueda web): Selecciona «DuckDuckGo Search». Es gratuito, no requiere API key y funciona muy bien. Permitirá que tu asistente busque información en internet cuando lo necesite.
Configure skills (habilidades): Selecciona «No». Los skills son funciones avanzadas que veremos más adelante en el libro. Por ahora no los necesitas.
Hooks (automatizaciones): Selecciona «Skip for now».

Todas estas funciones se pueden activar más adelante y las veremos en detalle en los capítulos correspondientes.

4.7 — Permisos de red (solo macOS)

En macOS te aparecerá un aviso del sistema preguntando si quieres permitir que «node» acceda a la red local. Pulsa «Allow» (Permitir). Es necesario para que el Gateway funcione.

4.8 — Primer arranque

Por último, te preguntará cómo quieres arrancar tu asistente por primera vez. Selecciona «Hatch in TUI» (TUI es la interfaz de terminal). Se abrirá una ventana de chat directamente en tu terminal.

Escribe «Hola, ¿quién eres?» y espera la respuesta. Si te contesta, ¡tu asistente está funcionando!

Para salir del TUI, pulsa Ctrl+C.

Paso 5: Comprobar que el Gateway está funcionando

Si acabas de terminar el onboarding y seleccionaste «Hatch in TUI», tu asistente ya debería estar funcionando en la terminal. Si le escribiste algo y te contestó, ¡perfecto!

Si has cerrado la terminal o quieres asegurarte de que el Gateway sigue activo, puedes comprobarlo con:

openclaw status

Si el Gateway no está arrancado, inícialo con:

openclaw gateway install
openclaw gateway start

El primer comando lo registra como servicio del sistema. El segundo lo inicia ahora mismo.

Para volver a abrir el chat en la terminal en cualquier momento:

openclaw tui

Paso 6: Abrir la interfaz web

Además del chat en la terminal (TUI), OpenClaw incluye una interfaz web con panel de control completo. La forma más fácil de abrirla es con:

openclaw dashboard

Este comando abre tu navegador automáticamente con la autenticación ya incluida. Verás el panel de control de OpenClaw donde puedes chatear con tu asistente, ver las sesiones activas y gestionar la configuración.

Escribe un mensaje de prueba en el chat web: «Hola, ¿quién eres?». Si tu asistente te responde, ¡todo está funcionando perfectamente!

Nota: Si en algún momento intentas acceder directamente a http://127.0.0.1:18789 en el navegador, te pedirá un token de autenticación. Es más fácil usar siempre openclaw dashboard, que se encarga de todo automáticamente.

¿Dónde se guarda todo?

Es útil saber dónde guarda OpenClaw sus archivos:

Configuración principal: ~/.openclaw/openclaw.json
Credenciales: ~/.openclaw/credentials/
Espacio de trabajo: ~/.openclaw/workspace/

El símbolo ~ representa tu carpeta de usuario. En Windows sería C:\Users\TuNombre, en macOS /Users/TuNombre/ y en Linux /home/TuNombre/.

Actualizar OpenClaw

openclaw update

Solución de problemas comunes

«node: command not found» o «node no se reconoce»

Node.js no está instalado o no está en el PATH. Vuelve al Paso 1 e instálalo. En Windows, asegúrate de cerrar y volver a abrir el Símbolo del sistema después de la instalación.

«Permission denied» o error de permisos al instalar

En macOS/Linux, prueba con sudo npm install -g openclaw@latest. En Windows, abre el Símbolo del sistema como Administrador (clic derecho > «Ejecutar como administrador»).

«You have not agreed to the Xcode license» (macOS)

Abre la terminal y ejecuta:

sudo xcodebuild -license accept

Te pedirá tu contraseña de Mac. Una vez aceptada la licencia, vuelve a ejecutar npm install -g openclaw@latest.

El Gateway no arranca

Comprueba que el puerto 18789 no está siendo usado por otra aplicación. Inicia el gateway manualmente con openclaw gateway install seguido de openclaw gateway start.

Error de Telegram: «terminated by other getUpdates request»

Este error ocurre si usas el mismo token de bot en varios ordenadores a la vez. Cada instalación de OpenClaw necesita su propio bot de Telegram. Crea un bot nuevo con @BotFather (ve al paso 4.5) o detén OpenClaw en el otro ordenador.

Error de API: «rate limit», «insufficient balance» o «API key not valid»

Si ves un error de saldo insuficiente (insufficient balance) con DeepSeek, necesitas recargar saldo en https://platform.deepseek.com/top_up.

Si ves un error de límite de uso (rate limit) con Gemini, has superado el límite de tu plan. Espera unas horas o revisa tu facturación en https://console.cloud.google.com/billing.

Si la clave API no funciona, verifica que la clave está activa en la web de tu proveedor. Puedes crear una nueva si es necesario.

Resumen

En este capítulo has:

Instalado Node.js en tu sistema operativo
Instalado OpenClaw usando npm o el instalador automático
Obtenido una clave API de tu proveedor de IA (DeepSeek o Gemini)
Configurado tu asistente con el asistente de onboarding
Creado un bot de Telegram para hablar con tu asistente desde el móvil
Verificado que todo funciona desde la terminal y la interfaz web

En el próximo capítulo exploraremos en detalle las cosas que puedes hacer con tu asistente en tu primera conversación.

Apéndice A: Usar modelos locales con Ollama (avanzado)

⚠️ IMPORTANTE: OpenClaw necesita un mínimo de 16.000 tokens de contexto para funcionar como agente. Esto significa que los modelos locales necesitan MUCHA más memoria RAM que cuando los ejecutas directamente con Ollama. En ordenadores con 16 GB de RAM o menos, los modelos locales probablemente no funcionarán con OpenClaw (darán errores de memoria o tardarán demasiado). Para usar modelos locales con OpenClaw de forma fiable, necesitas al menos 32 GB de RAM.

Instalar Ollama

Ollama es un programa que te permite ejecutar modelos de IA en tu propio ordenador, como si fuera tu propio ChatGPT privado.

macOS: Descarga desde https://ollama.com/download, abre el archivo y arrastra Ollama a Aplicaciones.
Windows: Descarga el instalador desde https://ollama.com/download y sigue los pasos.
Linux: Ejecuta curl -fsSL https://ollama.com/install.sh | sh

Descargar y configurar el modelo

Una vez instalado Ollama, abre la terminal y descarga el modelo recomendado:

ollama pull qwen2.5:14b

Después, configura OpenClaw para usarlo:

openclaw config set agents.defaults.model.primary "ollama/qwen2.5:14b"

Y reinicia el gateway:

openclaw gateway restart

Requisitos de hardware

Hardware	Modelo recomendado	Funcionamiento con OpenClaw
16 GB RAM	No recomendado	Errores de memoria o tiempos de espera muy largos
32 GB RAM	qwen2.5:14b	Funciona correctamente
64 GB+ RAM o GPU	qwen2.5:70b / llama3:70b	Rápido, comparable a APIs en la nube

💡 Si tienes 16 GB de RAM y quieres privacidad total, puedes usar Ollama directamente desde la terminal (sin OpenClaw) para tareas puntuales. Ollama funciona perfectamente con modelos pequeños cuando se usa así. El problema es específico de OpenClaw, que necesita un contexto muy grande para gestionar todas sus herramientas y funcionalidades.

Apéndice B: Otros proveedores en la nube

Si prefieres usar otro proveedor en la nube además de DeepSeek y Gemini, aquí tienes otras alternativas populares. Necesitarás obtener una clave API del proveedor que elijas.

Anthropic Claude

Ve a https://console.anthropic.com
Crea una cuenta, ve a «Settings» > «API Keys»
Crea una clave y añade un método de pago en «Billing»

Coste: 2-5€/mes para uso ligero. Es el modelo más preciso para agentes.

Nota: Una suscripción a Claude Pro/Max (claude.ai) NO incluye acceso a la API. Son productos separados.

OpenAI GPT

Ve a https://platform.openai.com
Ve a «API keys», crea una clave y añade método de pago

Coste: Similar a Anthropic. Con GPT-4o mini, menos de 1€/mes para uso ligero.

Para configurar cualquiera de estos proveedores en OpenClaw, selecciona el proveedor correspondiente durante el onboarding (Paso 4.4) o cámbialo después desde la interfaz web en Configuración > Modelo de IA.

OpenClaw: Tu Asistente Personal con IA — portada del libro

¿Te está gustando el tutorial? Tienes el libro completo en Amazon

OpenClaw: Tu Asistente Personal con IA (248 páginas) incluye 22 capítulos, 8 de ellos exclusivos del libro (no publicados en el blog):

Multi-agente y configuración avanzada
Automatizaciones del mundo real: facturas, redes sociales y control de gastos
OpenRouter: modelos gratis y ultra-baratos
Llevar OpenClaw a un VPS: tu asistente en producción 24/7
Prompt injection y seguridad avanzada
…y 3 capítulos más sobre Gateway, Hooks/WebHooks y estrategia de modelos

Disponible en tapa blanda, tapa dura y edición Kindle.

Comprar en Amazon España

Amazon Internacional

Un saludo, y si aún no lo has hecho no olvides suscribirte a mi blog para no perderte los próximos posts :-),

También puedes seguirme en Twitter en ‎@revi_apps y no olvides que me ayudas mucho si compartes este post en las redes sociales.