OpenClaw: La Guía Completa en Español

Opción A: API Key (recomendado sin discusión)

La forma más segura y estable — y desde abril 2026, también la más sencilla económicamente. Creas una API key en console.anthropic.com y pagas por uso. Es el path recomendado por Anthropic y por OpenClaw.

O en el config directamente:

{
env: { ANTHROPIC_API_KEY: "sk-ant-..." },
agents: {
  defaults: {
    model: { primary: "anthropic/claude-sonnet-4-6" }
  }
}
}

Modelos disponibles vía API (abril 2026): claude-opus-4-7 (flagship, para tareas complejas), claude-sonnet-4-6 (default recomendado — equilibra velocidad e inteligencia), claude-haiku-4-5 (rápido y barato, ideal para alto volumen).

Opción B: Setup Token (suscripción Claude) — ahora requiere Extra Usage

¿Qué pasa si lo intentas sin Extra Usage? Las requests simplemente fallan. OpenClaw no tiene forma de darle la vuelta — es control del lado de Anthropic.

Para activar Extra Usage:

Tarifas actuales (abril 2026) para el path de suscripción + extra usage:

Nota: Haiku no está disponible por esta ruta — si lo quieres, necesitas una API key directa de Anthropic.

Con Extra Usage activo, el setup-token sigue funcionando igual que antes:

Telegram (recomendado)

Telegram es el canal más fácil de configurar y el que recomendamos para empezar. Tu bot vive en una cuenta separada (no usa tu número personal como WhatsApp), y el setup toma menos de 5 minutos.

Paso 1 — Crea tu bot con @BotFather:

Paso 2 — Configura el token en OpenClaw:

{
channels: {
  telegram: {
    enabled: true,
    botToken: "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
    dmPolicy: "pairing",
    groups: { "*": { requireMention: true } }
  }
}
}

También puedes ponerlo como variable de entorno en vez de en el config: TELEGRAM_BOT_TOKEN=123456789:ABCdef...

Paso 3 — Arranca el gateway y aprueba tu primer mensaje:

El pairing es un mecanismo de seguridad: la primera vez que alguien le escribe al bot, le pide un código que tú apruebas desde la terminal. Después de aprobado, ya pueden chatear libremente. Los códigos expiran después de 1 hora.

WhatsApp

WhatsApp se conecta vía QR code, similar a WhatsApp Web:

{
channels: {
  whatsapp: {
    dmPolicy: "allowlist",
    allowFrom: ["+525512345678"],  // ← tu número, nadie más
    groups: {
      "*": { requireMention: true }
    }
  }
}
}

Con esta configuración, solo tú puedes hablar con el bot. Todos los demás mensajes se ignoran silenciosamente — sin códigos raros, sin respuestas accidentales a tus contactos.

📧 Email — Gmail con IMAP (Beginner Friendly)

No necesitas Google Cloud Console. Solo un App Password de Gmail. Setup en 5 minutos.

IMAP_HOST=imap.gmail.com
IMAP_PORT=993
IMAP_USER=tu-email@gmail.com
IMAP_PASS=tu-app-password
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=tu-email@gmail.com
SMTP_PASS=tu-app-password

Fuente: Video "How to Install and Use OpenClaw Skills" — paso 3 del tutorial.

📅 Calendario — La verdad sin filtro

Google no te la pone fácil. Después de investigar videos, blogs y docs, la realidad es clara:

La pregunta no es "¿puedo evitar OAuth?" sino "¿sobre qué cuenta lo configuro?"

La estrategia segura: Cuenta dedicada + compartir calendario

Este es el approach más inteligente. El bot tiene su propia cuenta de Google. Nunca tocas OAuth con tu cuenta personal. (Del video "Master OpenClaw in 30 min".)

¿Cómo funciona en la práctica?

¿Necesitas más que email y calendario? Con la misma estrategia de cuenta dedicada + gws CLI puedes darle acceso a tu bot a Drive (buscar y subir archivos), Sheets (leer y escribir datos), Docs, Gmail avanzado (búsquedas, labels, drafts), y prácticamente cualquier API de Google Workspace.

Eso sí — cada servicio adicional requiere habilitar su API en Google Cloud Console y agregar los OAuth scopes correspondientes. Es un setup de una sola vez, pero sí es más complejo que el IMAP de arriba. La buena noticia: con gws CLI todo se maneja desde un solo comando y viene con 100+ skills pre-hechos para que tu agente sepa usarlos.

Cubrimos todo ese proceso paso a paso en nuestra guía de Google Workspace CLI — autenticación, OAuth, comandos, MCP server para Claude/VS Code, y troubleshooting.

Plan recomendado: Cloud VPS 10

Para contexto: 8 GB de RAM y 4 cores es más que suficiente para correr OpenClaw + gateway + múltiples canales. La mayoría de la computación la hacen los modelos AI en la nube — tu VPS solo orquesta las llamadas.

Ubicación: ¿Europa o Estados Unidos?

Los servidores en Europa (Alemania) no tienen costo adicional de ubicación. Los de Estados Unidos tienen un surcharge de ~€0.95/mes (US Central) a ~€1.40/mes (US East) — nada grave.

¿Importa la latencia? Para un chatbot por WhatsApp/Telegram, no realmente. La diferencia entre EU y US es ~100-200ms adicionales, pero el cuello de botella siempre es la API del modelo AI (que tarda 1-5 segundos). Esos 200ms extra son imperceptibles en la conversación.

Elige EU si quieres el precio más bajo. Elige US si quieres latencia ligeramente menor hacia APIs en Estados Unidos (OpenAI, Anthropic). Ambas opciones funcionan perfecto.

Setup con 1-Click de OpenClaw

Contabo tiene una imagen pre-configurada de OpenClaw. El proceso:

Guía completa de Contabo: What is OpenClaw and how do I use it on Contabo?

Asegura tu VPS (5 minutos extra)

Contabo te entrega el servidor con acceso SSH por contraseña. Esto funciona y es razonablemente seguro si tu contraseña es larga y random (30+ caracteres). Pero hay un riesgo: los ataques de brute force — bots que prueban miles de contraseñas por minuto contra tu puerto 22.

Con 3 pasos extra tu servidor queda mucho más protegido: SSH keys (eliminas el riesgo de adivinar contraseñas), Fail2Ban (banea IPs que fallen login), y UFW (firewall que cierra todo excepto SSH).

Paso 1 — Genera tu SSH key (en tu Mac/PC, no en el servidor):

Paso 2 — Instala Fail2Ban y activa UFW (ya conectado al servidor):

Paso 3 (opcional) — Desactiva login por contraseña:

Con esto tu VPS queda con: firewall activo (solo puerto 22 abierto), IPs baneadas automáticamente después de intentos fallidos, y acceso solo por SSH key. Es el estándar de la industria y toma 5 minutos.

¿Quieres profundizar? La guía de Contabo para SSH keys: How to use SSH keys with your server. Para Fail2Ban + UFW a detalle: DigitalOcean — Protect SSH with Fail2Ban.