Manual completo de OpenClaw: de principiante a experto

Un cliente escribió: informe competitivo para mañana a las nueve. Docenas de pestañas, 200 correos sin leer. Abrí OpenClaw: «Recopila noticias de la competencia A de la última semana y genera informe.» Cinco minutos después, el informe en Telegram.

Llevo tres meses con OpenClaw. Al principio no entendía la diferencia con ChatGPT — ¿no es chatear con IA? Luego vi que no: es un framework de agentes open source. Le das un objetivo, planifica, usa herramientas, ejecuta y te devuelve el resultado. No como ChatGPT, donde empujas cada paso.

Si también saltas entre herramientas y repites trabajo mecánico, este artículo te ordena OpenClaw: instalación, configuración y ruta de aprendizaje.

Es el artículo 35 de la serie OpenClaw — síntesis de los 35 anteriores para una visión global rápida.

Capítulo 1: Qué es OpenClaw

1.1 No es ChatGPT, es un agente IA

La primera pregunta suele ser: ¿qué tiene que ver con ChatGPT?

Un ejemplo lo aclara:

Pides a ChatGPT «ordena mis correos recientes» y te dice cómo o te da texto ordenado. Tú copias y pegas del buzón.

Pides lo mismo a OpenClaw y abre el correo, lee, clasifica, genera informe y te lo manda al móvil.

Esa es la diferencia entre chat pasivo y agente autónomo.

OpenClaw ejecuta solo. Tiene herramientas (archivos, web, código), memoria (preferencias, historial) y planificación (pasos hacia el objetivo).

1.2 Ventajas principales

Tres meses de uso, esto destaca:

Despliegue local, datos en tu mano. Sin miedo a que entrenen con tus chats. Importante para trabajo sensible.

Costo controlable. Modelos distintos por tarea: barato para lo simple, Claude o GPT-4 para lo complejo. Suele salir más barato que ChatGPT directo.

Personalizable. 53 skills oficiales y más en la comunidad. También puedes escribir las tuyas.

Multicanal. Telegram, WhatsApp, Web UI, Gmail… Yo uso sobre todo Telegram.

1.3 ¿Cómo es la arquitectura?

Tú → Channel (Telegram/WhatsApp) → Gateway → Agent → Tools/Skills
                                              ↓
                                           Memory

Gateway: entrada de mensajes desde plataformas.

Agent: cerebro — intención, plan, herramientas.

Channels: dónde conversas.

Tools: 26 herramientas core (archivos, web, código, Git…).

Skills: paquetes de flujo; 53 oficiales y creciendo.

Memory: preferencias e historial en MEMORY.md.

Para profundizar: «Guía de arquitectura OpenClaw: de principiante a experto» en la serie.

1.4 ¿Para qué sirve?

Escenarios frecuentes:

Asistente personal. Noticias del sector cada mañana a Telegram; agenda, correo, recordatorios.

Ayuda de desarrollo. Revisión de código, debug, documentación; búsqueda de docs más rápida que a mano.

Automatización. Backups, monitorización web, emails de marketing — antes scripts, ahora lenguaje natural.

Hogar inteligente. Con Home Assistant: «Llegué a casa» → luces y clima.

Capítulo 2: Inicio rápido — 10 minutos

2.1 Formas de instalar

Tres opciones, por recomendación:

Script oficial (novatos)

Documentación de instalación:

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

Detecta sistema, Node si hace falta, instala CLI. Luego el asistente de onboarding.

npm global

Con Node gestionado (oficial sugiere Node 24, mínimo 22.14+):

npm install -g openclaw@latest
openclaw onboard --install-daemon

Comprueba con openclaw --version, openclaw doctor, openclaw gateway status.

Desde fuente (contribuidores)

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon

Si solo usas OpenClaw, script o npm bastan. Más detalle en «Guía de instalación OpenClaw» y «Guía final de instalación OpenClaw 2026».

2.2 Configuración básica

Tras instalar: proveedor de modelo y canales.

Claves API

OpenClaw llama APIs (Anthropic, OpenAI, Google…). Recomendado: openclaw onboard o openclaw secret set; evita claves en texto en carpetas sincronizadas. Orden de resolución en docs oficiales.

Configuración de Channel

Telegram para empezar: Bot en BotFather, token, wizard. Manual: ~/.openclaw/openclaw.json, campo channels.telegram — docs Telegram. Los config.yaml viejos son genéricos; usa openclaw.json.

WhatsApp y otros: páginas de canales oficiales. Web: openclaw dashboard con Gateway activo.

Seguridad básica

1. Permisos adecuados en MEMORY.md y .env
2. Firewall si está en servidor

El capítulo 5 profundiza en seguridad.

2.3 Primera conversación

Arranca Gateway:

openclaw gateway status
# Depuración en primer plano:
openclaw gateway

Con pairing por defecto en Telegram, primera vez: openclaw pairing approve telegram <CODE> (código ~1 h). Con dmPolicy: allowlist y tu user ID, según tu política.

En Telegram, prueba un mensaje.

Primer skill: memoria

Recuerda que me levanto a las 8, me gustan las noticias tech y trabajo en español.

Revisa MEMORY.md — quedó guardado.

Pídele que trabaje

Busca noticias recientes de OpenClaw y dame 5 puntos clave.

Verás cómo busca, lee, resume y te responde sin que intervengas. Esa sensación engancha.

Capítulo 3: Funciones core — herramientas y skills

3.1 26 herramientas core

Cubren archivos, red, código, etc. Ejemplos:

Archivos

Herramienta	Función
read_file	Leer archivo local
write_file	Escribir archivo
execute_command	Ejecutar comando shell
list_directory	Listar directorio

Red

Herramienta	Función
web_search	Buscar en web
fetch_url	Obtener URL
scrape	Parsear página

Código

Herramienta	Función
execute_code	Ejecutar fragmento
git_operations	Operaciones Git

Si pides «analiza la estructura de este proyecto», usará list_directory, read_file, quizá execute_code, y te devuelve el resumen. Una frase tuya basta.

3.2 Introducción al sistema de skills

Las herramientas son la base; los skills son flujos empaquetados.

53 oficiales y más en comunidad. Destacados:

memory — gestión de memoria y preferencias.

web_search — búsqueda, fetch y parse en un flujo.

code_execution — Python, JavaScript; datos y prototipos.

Mercado de skills

• ClawHub: mercado oficial, instalación en un clic
• awesome-openclaw-skills: colección GitHub, calidad variable

Instalación:

openclaw skill install <skill_name>

O en config:

skills:
  - name: daily_news
    source: github
    repo: user/daily-news-skill

3.3 Desarrollo de skills personalizados

Si lo oficial y la comunidad no bastan, escribe el tuyo.

Un skill es config + llamadas a herramientas. Ejemplo mínimo:

name: my_skill
description: Recordar cosas importantes
tools:
  - memory.write
  - memory.read
prompt: |
  Si el usuario dice «recuerda X», usa memory.write.
  Si pregunta qué recordaste, usa memory.read.

En skills/, reinicia OpenClaw.

Buenas prácticas:

1. Condiciones de activación claras
2. Solo herramientas necesarias (seguridad)
3. Manejo de errores en llamadas

Más en «Guía de desarrollo de Skills OpenClaw» de la serie.

Capítulo 4: Avanzado — automatización de flujos

4.1 Enrutamiento multi-modelo y costos

Tras un tiempo, la factura API sube. Tareas simples con Claude o GPT-4 es exceso.

Solución: enrutamiento multi-modelo.

¿Por qué?

Tareas simples → modelo barato; complejas → caro:

• Tareas, Q&A simple → GPT-3.5 o Claude Haiku
• Revisión de código, razonamiento → GPT-4 o Claude Sonnet
• Muy complejas → Claude Opus

Configuración

Claves reales en ~/.openclaw/openclaw.json y docs «Models / Model Failover»; no copies config.yaml aleatorios. Casos en «Gestión de costos OpenClaw: estrategia de enrutamiento» y modelos oficiales.

Con routing y degradación, ~40% menos de gasto API (según tareas).

4.2 Tareas programadas

Una de mis favoritas.

Cron en CLI: openclaw cron add, persistencia en ~/.openclaw/cron/jobs.json. Ver «Guía Cronjob OpenClaw» y docs cron.

Mis cron habituales

1. Briefing tech 8:00 a Telegram
2. Informe semanal viernes tarde
3. Backup domingo noche

Antes scripts y crontab; ahora lenguaje natural.

4.3 Integración multicanal

Varios canales a la vez: mensaje por Telegram, resultado por email.

Canales principales

• Telegram (más usado)
• WhatsApp
• Gmail
• Web UI
• Discord

Caso: centro de mensajes

1. OpenClaw monitoriza buzones
2. Correo importante → resumen a Telegram
3. Respondes en Telegram → OpenClaw envía email

Un solo punto de entrada.

4.4 Automatización del navegador (2026.3)

Novedad: Live Chrome Session Attachment — OpenClaw puede «tomar» tu sesión de Chrome.

Usos

• Rellenar formularios
• Páginas con login
• Pruebas web
• Comprobar cambios en sitios

Ejemplo de config

browser:
  enabled: true
  headless: false
  user_data_dir: ~/.config/openclaw/chrome

Luego: «Abre GitHub y mira si hay nuevos Pull Request.»

Arranca o toma el navegador, navega y comprueba. En evolución rápida; ver «OpenClaw 2026.3 avanzado».

Capítulo 5: Seguridad y despliegue — producción

5.1 Lista de seguridad

OpenClaw ejecuta comandos y toca archivos — no relajes la seguridad.

Claves API

No hardcodees en config. Variables de entorno:

export ANTHROPIC_API_KEY=sk-ant-xxx

O flujo Secrets:

openclaw secret set ANTHROPIC_API_KEY

Cifrado local; inyección en runtime.

Sandbox

Aislamiento por defecto; para más seguridad, Docker:

sandbox:
  type: docker
  image: openclaw/sandbox:latest
  resource_limits:
    memory: 512M
    cpu: 0.5

El código del agente corre en contenedor.

SELinux

2026.3 detecta SELinux automáticamente. En CentOS bloqueó red hasta ajustar contexto.

Checklist

• API Key en env o Secrets
• Permisos 600 en MEMORY.md y .env
• Docker sandbox en producción
• SELinux/firewall revisados
• Actualizar OpenClaw

Ver «Guía de endurecimiento de seguridad OpenClaw».

5.2 Comparación de despliegue

Modo	Ventajas	Desventajas	Escenario
Local	Simple, gratis, datos locales	PC encendido	Personal, pruebas
Servidor	Estable, remoto	Mantenimiento, costo	Equipo pequeño, prod
Nube (p. ej. DigitalOcean)	Rápido, poco mantenimiento	Costo, datos en nube	Lanzar sin fricción

Empecé local; al dormir el PC se paraba. VPS barato (~pocos USD/mes) lleva meses estable. Más en «Comparación de despliegue OpenClaw».

5.3 Despliegue empresarial

Multiusuario

users:
  - id: user1
    channels: [telegram, email]
    permissions: [read, write, execute]
  - id: user2
    channels: [web]
    permissions: [read]

Monitorización y logs

logging:
  level: info
  format: json
  output: /var/log/openclaw/app.log

Con Grafana u otras herramientas.

Alta disponibilidad

1. Varias instancias + balanceo
2. Persistencia de Memory
3. Backup de config y datos

Detalle en «Despliegue empresarial OpenClaw».

Capítulo 6: Ruta de aprendizaje y recursos

6.1 Principiante (0-1 mes)

Objetivo: que funcione y tareas simples.

Lecturas

1. «Guía de instalación OpenClaw»
2. «Guía de arquitectura OpenClaw»
3. «Guía de configuración OpenClaw» — Telegram

Metas

• Desplegar y ejecutar
• Primera conversación
• Recordar preferencias
• Probar un skill (web_search)

Problemas frecuentes

• Instalación: script oficial, no fuente al principio
• Telegram: token y red
• API: clave y saldo

6.2 Intermedio (1-3 meses)

Objetivo: que realmente ahorre tiempo.

Lecturas

1. «Gestión de costos OpenClaw»
2. «Seguridad OpenClaw»
3. «Cronjob OpenClaw»

Metas

• Enrutamiento multi-modelo
• 2-3 cron
• Telegram + email
• Explorar skills comunitarios

Consejo

Aquí muchos abandonan — pasó la novedad y aún no ves el ahorro. Elige una tarea repetitiva diaria (correo, informe semanal) y delega. El efecto motiva.

6.3 Experto (3+ meses)

Objetivo: herramienta a medida.

Lecturas

1. «Despliegue empresarial OpenClaw»
2. «Desarrollo de Skills OpenClaw»
3. Código fuente oficial

Metas

• Skills propios
• Producción
• Rendimiento y costo
• Contribuir (PR, tutoriales)

6.4 Recursos externos

Oficiales

• docs.openclaw.ai
• github.com/openclaw/openclaw

Comunidad

• awesome-openclaw-skills
• ClawHub

Tutoriales

• freeCodeCamp «OpenClaw Full Tutorial for Beginners»
• every.to «OpenClaw Comprehensive Guide»

Conclusión

¿Vale la pena aprender OpenClaw?

Si repites trabajo, saltas entre herramientas y quieres un asistente que haga de verdad, sí.

No es magia instantánea: curva inicial y tiempo de config. Pero en marcha, muchas cosas se delegan.

Tres acciones ya:

1. Elige despliegue e instala (local, servidor, nube).
2. Prueba un skill — web_search o memory.
3. Únete a la comunidad — el proyecto evoluciona rápido.

¿Problemas? Busca en la serie o abre Issue en GitHub. Yo también tropecé; bienvenido el intercambio.