La guia completa de OpenClaw: desde la primera instalacion hasta usuario avanzado

Que es OpenClaw y por que deberia importarte?

OpenClaw es un agente de IA de codigo abierto que funciona en tu propia maquina: tu portatil, un servidor domestico o un VPS en la nube. A diferencia de las herramientas de IA basadas en el navegador que solo responden preguntas, OpenClaw actua: lee tu correo electronico, programa reuniones, organiza archivos, envia mensajes a traves de WhatsApp, Telegram y Discord, y automatiza flujos de trabajo repetitivos, todo mediante lenguaje natural.

Desde su lanzamiento en enero de 2026, el proyecto ha superado las 244,000 estrellas en GitHub, convirtiendose en uno de los repositorios de codigo abierto de mas rapido crecimiento de la historia. La razon es simple: la gente quiere un asistente de IA que realmente haga cosas, no uno que solo hable sobre hacerlas.

Aqui tienes una forma rapida de entender la diferencia:

Chatbot de IA tradicional:

Tu: "Ayudame a organizar los archivos de mi escritorio." IA: "Claro! Aqui tienes algunos consejos: 1. Crea carpetas por tipo... 2. Mueve los archivos de acuerdo..."

OpenClaw:

Tu: "Ayudame a organizar los archivos de mi escritorio." OpenClaw: renombra, clasifica y mueve 47 archivos en 5 carpetas — "Listo! Organice todo por tipo de archivo."

Ese es el cambio fundamental: de un chatbot a un agente.

Esta guia te acompana en todo el recorrido, desde tu primera instalacion hasta la creacion de Skills personalizados y la gestion de multiples agentes. Ya sea que tengas 30 minutos o una tarde entera, avanza por cada seccion a tu propio ritmo.

Primeros pasos: instalacion y configuracion

Lo que necesitas

• Node.js 22+ (se recomienda LTS) — verifica con node --version
• Una API Key de un modelo de IA — Anthropic Claude (recomendado), OpenAI o un modelo local via Ollama
• macOS, Linux o Windows con WSL2

Instalar OpenClaw

La forma mas rapida es el instalador de una sola linea:

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

Esto detecta tu sistema, instala las dependencias necesarias y lanza el asistente de configuracion. Si prefieres npm:

npm install -g openclaw@latest

Para usuarios de Docker:

docker pull openclaw/openclaw:latest
docker run -d --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

Para un tutorial detallado de cada metodo, consulta nuestra guia de inicio rapido.

Ejecutar el asistente de configuracion inicial

Despues de la instalacion, el asistente te guia paso a paso:

openclaw onboard

Configuraras tres cosas:

1. Proveedor de IA y API Key — Anthropic Claude funciona mejor. Si aun no tienes una clave, obten una en anthropic.com. Tienes un presupuesto ajustado? Consulta nuestra guia de seleccion de modelos y costos.
2. Canal de mensajeria — Elige al menos uno: Telegram es el mas facil para empezar (configuracion de 5 minutos). Tenemos guias dedicadas para Telegram, WhatsApp y Discord.
3. Modo de seguridad — Elige Sandbox por ahora. Puedes cambiar al acceso completo mas adelante cuando te sientas comodo.

Verificar que todo funciona

openclaw status

Deberias ver:

Gateway: Running ✓
Model: Connected ✓
Channels: 1 active

Ahora abre tu aplicacion de mensajeria y envia tu primer mensaje. Prueba algo sencillo:

• "Que puedes hacer?"
• "Que hora es?"
• "Resume las ultimas noticias de tecnologia."

Si tu bot responde, felicidades, ya tienes un agente de IA funcionando.

Conceptos fundamentales: como funciona OpenClaw

Antes de profundizar, es util comprender los cuatro bloques basicos de OpenClaw. Piensa en ellos de esta forma:

Gateway — La puerta de entrada

El Gateway es la forma en que OpenClaw se conecta al mundo exterior. Gestiona los mensajes que llegan desde Telegram, Discord, WhatsApp, una API web o incluso la linea de comandos. Puedes ejecutar multiples Gateways simultaneamente; por ejemplo, Telegram para uso personal y Slack para el trabajo.

Skills — La caja de herramientas

Los Skills son lo que OpenClaw puede hacer. Cada Skill es una capacidad empaquetada: enviar correos, buscar en la web, gestionar archivos, controlar tu navegador. Piensa en ellos como aplicaciones en un smartphone. OpenClaw viene con algunos Skills integrados, pero el verdadero poder proviene del ecosistema comunitario en Clawhub y de crear los tuyos propios.

Explora nuestro directorio de Skills para ver lo que esta disponible.

Memory — El cerebro

OpenClaw recuerda cosas entre conversaciones. Dile tu nombre, tu horario de trabajo, tus preferencias, y retiene ese contexto. A diferencia de los chatbots sin estado, OpenClaw construye una comprension persistente de quien eres y como trabajas, almacenada localmente en ~/.openclaw/memory/.

Sandbox — La red de seguridad

El Sandbox controla lo que OpenClaw puede hacer en tu sistema. En modo Sandbox, no puede acceder a archivos arbitrarios ni ejecutar comandos destructivos. Esta es tu capa de seguridad, especialmente importante cuando experimentas con nuevos Skills o le otorgas permisos mas amplios a OpenClaw.

Para una configuracion de seguridad detallada, consulta nuestra plantilla de configuracion segura.

Instalar y usar Skills

Los Skills son lo que convierte a OpenClaw de una "demo interesante" en una "herramienta de uso diario". Asi es como empezar.

Buscar e instalar

# Buscar Skills por palabra clave
openclaw skills search email

# Ver detalles de un Skill especifico
openclaw skills info @openclaw/email-manager

# Instalarlo
openclaw skills install @openclaw/email-manager

Cinco Skills que vale la pena instalar primero

| Skill | Que hace | Comando de instalacion | |-------|----------|----------------------| | Email Manager | Leer, redactar y enviar correos | openclaw skills install @openclaw/email-manager | | Calendar | Crear eventos, consultar agenda, enviar invitaciones | openclaw skills install @openclaw/calendar | | File Organizer | Ordenar, renombrar y limpiar archivos | openclaw skills install @openclaw/file-organizer | | Web Search | Buscar en la web y resumir resultados | openclaw skills install @openclaw/tavily-search | | Browser Control | Automatizar tareas del navegador | openclaw plugins install @openclaw/browser-control |

Despues de instalarlos, simplemente habla con tu agente de forma natural:

• "Revisa mis correos no leidos y resume los 3 mas importantes."
• "Que tengo en mi calendario manana?"
• "Busca las ultimas notas de la version de OpenClaw."

Gestionar tus Skills

# Listar todos los Skills instalados
openclaw skills list

# Actualizar todos los Skills
openclaw skills update

# Eliminar un Skill que ya no necesites
openclaw skills remove @openclaw/file-organizer

Antes de instalar Skills de terceros, revisa nuestra lista de verificacion de seguridad para Skills para mantenerte seguro.

Configurar automatizaciones (tareas programadas)

Una de las funciones mas practicas de OpenClaw son las automatizaciones programadas. En lugar de pedirle a tu agente que haga algo cada manana, puedes configurarlo una vez y dejar que se ejecute solo.

Crear un resumen diario

Simplemente dile a tu agente en lenguaje natural:

"Cada manana a las 8 AM, enviame un resumen con el clima de hoy, mis eventos del calendario y la cantidad de correos no leidos."

OpenClaw creara una tarea programada automaticamente. Tambien puedes gestionarlas manualmente:

# Listar todas las tareas programadas
openclaw cron list

# Ver detalles de una tarea especifica
openclaw cron show <task-id>

# Pausar una tarea
openclaw cron disable <task-id>

# Reanudarla
openclaw cron enable <task-id>

# Eliminarla permanentemente
openclaw cron delete <task-id>

Ideas de automatizacion

• Resumen diario — Clima + calendario + correos no leidos cada manana
• Resumen semanal — Informe del viernes por la tarde sobre la actividad de tu semana
• Rastreador de precios — Monitorear la pagina de un producto y avisarte cuando baje el precio
• Recordatorio de fin de dia — Un aviso amigable a las 6 PM para terminar el trabajo
• Limpieza de bandeja de entrada — Archivar automaticamente correos de baja prioridad cada noche

Configurar la memoria persistente

El sistema de memoria de OpenClaw es lo que lo hace sentir personal. Cuanto mas contexto le des, mejor te servira.

Ensena a tu agente sobre ti

Envia un mensaje como este:

"Recuerda esto sobre mi: Mi nombre es Alex. Soy gerente de producto. Trabajo de lunes a viernes, de 9 AM a 6 PM, zona horaria GMT+8. Prefiero respuestas concisas. Me comunico en ingles pero puedo leer chino."

OpenClaw almacena esto en su memoria a largo plazo y lo aplica en cada interaccion futura.

Ver y editar la memoria

# Ver que recuerda tu agente
cat ~/.openclaw/memory/long-term.json

# O preguntale directamente en el chat
"Que sabes sobre mi?"

Tambien puedes corregir o eliminar recuerdos:

"Olvida mi antiguo horario de trabajo. Ahora trabajo de 10 AM a 7 PM."

Como funciona la memoria

OpenClaw utiliza tres capas de memoria:

• Corto plazo — Contexto de la conversacion actual (se borra despues de cada sesion)
• Largo plazo — Hechos persistentes sobre ti (preferencias, habitos, informacion biografica)
• Episodica — Registros de interacciones pasadas (usados para reconocimiento de patrones a lo largo del tiempo)

Este enfoque por capas significa que tu agente se vuelve mas util cuanto mas lo usas, sin necesidad de recordatorios constantes.

Escribir tu primer Skill personalizado

Cuando los Skills integrados y los de la comunidad no cubren tu necesidad especifica, puedes escribir el tuyo propio. Los Skills de OpenClaw utilizan un formato YAML sencillo.

Estructura de un Skill

Crea un nuevo archivo en ~/.openclaw/skills/daily-news.yaml:

name: "Daily Tech News"
description: "Fetches and summarizes today's top tech headlines"
version: "1.0.0"

triggers:
  - "tech news"
  - "today's news"
  - "news summary"

steps:
  - action: web_search
    query: "top tech news today"
    max_results: 5

  - action: summarize
    content: "{{search_results}}"
    style: "bullet_points"

  - action: respond
    message: |
      Here's your tech news summary:

      {{summary}}

Probarlo

# Recargar los Skills para detectar el nuevo archivo
openclaw skills reload

# Probarlo
openclaw skills test "Daily Tech News"

Luego pruebalo en una conversacion: "Dame las noticias de tecnologia de hoy."

Crear Skills mas complejos

Los Skills pueden encadenar multiples acciones:

• web_search — Buscar en la web
• summarize — Condensar texto en puntos o parrafos
• respond — Enviar una respuesta formateada
• file_read / file_write — Leer o crear archivos
• shell_exec — Ejecutar comandos de shell (requiere los permisos adecuados)
• http_request — Llamar a APIs externas

Puedes combinarlos para crear flujos de trabajo como: buscar precios de vuelos, comparar resultados, escribir un resumen en un archivo y notificarte por Telegram.

Gestion de multiples agentes

A medida que tu uso crece, es posible que quieras agentes separados para diferentes areas de tu vida: uno para el trabajo, otro para tareas personales y otro para experimentos.

Crear agentes

# Crear un agente de trabajo con Claude Sonnet
openclaw create-agent work
openclaw config --agent work set ai.model "claude-sonnet-4-6"

# Crear un agente personal
openclaw create-agent personal
openclaw config --agent personal set ai.model "claude-haiku-4-5"

# Listar todos los agentes
openclaw list-agents

# Cambiar entre ellos
openclaw switch-agent work

Por que usar multiples agentes?

| Agente | Modelo | Conectado a | Proposito | |--------|--------|-------------|-----------| | Work | Claude Sonnet | Slack, Gmail, Linear | Tareas profesionales, triaje de correo | | Personal | Claude Haiku | Telegram, Google Calendar | Agenda, recordatorios, recados personales | | Lab | Ollama (local) | Solo CLI | Probar nuevos Skills, experimentos |

Cada agente tiene su propia memoria, Skills y conexiones de canal, completamente aislados entre si.

Automatizacion del navegador

OpenClaw puede controlar un navegador para realizar tareas que van mas alla de simples llamadas a APIs: rellenar formularios, extraer datos de paginas web, comparar precios en diferentes sitios o tomar capturas de pantalla.

Habilitar Browser Control

# Instalar el plugin del navegador
openclaw plugins install @openclaw/browser-control

# Habilitarlo
openclaw config set browser.enabled true

# Mostrar la ventana del navegador (establece true para depuracion)
openclaw config set browser.headless false

Casos de uso

• "Abre GitHub y encuentra los repositorios en tendencia de hoy."
• "Ve a Amazon, busca teclados mecanicos y lista los 3 mejores por calificacion con precios."
• "Rellena el formulario de contacto en example.com con mi informacion."
• "Toma una captura de pantalla de mi sitio web de portafolio."

La automatizacion del navegador es potente pero consume muchos recursos. Usala para tareas que realmente necesiten interaccion visual con paginas web; para la obtencion simple de datos, un Skill de busqueda web es mas rapido y economico.

Integraciones mas alla del chat

OpenClaw se conecta a mucho mas que solo aplicaciones de mensajeria. Aqui tienes algunas integraciones populares:

Google Workspace

openclaw config set integrations.google.enabled true
openclaw config set integrations.google.credentialsPath "/path/to/credentials.json"
openclaw integrations google authorize

Una vez conectado, puedes gestionar Gmail, Google Calendar y Google Drive mediante lenguaje natural.

Gestion de proyectos (Linear, Jira)

openclaw skills install @openclaw/linear
openclaw config set integrations.linear.apiKey "YOUR_API_KEY"

"Crea una tarea de alta prioridad en Linear: Corregir el error de redireccion de la pagina de inicio de sesion."

Toma de notas (Obsidian, Notion)

openclaw skills install @openclaw/obsidian
openclaw config set integrations.obsidian.vaultPath "/path/to/vault"

"Crea una nueva nota en Obsidian titulada 'Notas de reunion — 2 de marzo' con los puntos de discusion de hoy."

Para una lista completa de plataformas compatibles, consulta nuestro directorio de integraciones de canales.

Seguridad y control de costos

Docker Sandbox

Para un aislamiento maximo, ejecuta OpenClaw dentro de un Docker Sandbox:

openclaw config set sandbox.mode "docker"
openclaw config set sandbox.docker.image "openclaw/sandbox:latest"
openclaw sandbox test

Esto restringe el acceso al sistema de archivos, el acceso a la red y la ejecucion de comandos de shell a limites predefinidos.

Ejecutar una auditoria de seguridad

openclaw security audit --deep

Esto verifica permisos mal configurados, tokens expuestos y otros problemas comunes.

Para una guia completa de refuerzo de seguridad, lee Exposicion de puertos y acceso remoto.

Controlar tus gastos

Los costos de la API pueden acumularse. Asi es como establecer limites:

# Establecer un limite diario de solicitudes
openclaw config set ai.dailyLimit 1000

# Establecer un tope de presupuesto mensual (en USD)
openclaw config set ai.monthlyBudget 50

# Verificar tu uso
openclaw stats usage
openclaw stats cost

Costos mensuales tipicos:

| Nivel de uso | Descripcion | Costo estimado | |-------------|-------------|----------------| | Ligero | 10-20 conversaciones/dia | $5-10/mes | | Moderado | 50-100 conversaciones + tareas programadas | $20-30/mes | | Intenso | Automatizaciones + control del navegador | $50-100/mes |

Quieres profundizar en la optimizacion de costos? Consulta nuestra guia de seleccion de modelos y costos.

Referencia rapida de solucion de problemas

| Sintoma | Causa probable | Solucion | |---------|---------------|----------| | EADDRINUSE al iniciar | Puerto 18789 en uso | openclaw gateway start --port 18790 | | 401 Unauthorized | API Key invalida o expirada | openclaw config set api-key | | El bot no responde | Canal no conectado | Verifica openclaw status y la configuracion del canal | | Respuestas lentas | Modelo sobrecargado o problemas de red | Prueba un modelo mas ligero o verifica la conexion | | Los Skills no cargan | Necesitan recargarse despues de instalar | openclaw skills reload |

Para una solucion de problemas mas detallada, consulta nuestra guia de errores comunes.

Comandos de diagnostico utiles

# Verificacion completa de salud
openclaw doctor

# Ver registros
openclaw logs

# Modo de depuracion
openclaw config set logging.level "debug"

Que sigue?

Has cubierto mucho terreno. Aqui tienes a donde ir segun tus intereses:

• Quieres mas canales? Explora nuestras guias de integracion de mas de 50 canales — desde Slack y Teams hasta WeChat y Line.
• Te interesa la seguridad? Lee la lista de verificacion de seguridad para Skills y la guia de configuracion segura.
• Quieres alojar tu propio servidor? Consulta nuestra guia sobre acceso remoto y exposicion de puertos.
• Listo para contribuir? El repositorio de OpenClaw en GitHub acepta pull requests, contribuciones de Skills e informes de errores.

OpenClaw representa un cambio real en la forma en que interactuamos con la IA: de pedir consejos a delegar tareas reales. El proyecto avanza rapido, la comunidad crece y el mejor momento para comenzar a construir tu propia configuracion de agente de IA es ahora.