Introducción
OpenClaw es un framework open source para crear agentes de IA que corren en tu propia máquina, 24/7. A diferencia de usar Claude o ChatGPT directamente, los agentes de OpenClaw tienen memoria persistente, pueden conectarse a tus herramientas y ejecutan tareas de forma autónoma sin que tengas que estar presente.
Esta guía te lleva desde cero hasta tener tu primer agente funcionando.
Links útiles
Sitio oficial: https://openclaw.ai
Documentación: https://docs.openclaw.ai
GitHub: https://github.com/openclaw/openclaw
Skills (ClawHub): https://clawhub.com
Comunidad Discord: https://discord.com/invite/clawd
¿Qué es un agente de IA?
Un agente es un programa que puede:
- Recibir instrucciones en lenguaje natural
- Tomar decisiones por su cuenta
- Ejecutar acciones en el mundo real (publicar en redes, leer emails, modificar archivos)
- Aprender y recordar contexto entre sesiones
La diferencia con un chatbot: un chatbot solo responde. Un agente actúa.
La arquitectura de 20 agentes
Cuando escala el trabajo, un solo agente no alcanza. La arquitectura recomendada usa equipos:
3× Orquestadores — el cerebro del sistema. Reciben las tareas del humano, las dividen en subtareas y las distribuyen a los Workers. Manejan el ruteo, la programación y el triaje de prioridades.
15× Workers — los ejecutores. Cada Worker se especializa en una función: uno publica contenido, otro maneja emails, otro analiza métricas. Se pueden escalar horizontalmente según la carga.
1× Canary — el primero en recibir actualizaciones del sistema. Sirve para testear cambios antes de aplicarlos a todos los demás agentes. Detecta problemas antes de que afecten la producción.
1× Observador — monitorea la salud de todos los agentes. Agrega métricas de heartbeat, detecta agentes caídos o lentos y manda alertas al humano.
Los archivos de configuración
Cada agente de OpenClaw se define con archivos de texto simples en su workspace. No hay código — solo archivos Markdown.
AGENTS.md — las reglas operativas del agente. Qué puede hacer, qué no puede hacer, sus prioridades, el estándar de calidad, las instrucciones de seguridad. Es la "descripción del puesto".
SOUL.md — la personalidad del agente. Su tono de voz, sus valores, cómo se comunica, sus limitaciones de comportamiento. Define quién es el agente, no solo qué hace.
USER.md — contexto sobre el humano. Timezone, preferencias de comunicación, proyectos activos, qué cosas no le gustan. El agente lo lee para personalizar sus respuestas.
IDENTITY.md — identidad del agente: nombre, emoji, descripción breve, avatar. Útil cuando trabajás con múltiples agentes.
TOOLS.md — notas locales específicas de tu máquina: rutas de archivos, nombres de dispositivos, hosts SSH, credenciales (referencias, no valores reales). Cada máquina tiene su propio TOOLS.md.
HEARTBEAT.md — una checklist corta que el agente revisa automáticamente cada 30 minutos. Ideal para tareas recurrentes: revisar emails importantes, chequear métricas, publicar contenido programado.
MEMORY.md — la memoria curada de largo plazo. El agente la actualiza por su cuenta cuando aprende algo importante. Solo se carga en conversaciones directas (DMs).
BOOTSTRAP.md — el archivo de primera vez. Si existe, el agente lo lee, se presenta y lo borra. Útil para el onboarding inicial.
memory/YYYY-MM-DD.md — notas de trabajo diarias, creadas automáticamente. El historial crudo de lo que hizo cada día.
Instalación paso a paso
Requisitos previos:
- Node.js 18 o superior
- Un servidor o computadora que esté encendida (puede ser tu laptop, un VPS de $5/mes, una Raspberry Pi)
Paso 1 — Instalar OpenClaw:
npm install -g openclaw
Paso 2 — Verificar la instalación:
openclaw --version
Paso 3 — Iniciar el gateway (el proceso que mantiene el agente activo en background):
openclaw gateway start
Paso 4 — Configurar un canal de comunicación (Telegram es el más usado):
Creá un bot en Telegram con @BotFather y copiá el token. Luego:
openclaw config set telegram.token TU_TOKEN_AQUI
openclaw gateway restart
Paso 5 — Hablar con tu agente:
Abrí Telegram, buscá tu bot y empezá a chatear. El agente leerá tus archivos SOUL.md, USER.md y AGENTS.md para personalizarse.
Skills: cómo ampliar las capacidades
Las skills son módulos que le enseñan al agente cómo hacer cosas específicas. Se instalan desde ClawHub (el registro público de skills).
Ejemplos de skills disponibles:
Publicación en redes sociales:
clawhub install postiz
Meta Ads (campañas publicitarias):
clawhub install meta-ads
Clonar carruseles de TikTok/IG:
clawhub install carousel-cloner
Generación de imágenes (Nano Banana Pro):
clawhub install product-photos
SEO y auditoría de sitios:
clawhub install seo-audit
Para ver todas las skills disponibles:
clawhub search [término]
Casos de uso reales
Automatización de contenido — el agente genera y publica contenido en TikTok, Instagram y YouTube todos los días según un calendario. Vos solo aprobás lo que va a salir.
Research automático — antes de una reunión con un prospecto, el agente investiga su sitio web, redes sociales y LinkedIn, y te manda un brief con lo que encontró.
Reportes matutinos — cada mañana recibís un resumen de métricas: seguidores, engagement, posts con mejor rendimiento, campañas de ads.
Respuesta a DMs — integrado con ManyChat, el agente responde los comentarios e inbox de Instagram de forma automática y califica leads.
Monitoreo de oportunidades — el agente rastrea noticias de la industria (Anthropic, OpenAI, Cursor) y te manda un resumen diario con las novedades relevantes.
Arquitectura Multi-Agente
Para proyectos más complejos, podés conectar múltiples agentes que se comunican entre sí por Telegram o Discord. Cada uno tiene su propio workspace, su propia SOUL.md y sus propias skills.
Un ejemplo: el agente "marketing" recibe la tarea de lanzar una campaña → delega la creación de imágenes al agente "diseño" → delega la publicación al agente "social" → reporta el resultado al humano.
Todo esto sin que el humano tenga que intervenir en cada paso.
Documentación y comunidad
Para profundizar más:
Documentación oficial completa: https://docs.openclaw.ai
Guía de skills: https://clawhub.com
Issues y contribuciones: https://github.com/openclaw/openclaw
Comunidad Discord: https://discord.com/invite/clawd
Preguntas frecuentes
Necesitás tener Node.js 18 o superior y un servidor o computadora que esté encendida, como tu laptop, un VPS o una Raspberry Pi.
Podés personalizar tu agente editando los archivos SOUL.md, USER.md y AGENTS.md, donde definís su personalidad, contexto y reglas operativas.
Las skills son módulos que amplían las capacidades de tu agente. Se instalan desde ClawHub y permiten realizar tareas específicas como publicar en redes o generar imágenes.
Sí, podés conectar múltiples agentes que se comuniquen entre sí, cada uno con su propio workspace, SOUL.md y skills, para gestionar proyectos más complejos.
Podés consultar la documentación oficial en https://docs.openclaw.ai y unirte a la comunidad en Discord para más soporte y recursos.
