Conectar Telegram a OpenClaw de forma segura

2026-09-26

🧪 Receta de nivel 1 — redactada por el agente del laboratorio a partir de la doc oficial de Telegram. Pendiente de verificación end-to-end en el laboratorio; si algo cambia, se actualiza con fecha.

1. Crea el bot en BotFather

Abre Telegram y habla con @BotFather (verifica el handle exacto: hay suplantes). Ejecuta /newbot, elige nombre y handle, y guarda el token (123456:ABC-DEF...). Alternativa: la web-app de BotFather (t.me/BotFather?startapp) desde cualquier cliente Telegram.

2. Registra el token en OpenClaw

La vía rápida es el CLI (escribe la config por ti):

openclaw channels add --channel telegram --token <bot-token>

Si prefieres editar la config a mano, en ~/.openclaw/openclaw.json:

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "123:abc",
      dmPolicy: "pairing",
      groups: { "*": { requireMention: true } },
    },
  },
}

3. Qué significa cada línea (y por qué se queda así)

dmPolicy: "pairing" — es el valor por defecto de Telegram en OpenClaw y es el correcto: nadie puede hablar con tu bot hasta que apruebes el primer intercambio. Tu bot no es público para desconocidos.
groups: { "*": { requireMention: true } } — en grupos, el bot solo responde si lo mencionan. Sin esto, un bot en un grupo ruidoso responde a todo y quema la cuota de API.
botToken — el token va en la config del servidor, nunca en un repositorio. Existe el fallback de variable de entorno TELEGRAM_BOT_TOKEN (solo para la cuenta por defecto); para varias cuentas usa botToken o tokenFile.

4. Verifica

Con el Gateway corriendo (y el hot reload activo, no hace falta reiniciar), mándale un mensaje a tu bot desde tu cuenta. La primera vez pasará por el emparejamiento: apruébalo y a partir de ahí el canal queda abierto para ti.

Errores típicos

Síntoma	Causa	Solución
Token rechazado al arrancar	Copiado con espacios o incompleto	Re-copy completo desde BotFather
El bot no responde en grupos	Falta `requireMention` o no está en el grupo	Menciónalo: `@tu_bot hola`
`channels login telegram` falla	Telegram no usa ese flujo	Token por config o env, y arrancar el Gateway

Fuentes: Telegram setup · Telegram (visión general) — docs.openclaw.ai exporta cualquier página en Markdown añadiendo .md a la URL.