La inteligencia artificial ya no se limita a chats puntuales: cada vez más profesionales la usan para organizar trabajo real, automatizar tareas repetitivas y responder más rápido en su operación diaria. En ese contexto, entender cómo funciona un agente —y cómo ponerlo en marcha sin perfil técnico— se vuelve una habilidad práctica con impacto inmediato.
En términos simples, un agente de IA es un asistente que no solo responde preguntas, sino que puede seguir instrucciones operativas y ejecutar flujos de trabajo (por ejemplo: investigar, resumir, ordenar pendientes o asistir procesos conectados a herramientas). OpenClaw es la plataforma que permite crear y operar ese agente de forma estructurada, uniendo modelo, canales y automatizaciones desde una misma base.
OpenClaw en Mac, por tanto, es una puerta de entrada práctica para pasar de la teoría a la ejecución. Esta guía está escrita para principiantes: explica el contexto, define los conceptos clave y muestra paso a paso dónde va cada comando, cómo conectar OpenAI (incluyendo auth mode codex) y cómo activar Telegram o WhatsApp para usar el agente en el día a día.
Fuentes oficiales recomendadas antes de empezar:
Qué vas a lograr al terminar
- OpenClaw instalado en tu Mac.
- Gateway funcionando correctamente.
- OpenClaw conectado a OpenAI (incluyendo modo codex).
- Canal de mensajería conectado (Telegram o WhatsApp).
- Un agente listo con prompts iniciales de alto valor.
Antes de empezar: dónde se ejecuta cada cosa
- Comandos como
npm install -g openclawse ejecutan en la app Terminal de macOS. - Cuando edites configuración, será en archivos de OpenClaw (normalmente guiado por el asistente de onboarding).
- Si usas Telegram/WhatsApp, una parte del setup se hace dentro de esas apps (BotFather o QR).
Paso 1) Instalar Homebrew (si no lo tienes)
Abre la app Terminal y pega:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"Verifica que quedó instalado:
brew --versionPaso 2) Instalar Node.js
En la misma ventana de Terminal:
brew install nodeComprueba versión:
node -v
npm -vPaso 3) Instalar OpenClaw
En Terminal:
npm install -g openclawVerifica que responde:
openclaw --helpPaso 4) Ejecutar onboarding guiado (recomendado para principiantes)
En Terminal:
openclaw onboard --install-daemonEste asistente te guía en autenticación, modelo y canales. Aquí es donde eliges cómo conectar OpenAI.
Paso 5) Conectar OpenClaw con OpenAI (incluye auth mode codex)
Tienes dos rutas principales:
Ruta A — OpenAI Code subscription (Codex)
- En el onboarding, elige opción de OpenAI Code subscription (reuse u OAuth).
- Si ya usaste Codex CLI en tu Mac, OpenClaw puede reutilizar credenciales locales (por ejemplo,
~/.codex/auth.json). - Si no, sigue el flujo OAuth que abre navegador y pega el código de autorización cuando lo pida.
Ruta B — OpenAI API key
- Genera tu API key en OpenAI Platform.
- Durante onboarding, selecciona OpenAI API key y pégala cuando la solicite.
Importante para principiantes: la suscripción de ChatGPT y la API son productos distintos. El onboarding te guía según el modo elegido para que el Gateway quede operativo.
Paso 6) Encender y verificar el Gateway
En Terminal:
openclaw gateway statusSi no está activo:
openclaw gateway startSi quedó inestable tras una configuración:
openclaw gateway restart
Paso 7) Crear tu primer agente (plantilla simple para copiar)
Úsalo como primer mensaje en el dashboard/chat de OpenClaw:
Eres mi asistente operativo en español.
Objetivo: ayudarme a planificar y ejecutar tareas diarias de alto impacto.
Reglas:
1) Prioriza tareas por impacto y urgencia.
2) Si una acción es externa o sensible, pide confirmación.
3) Responde con: resumen, próximos pasos y bloqueos.
4) Usa formato checklist cuando propongas ejecución.Paso 8) Conectar a Telegram (paso a paso)
- En Telegram, abre @BotFather y crea un bot con
/newbot. - Copia el token del bot.
- En onboarding/config de OpenClaw, habilita Telegram y pega el token.
- Reinicia gateway si hace falta y escribe al bot desde tu cuenta.
- Aprueba el pairing inicial si OpenClaw lo solicita.
Paso 9) Conectar a WhatsApp (paso a paso)
- Configura canal WhatsApp en OpenClaw (idealmente con número dedicado).
- En Terminal ejecuta:
openclaw channels login- Escanea el QR desde WhatsApp (Dispositivos vinculados).
- Inicia/reinicia gateway y valida que recibes mensajes.
Primeras interacciones recomendadas (para no-programadores)
- “Organiza mi día en 3 prioridades con bloques horarios.”
- “Convierte esto en checklist ejecutable y marca dependencias.”
- “Qué tareas puedo delegar hoy a un sub-agente y cuáles no.”
- “Haz un resumen de pendientes y riesgos para hoy.”
Tips prácticos para empezar bien
- Empieza con una sola rutina diaria (ejemplo: planning de mañana).
- Pide siempre salida accionable: checklist + próximos 3 pasos.
- Evita prompts largos al inicio; mejora iterativamente.
- Cuando todo funcione, recién ahí suma canales (Telegram/WhatsApp).
Errores comunes y solución rápida
“command not found: openclaw”
npm install -g openclawGateway no responde
openclaw gateway status
openclaw gateway restartNo llegan mensajes en Telegram/WhatsApp
- Verifica token (Telegram) o QR activo (WhatsApp).
- Revisa que el Gateway esté encendido.
- Repite pairing/login del canal.
Lectura complementaria en Criptotendencias
Si quieres ampliar contexto regulatorio y de infraestructura:
Siguiente nivel para convertirlo en ventaja real
La diferencia no está solo en instalar OpenClaw, sino en usarlo con disciplina operativa desde el día uno: una rutina clara, prompts orientados a ejecución y revisión diaria de resultados. Para usuarios sin perfil técnico, ese enfoque reduce fricción y acelera adopción real.
El insight clave: cuando el agente empieza a operar por canales (dashboard + Telegram/WhatsApp) y no solo en una prueba aislada de Terminal, se transforma en una capa de trabajo continua. Ese salto es el que convierte una herramienta de IA en un sistema útil para productividad, contenido y operaciones.
