Configuracion del bot de Telegram

Guia paso a paso para conectar tu agente de Claw Buff a Telegram

Conecta tu agente de IA de Claw Buff a Telegram para que los usuarios puedan chatear con el por mensaje directo o en chats grupales. La configuracion tarda unos 5 minutos.

Requisitos previos

Una cuenta de Telegram
Un agente de Claw Buff desplegado (Primeros pasos)

Paso 1: Crear un bot con BotFather

Abre BotFather

Abre Telegram y busca @BotFather (busca la marca de verificacion azul). Este es el bot oficial de Telegram para crear y gestionar bots.

Crea tu bot

Envia /newbot a BotFather y sigue las instrucciones:

Nombre del bot — Un nombre visible para tu bot (por ejemplo, "Mi Asistente IA")
Nombre de usuario del bot — Debe terminar en bot (por ejemplo, mi_claw_bot)

Guarda tu Token de Bot

BotFather respondera con un Token de Bot que se ve asi:

123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

Copia este token — lo necesitaras en el siguiente paso.

Manten tu Token de Bot en secreto. Cualquier persona con el token puede controlar tu bot. Nunca lo compartas en chats publicos ni lo subas a Git.

Paso 2: Conectar a Claw Buff

Abre la Consola de Claw Buff → pagina de Canales
Encuentra la tarjeta de Telegram y haz clic en Conectar
Pega tu Token de Bot del Paso 1
Haz clic en Guardar y activar

Tu agente se conectara a Telegram en segundos. Veras que el estado cambia a Conectado.

Paso 3: Autorizar acceso

Por defecto, tu bot usa el modo de emparejamiento — los nuevos usuarios deben ser aprobados antes de poder chatear. Cuando alguien le envia un mensaje a tu bot por primera vez, vera:

OpenClaw: access not configured.
Your Telegram user id: 1234567890
Pairing code: ABCD1234
Ask the bot owner to approve with:
openclaw pairing approve telegram ABCD1234

Aprobar mediante solicitudes pendientes

Ve a tu Consola de Claw Buff → Canales. Cuando alguien solicite acceso, aparecera automaticamente una seccion de Solicitudes de emparejamiento pendientes con el codigo pendiente. Haz clic en Aprobar junto a la solicitud.

Los codigos de emparejamiento expiran despues de 1 hora. Si expiran, el usuario solo necesita enviar un mensaje al bot nuevamente para obtener un nuevo codigo.

Gestionar usuarios autorizados

Tambien puedes gestionar el acceso directamente. Haz clic en Gestionar en la tarjeta del canal de Telegram para:

Ver todos los usuarios actualmente autorizados
Agregar un usuario ingresando su ID de usuario de Telegram (autorizacion proactiva)
Eliminar un usuario para revocar su acceso

Paso 4: Empieza a chatear

Abre Telegram, busca tu bot por su nombre de usuario y envia un mensaje. Tu agente de IA respondera.

Configuracion de chat grupal

Para usar tu bot en grupos de Telegram:

Agrega tu bot al grupo
El bot respondera cuando se le @mencione por defecto

En los grupos, el bot solo responde cuando se le menciona (por ejemplo, @mi_claw_bot como esta el clima?). Esto evita que el bot responda a cada mensaje en grupos activos.

Caracteristicas

Caracteristica	Compatible
Mensajes directos	Si
Chats grupales	Si (requiere mencion)
Respuestas en streaming	Si (escritura en tiempo real)
Formato enriquecido	Si (HTML/Markdown)
Temas del foro	Si
Archivos adjuntos	Si

Preguntas frecuentes

1. El bot no responde?

Verifica el token — Asegurate de haber pegado el token completo sin espacios extra
Verifica la Consola — La pagina de Canales muestra el estado de conexion y los registros de errores
Problemas de red — Tu agente necesita acceso saliente a api.telegram.org en el puerto 443

2. El bot responde lento?

El streaming esta habilitado por defecto. El bot edita su mensaje en tiempo real a medida que la IA genera una respuesta. Si ves retrasos, revisa la configuracion de tu modelo en Consola → Agente → Modelo.

3. "Forbidden: bot was blocked by the user"?

El usuario ha bloqueado tu bot en Telegram. Necesita desbloquearlo y enviar /start de nuevo.