Desbloquea la potencia de Telegram con el modo hilo de OpenClaw

4. Añadir el bot a grupos y temas

Para permitir que tu asistente participe en chats de grupo o temas del foro, añádelo a los grupos de Telegram que desees y, a continuación, actualiza la opción canales.telegram.grupos configuración. Por ejemplo:

"canales": {
  "telegrama": {
    "grupos": {
      "-100123456789": { "requireMention": true },
      "*": { "requireMention": false }
    },
    "groupPolicy": "allowlist"
  }
}

Aquí, el * sirve de cajón de sastre para cualquier grupo; requireMention: true garantiza que el asistente no envíe spam al canal. También puede configurar groupPolicy a abra para permitir que el bot se una automáticamente a cualquier grupo que lo invite, o desactivado para bloquear completamente el uso de grupos. Después de configurar los grupos, reinicia la pasarela y vuelve a añadir el bot a cada grupo si has cambiado la configuración de privacidad.

Comprender el modo de rosca

Telegram introducido temas de foro en 2022, lo que permite a los grandes grupos dividir las conversaciones en hilos separados. OpenClaw aprovecha esta característica añadiendo :tema: a sus claves de sesión internas. Esto significa que cada tema tiene su propio contexto de conversación; los mensajes enviados en un hilo no se transfieren a otro. De este diseño se derivan dos comportamientos importantes:

1. Aislamiento temático: Cuando el asistente recibe un mensaje con un message_thread_id, utiliza una clave de sesión como telegrama::tema:. Las respuestas se envían de vuelta al mismo hilo. Así es como el agente mantiene el contexto en largas discusiones multihilo.
2. Tema general frente a tema específico: Telegram trata el hilo ID 1 como el tema “general” por defecto. Cuando envíes mensajes al tema 1, debes omitir el parámetro message_thread_id en la llamada a la API; de lo contrario Telegram la rechaza. OpenClaw maneja esto automáticamente cuando envía respuestas.

El modo hilo no se limita a los supergrupos del foro. En los chats privados (DMs), Telegram a veces adjunta un message_thread_id a las respuestas a mensajes más antiguos. OpenClaw conserva este ID y utiliza claves de sesión con seguimiento de hilos, por lo que tu historial de conversaciones permanece organizado incluso en los DM.

Configuración del modo de respuesta

Por defecto, OpenClaw establece channels.telegram.replyToMode a fuera de, que desactiva la respuesta implícita. Si prefiere que el asistente responda directamente al mensaje desencadenante, configure replyToMode a primero o todos. También puede incluir etiquetas explícitas como [[reply_to_current]] o [[reply_to:]] en la respuesta de su agente. Estas etiquetas indican a la pasarela que enhebre la respuesta en consecuencia.

Indicadores de streaming y mecanografía

OpenClaw soporta el streaming de respuestas parciales en Telegram. Con canales.telegram.streaming ajustado a parcial o progreso, la pasarela envía un mensaje temporal y lo edita a medida que el modelo genera texto. Esto proporciona una mejor experiencia de usuario en respuestas largas. Incluso puede habilitar la salida de razonamiento en tiempo real a través de la función /corriente de razonamiento durante una conversación. Los indicadores de escritura se envían automáticamente, incluso en los hilos; sin embargo, para el ID de hilo 1 (tema general) Telegram ignora message_thread_id en la acción de teclear.

Reacciones, pegatinas y comandos en línea

La API de bots de Telegram admite reacciones a mensajes, stickers y botones en línea. OpenClaw expone estas características a través de su sistema de acciones:

• Reacciones: En reaccionar permite al agente reaccionar a un mensaje con un emoji. Las notificaciones de reacción pueden configurarse a través de channels.telegram.reactionNotifications y reactionLevel, Activar notificaciones para mensajes bot, todos los mensajes o ninguno. Ten en cuenta que Telegram no proporciona IDs de hilos para las reacciones, por lo que siempre se enrutan al hilo principal.
• Pegatinas: Activa las acciones de pegatina configurando channels.telegram.actions.sticker: true. Los adhesivos se almacenan localmente en caché; puedes buscar en la caché con la función búsqueda de pegatinas acción y enviar una pegatina con pegatina.
• Botones en línea: Configure channels.telegram.capabilities.inlineButtons para definir cuándo se permiten los teclados en línea (off, dm, group, all o allowlist). A continuación, puede enviar un mensaje con botones incluyendo un botón botones en el cuerpo de la acción.

Casos de uso del modo hilo

El modo de hilo desbloquea potentes flujos de trabajo que, de otro modo, serían confusos o imposibles en un solo chat. He aquí algunos ejemplos prácticos:

1. Coordinación multiproyecto

Imagina que gestionas varios proyectos simultáneamente. Crea un único supergrupo de Telegram y habilita los temas del foro. Para cada proyecto, crea un tema dedicado (por ejemplo, Rediseño del sitio web, Campaña de marketing, Corrección de errores). Cuando envías un mensaje a tu asistente dentro de un tema, OpenClaw utiliza automáticamente una clave de sesión única para ese hilo. Esto mantiene el contexto de la conversación separado, de modo que cuando usted pregunta por “la fecha límite”, el asistente sabe a qué proyecto se está refiriendo.

2. Hilos paralelos privados en los chats de grupo

En un ajetreado chat familiar o de equipo, puede que quieras hacer una pregunta a tu asistente sin interrumpir la conversación principal. Responde a tu mensaje anterior o menciona al bot en una respuesta; Telegram adjunta un message_thread_id, para que OpenClaw dirija la conversación a un hilo vinculado a ese mensaje. Ahora puedes hacer preguntas de seguimiento como “¿Cuál es mi lista de tareas pendientes?” o “Resume los mensajes de hoy” sin saturar el chat principal.

3. Tareas de larga duración

Algunas tareas llevan tiempo: resumir un documento largo, generar un informe o ejecutar un script. Iniciar estas tareas en un hilo mantiene organizadas las actualizaciones de progreso. Establecer canales.telegram.streaming a progreso para que el asistente envíe un mensaje de previsualización y lo edite hasta que el resultado final esté listo. Si tienes varias tareas largas, cada hilo permanece aislado, lo que evita las conversaciones cruzadas.

4. Sesiones de brainstorming

Los temas de los foros pueden funcionar como salas de intercambio de ideas. Por ejemplo, abra un tema llamado Ideas para blogs y haga una lluvia de ideas sobre artículos con su agente. El asistente mantendrá el contexto de las sugerencias anteriores dentro de la conversación, lo que facilitará el perfeccionamiento y la ampliación de las ideas. Mientras tanto, el chat general permanece despejado.

5. Atención al cliente o FAQ

Si gestiona un chat comunitario, puede crear temas para diferentes preguntas de soporte. Los usuarios hacen preguntas en sus propios hilos, y su agente OpenClaw responde con información adaptada. Como las claves de sesión son específicas de cada tema, el agente no confundirá las respuestas. Incluso puede delegar tareas: el agente podría presentar incidencias en GitHub o crear eventos de calendario como acciones de seguimiento.

Solución de problemas y consejos

Modo privacidad: Los bots de Telegram están por defecto en modo privacidad, lo que significa que sólo ven los mensajes que empiezan por / comandos o mencionarlos. Si necesita una visibilidad total de los mensajes en un grupo, desactive la privacidad mediante /setprivacy o haz que el bot sea un administrador. Recuerda eliminar y volver a añadir el bot para que los cambios surtan efecto.

Límites de la historia: OpenClaw almacena un historial limitado por chat o hilo (50 mensajes por defecto para grupos y configurado mediante channels.telegram.historyLimit). Aumente este límite si su agente necesita más contexto, pero tenga en cuenta el uso de memoria.

Webhook vs sondeo largo: Por defecto, OpenClaw utiliza el sondeo largo, que es más fácil de configurar. Si desea utilizar webhooks (por ejemplo, para reducir la latencia), configure channels.telegram.webhookUrl y webhookSecret. Consulte la documentación para conocer las opciones de puerto y host.

Etiquetas de respuesta explícitas: Utilice [[reply_to_current]] o [[respuesta_a:]] en las respuestas de su agente cuando necesite un control detallado sobre los objetivos de respuesta. Esto es especialmente útil para los bots que supervisan varios hilos simultáneamente.

Gestionar el acceso: Utilice channels.telegram.allowFrom y groupPolicy para restringir quién puede hablar con tu bot y a qué grupos puede unirse. Esto evita el spam y los comandos no autorizados.

Conclusión

Telegram es una de las plataformas más versátiles para ejecutar un agente OpenClaw. Entendiendo cómo funciona el modo de hilos y configurando los grupos y DMs adecuadamente, puedes construir conversaciones ricas y multi-contexto que se mantengan organizadas. Utiliza hilos para separar proyectos, ejecutar tareas de larga duración, facilitar el intercambio de ideas o proporcionar asistencia al cliente. Aprovecha funciones como las vistas previas en streaming, los botones en línea y las notificaciones de reacción para crear una experiencia atractiva. Con la configuración adecuada, tu asistente OpenClaw se sentirá como un participante natural en tu comunidad de Telegram.