Configurar Telegram (Recomendado para Empezar)

Telegram es el canal más fácil para empezar con OpenClaw. Voice notes, media, groups — todo funciona. Y sí, vas a tener que hablar con alguien llamado "BotFather". Cierra los ojos y hazlo.

Paso 1: Crear Tu Bot en Telegram

1. Abre Telegram en tu celular
2. Busca @BotFather (verificado, con checkmark azul)
3. Envíale /newbot
4. Te pide un nombre — pon el nombre de tu agente: "Polly", "Claudia", "Max"
5. Te pide un username — debe terminar en bot: polly_assistant_bot
6. Te da un bot token — guárdalo en tu password manager

El token se ve algo así: 7391826450:AAHr-kE9xMp2q...

Paso 2: Configurar Privacidad del Bot

Mientras estás con BotFather, envía estos comandos:

/setprivacy → Disable

Esto permite que tu bot vea todos los mensajes en grupos (no solo cuando lo mencionan). Necesario si quieres usarlo en group chats.

/setjoingroups → Enable

Permite que lo añadas a grupos.

Paso 3: Conectar con OpenClaw

En la terminal de tu máquina OpenClaw, edita la configuración:

# Abre el archivo de configuración
nano ~/.openclaw/openclaw.json

Agrega o edita la sección de Telegram:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "7391826450:AAHr-kE9xMp2q...",
      "dmPolicy": "pairing"
    }
  }
}

O usa variable de entorno:

export TELEGRAM_BOT_TOKEN="7391826450:AAHr-kE9xMp2q..."

Paso 4: Iniciar el Gateway

openclaw gateway

El gateway empieza a escuchar mensajes de Telegram via long polling.

Paso 5: Pairing — Vincularte con Tu Bot

Con dmPolicy: "pairing" (default y recomendado), no cualquiera puede hablarle a tu bot.

1. Abre Telegram y busca tu bot por su username
2. Envíale un mensaje: "Hola"
3. El bot te dará un código de pairing (expira en 1 hora)
4. En la terminal, aprueba el código:

openclaw pairing list telegram
openclaw pairing approve telegram <CÓDIGO>

Ya está. Tu bot y tú están vinculados.

Paso 6: Prueba Todo

Envíale un mensaje desde tu celular. Prueba:

• Texto normal: "¿Qué hay en mi calendario mañana?"
• Voice note: mantén el botón de micrófono y habla (OpenClaw transcribe con Whisper)
• Imagen: envía una foto y pregunta algo sobre ella

Group Chats

Puedes añadir tu bot a un grupo de Telegram (por ejemplo, con tu pareja para gestión familiar):

1. Añade el bot al grupo
2. Consigue el Group ID (forward un mensaje del grupo a @userinfobot)
3. Configura en openclaw.json:

{
  "channels": {
    "telegram": {
      "groups": {
        "-1001234567890": {
          "requireMention": true,
          "groupPolicy": "allowlist",
          "allowFrom": ["tu_telegram_id", "id_de_tu_pareja"]
        }
      }
    }
  }
}

Con requireMention: true, el bot solo responde cuando lo mencionas directamente. No se mete en cada conversación — como un buen empleado.

Voice Notes — El Game Changer

Una de las features más subestimadas. En Telegram, mantén el botón de micrófono y habla. OpenClaw:

1. Recibe el audio
2. Lo transcribe (Whisper)
3. Procesa el texto
4. Responde

Esto es perfecto para:

• Onboarding: Ramble sobre quién eres y qué necesitas
• Sobre la marcha: Estás manejando o cargando a un bebé, no puedes tipear
• Brainstorming: Ideas sueltas que quieres que tu agente capture

Jesse Genet (madre homeschooler con 4 hijos) usa voice notes constantemente: "Está en el piso con sus hijos haciendo una lección y tiene una idea para la siguiente. No va a pararse a tipear. Le envía un voice note a su agente y sigue con los niños."