Guía paso a paso: Tu primer agente de IA desde cero

Has escuchado maravillas de los Asistentes IA y quieres empezar sin programar ni volverte loco. El truco es usar suites de un solo clic (todo-en-uno) que traen interfaz preconfigurada como Jan.ai o LM Studio.

Descargas el programa, seleccionas un modelo "ligero" (como Mistral) y a probar se ha dicho. Adiós tutoriales densos e instalaciones de librerías extrañas.

Aviso a navegantes: Si tu ordenador no tiene al menos 16GB de memoria RAM (o una gráfica de mínimo 8 GB VRAM), tu agente va a tardar 30 segundos en teclear cada puñetera palabra. No es culpa de la IA, ¡es falta de "motor" hardware puro y duro!

Cuidado de novato: NUNCA pongas contraseñas reales ni datos de tu empresa en una herramienta de IA open source a menos que estés 100% seguro de que no tiene activada una opción de telemetría o envíos de tokens por internet a servidores del fabricante del programa.

Aquí está la pregunta que todos tienen: ¿Jan.ai, LM Studio u OpenClaw? La respuesta depende de tu objetivo real.

Jan.ai — interfaz todo-en-uno para chat local. Descargas el instalador, seleccionas un modelo y ya tienes una interfaz tipo ChatGPT en tu máquina. Ideal si solo quieres chatear con un LLM sin automatizaciones.

• Pros: instalación sin terminal, interfaz visual limpia, sin configuración
• Contras: no tiene canales de mensajería, no automatiza nada, uso puramente manual

LM Studio — similar a Jan.ai pero con más opciones de ajuste fino de parámetros (temperatura, top_p, contexto). Perfecto si quieres experimentar con diferentes modelos y parámetros.

• Pros: control granular del modelo, muy buena UI para explorar opciones, compatible con API local
• Contras: tampoco automatiza, no habla por WhatsApp ni Telegram, es una herramienta de exploración más que de producción

OpenClaw — el paso lógico cuando quieres que el agente haga algo más que responder preguntas. Lo instalas una vez, lo conectas a WhatsApp o Telegram, y tienes un asistente que trabaja solo.

• Pros: multi-canal (WhatsApp, Telegram, Slack, Discord), automatizaciones nativas (cron, webhooks), comunidad enorme, documentación completa
• Contras: necesitas Node.js 22+, unos minutos de configuración inicial, no tiene interfaz visual propia (hablas por tus apps de siempre)

Veredicto directo: Si quieres explorar sin comprometerte, empieza por Jan.ai o LM Studio. Si tu objetivo es tener un asistente que trabaje por ti en tus canales habituales, ve directamente a OpenClaw — el tiempo de configuración inicial se recupera en la primera semana.

Vamos al grano. Esto es lo que ejecutas en la terminal para tener OpenClaw funcionando:

# Paso 1: verifica que tienes Node 22 o superior
node --version
# Debe mostrar v22.x.x o superior. Si no, descarga Node desde nodejs.org

# Paso 2: instala OpenClaw globalmente
npm install -g openclaw@latest

# Paso 3: arranca el wizard de configuración (esto te guía por TODO)
openclaw onboard --install-daemon

# Paso 4: conecta tu primer canal (elige WhatsApp o Telegram en el wizard)
# El wizard muestra un QR para WhatsApp o un token para Telegram

# Paso 5: verifica que todo funciona
openclaw doctor

El comando openclaw onboard --install-daemon hace la mayor parte del trabajo: configura el Gateway, te pide la API key del modelo (Claude Pro recomendado), te conecta el primer canal y arranca el daemon en segundo plano.

openclaw doctor es tu mejor amigo: diagnostica problemas automáticamente y te dice exactamente qué está fallando.

Errores comunes que verás y cómo resolverlos:

• Error: "engine": ">=22.0.0" required — tu Node.js está desactualizado. Ve a nodejs.org y descarga la versión LTS más reciente (22+)
• API key inválida — ve a console.anthropic.com o platform.openai.com, genera una nueva key y pégala cuando el wizard la pida
• Daemon not running — ejecuta openclaw start. Si falla, revisa los logs con openclaw logs
• WhatsApp disconnected — vuelve a escanear el QR con openclaw channel reconnect whatsapp

En macOS el proceso completo tarda menos de 10 minutos. En Linux (Ubuntu/Debian) igual. En Windows necesitas WSL2 primero — ahí calcula 20-30 minutos la primera vez.

Después de ayudar a cientos de personas a instalar su primer agente, estos son los errores que se repiten una y otra vez:

1. No verificar la versión de Node antes de instalar

OpenClaw requiere Node >= 22. Si tienes Node 18 o 20, la instalación "funciona" pero el agente da errores crípticos en tiempo de ejecución. Siempre ejecuta node --version primero y actualiza si es necesario.

2. Exponer el agente a internet sin configurar allowlists

Si instalas OpenClaw en un VPS y no configuras la allowlist de contactos, cualquier número de WhatsApp o usuario de Telegram que encuentre tu agente puede interactuar con él. El agente tiene acceso a tus herramientas, archivos y APIs. Configura siempre la allowlist en el primer día.

3. Correr con permisos de root o administrador

Nunca ejecutes sudo npm install -g openclaw ni arranques el daemon como root. Si el agente tiene un bug o es comprometido, los permisos de root son devastadores. Crea un usuario sin privilegios específico para OpenClaw.

4. Saltarse el openclaw doctor

El 80% de los problemas que la gente reporta en el Discord ya los detecta openclaw doctor. Antes de pedir ayuda en ningún foro, ejecuta este comando y lee el output completo. Muchas veces la solución está ahí mismo.

5. Elegir un modelo demasiado pesado para su hardware

Si quieres usar modelo local con Ollama, no empieces con Llama 70B o Mixtral 8x22B. Con 8GB de VRAM empieza con Mistral 7B Q4 o Llama 3.1 8B Q4. Son modelos capaces que caben en tu hardware. Los modelos gigantes los dejas para cuando tengas más experiencia y presupuesto.

Regla de oro: cuando algo no funciona, ejecuta openclaw doctor, lee el output, busca el error exacto en GitHub Issues y en el Discord oficial. El 95% de los problemas tienen solución documentada.