¿Te ha pasado alguna vez esta situación? Usas Hermes como tu asistente principal en Telegram, instalas skill tras skill, y un día necesitas un skill concreto en un chat de grupo — escribes /, desplazas la lista, y no está. No es que falte: el menú simplemente se ha quedado sin espacio. Telegram impone un límite estricto al menú BotCommand (100 comandos por scope, ~4 KB de payload; Hermes usa 60 slots por defecto), así que cuando el número de skills crece, la mayoría de sus comandos nunca podrán aparecer en el menú /. Una función integrada el 30 de agosto sortea el límite por completo: escribe @nombre-de-tu-bot + una palabra clave en cualquier chat y se abre un selector vivo y buscable sobre todos los comandos y skills instalados — un toque envía el comando al chat. El cambio llega de PR #98317 y actualmente vive en main, aún sin publicar en una release.

Por qué el menú / se “llena”

El menú de comandos de Telegram tiene un límite estricto a nivel de plataforma: 100 comandos por scope, ~4 KB de payload total. La estrategia por defecto de Hermes registra solo 60 slots con los comandos más usados. El detalle: las skills también se invocan como comandos de barra, así que cada skill instalado añade otra entrada — instala unas cuantas decenas de skills y la mayoría de sus comandos nunca cabrán en el menú /. No es que Hermes sea cicatero; es que la caja de Telegram es así de pequeña.

Cómo funciona el selector inline

No hace falta configuración más allá de la puesta a punto única que se describe abajo. En cualquier chat de Telegram, escribe simplemente:

@yourbotname keyword

Si tu bot se llama myagent y buscas comandos de planificación:

@myagent plan

El bot responde con un selector vivo y buscable que lista todos los comandos y skills que coinciden — calculado pulsación a pulsación, paginado de 50 en 50, con un catálogo completo que nunca recorta nada. En las pruebas oficiales, una sesión con 72 skills instalados mostró 138 entradas (frente a los 60 slots del menú /), incluido el skill menos usado, al final de la lista.

Toca un resultado y el texto del comando (p. ej. /plan migrate auth) se envía al chat como tú. Como los mensajes con prefijo de comando llegan al bot incluso con el modo de privacidad por defecto, el despacho fluye por la ruta de comandos existente — no hizo falta ni una línea de código de despacho nuevo.

Configuración única: /setinline en BotFather

El modo inline está desactivado por defecto en todos los bots de Telegram. Actívalo una vez:

1. Abre @BotFather;
2. Envía /setinline y elige tu bot;
3. Define un texto de placeholder (p. ej. Search commands and skills...).

Mientras no lo hagas, Telegram no entregará nunca las consultas inline y el selector permanece inerte — por eso el handler se registra de forma incondicional: inofensivo cuando está apagado, instantáneo cuando está encendido.

Límite de seguridad: los desconocidos reciben una lista vacía

Las consultas inline pueden llegar desde cualquier chat, incluidos aquellos en los que tu bot no está, así que la autenticación es una puerta dura: solo los usuarios que superan tu allowlist de gateway / pairing / enrutamiento multiplex ven resultados — los usuarios no autorizados reciben una lista vacía, de modo que tu catálogo de skills instalados nunca se filtra a desconocidos. Los resultados además se marcan con is_personal=True, así que Telegram no compartirá páginas cacheadas entre usuarios.

La tercera pata del trabajo sobre el límite del menú

Esta es la última de tres movidas contra el problema del “menú demasiado pequeño”: PR #98272 convirtió /plan en un comando integrado que sobrevive al límite de menú de Discord, PR #98280 hizo que los comandos fijados de skills ocupen slots prioritarios, y este selector inline sortea el menú por completo en lugar de apiñarse dentro de él. Para saber más sobre cómo ejecutar Hermes en plataformas de chat, consulta nuestra guía de chats de grupo en Bot Mode.

Cuándo puedes usarlo

El PR #98317 se integró el 30 de agosto y no está en v0.20.6 (etiquetada el 27 de agosto). Para probarlo hoy, haz pull de la última main; si no, llegará en la próxima release. Consulta la guía de instalación para conocer las rutas de actualización. Si enrutas varios profiles en plataformas de mensajería, la guía de enrutamiento multi-profile contiene los antecedentes relevantes.

En resumen: la caja del menú de Telegram solo admite cierta cantidad, pero tu biblioteca de skills no tiene por qué encogerse para caber. El selector de búsqueda en vivo @botname + palabra clave hace que todos los comandos y skills sean descubribles — instala 100 skills sin perder ninguno.