guide beginner tutorial installation

OpenClaw 101: de cero a tu primer agente de IA en 15 minutos

OpenClaws.io Team

OpenClaws.io Team

@openclaws

March 6, 2026

7 min de lectura

OpenClaw 101: de cero a tu primer agente de IA en 15 minutos

¿Que es OpenClaw?

OpenClaw es un agente de IA de codigo abierto que se ejecuta en tu propia computadora. A diferencia de ChatGPT o Claude.ai, que viven en la nube y solo pueden hablar, OpenClaw vive en tu maquina y puede actuar — gestionando archivos, enviando mensajes, navegando por la web, controlando dispositivos de hogar inteligente y ejecutando automatizaciones de forma programada.

Interactuas con el a traves de las aplicaciones de chat que ya usas: WhatsApp, Telegram, Discord, Slack, iMessage y mas. Esta siempre encendido, siempre aprendiendo y siempre es tuyo.

Lo que necesitas

  • Una computadora: Mac, Windows (con WSL2) o Linux. Una Raspberry Pi tambien funciona.
  • Node.js 22 o superior: OpenClaw se ejecuta en Node.js.
  • Una clave API de IA: De Anthropic (Claude), OpenAI (GPT) o un modelo local via Ollama.
  • 10 minutos: Eso es genuinamente todo lo que toma.

Paso 1: Instalar Node.js

Si no tienes Node.js 22+, instalalo via nvm (Node Version Manager):

bash
# macOS / Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22

# Windows (use nvm-windows from github.com/coreybutler/nvm-windows)
nvm install 22
nvm use 22

Verifica: node --version deberia mostrar v22.x.x o superior.

Paso 2: Instalar OpenClaw

bash
npm install -g openclaw@latest

O con pnpm:

bash
pnpm add -g openclaw@latest

Verifica: openclaw --version deberia imprimir la version instalada.

Paso 3: Ejecutar el asistente de incorporacion

bash
openclaw onboard --install-daemon

El asistente te guia a traves de:

  1. 1.Configuracion de clave API: Pega tu clave API de Anthropic u OpenAI. Si quieres usar un modelo local, puedes configurar Ollama mas tarde.
  2. 2.Plataforma de chat: Elige que aplicacion de mensajeria conectar primero. WhatsApp es la opcion mas popular — escanearas un codigo QR para vincular tu cuenta.
  3. 3.Instalacion del daemon: El daemon mantiene OpenClaw ejecutandose en segundo plano, incluso despues de cerrar la terminal.

Paso 4: Di hola

Abre tu aplicacion de chat conectada (WhatsApp, Telegram, etc.) y envia un mensaje a tu agente:

> ¡Hola! ¿Que puedes hacer?

Tu agente respondera con un resumen de sus capacidades. Prueba algunas cosas:

  • "¿Que hora es en Tokio?"
  • "Resume este articulo: [pega una URL]"
  • "Recuerdame llamar a mama a las 6 PM manana"
  • "Busca en la web el ultimo lanzamiento de OpenClaw"

Paso 5: Personaliza tu agente

Establece su personalidad

Edita ~/.openclaw/agents/default/SOUL.md para definir el tono y las reglas de tu agente. Por ejemplo:

markdown
You are a helpful, concise assistant. Always confirm before deleting files or sending messages.

Instala skills

Los skills son plugins que le dan a tu agente nuevas habilidades:

bash
openclaw skill install web-search
openclaw skill install home-assistant
openclaw skill install github-integration

Explora los skills disponibles en el marketplace de ClawHub.

Accede a la interfaz web

OpenClaw incluye un panel web local:

bash
openclaw ui

Esto abre una interfaz en el navegador donde puedes ver el historial de conversaciones, gestionar skills, monitorear la actividad del agente y ajustar configuraciones.

Entendiendo la arquitectura

Tu (telefono/portatil)
    |
    v
Plataforma de chat (WhatsApp, Telegram, Discord...)
    |
    v
Gateway de OpenClaw (se ejecuta en tu maquina)
    |
    v
Modelo de IA (Claude, GPT, Ollama, etc.)
    |
    v
Skills y herramientas (sistema de archivos, web, APIs, hogar inteligente...)

Tus mensajes fluyen desde tu aplicacion de chat al gateway de OpenClaw en tu maquina. El gateway envia el mensaje a un modelo de IA para razonamiento, y luego ejecuta cualquier accion usando los skills instalados. La respuesta fluye de vuelta por el mismo camino.

Todo se ejecuta localmente excepto la inferencia del modelo de IA (a menos que uses Ollama para modelos locales).

Preguntas frecuentes de la primera semana

"¿Por que mi agente tarda en responder?" La primera respuesta despues de un inicio en frio toma unos segundos mientras el modelo de IA carga el contexto. Los mensajes siguientes en la misma conversacion son mas rapidos. Si las respuestas son consistentemente lentas, verifica tu conexion a internet con el proveedor de IA.

"¿Cuanto me va a costar?" El uso ligero (unas pocas conversaciones por dia) tipicamente cuesta $10-30/mes en tarifas de API. Puedes reducir los costos significativamente usando Claude Haiku o modelos locales para tareas simples.

"¿Puedo usarlo con multiples aplicaciones de chat a la vez?" Si. OpenClaw puede conectarse a WhatsApp, Telegram, Discord y otras plataformas simultaneamente. Los mensajes de todas las plataformas son manejados por el mismo agente.

"¿Es seguro?" OpenClaw se ejecuta en tu maquina y tu controlas todos los datos. Mantenlo actualizado, revisa los skills antes de instalarlos y sigue la guia de seguridad en docs.openclaw.ai/security.

Proximos pasos

Bienvenido a la comunidad de OpenClaw. Tu langosta esta lista.

Mantente al día

Recibe novedades sobre nuevas funciones e integraciones. Sin spam, cancela cuando quieras.