Você já passou por isso: usa o Hermes como assistente principal no Telegram, instala skill após skill e, um dia, precisa de uma skill específica num chat em grupo — digita /, rola a lista e ela não está lá. Ela não sumiu; o menu simplesmente ficou sem espaço. O Telegram impõe um limite rígido ao menu de BotCommand (100 comandos por escopo, ~4KB de payload; o Hermes usa 60 slots por padrão), então, quando o número de skills cresce, a maioria dos comandos de skill nunca aparece no menu /. Um recurso mesclado em 30 de agosto contorna o limite por completo: digite @nome-do-seu-bot + uma palavra-chave em qualquer chat e um seletor ao vivo e pesquisável se abre com todos os comandos e skills instalados — um toque envia o comando para o chat. A mudança vem do PR #98317 e vive atualmente na main, ainda sem release.

Por que o menu / “enche”

O menu de comandos do Telegram tem um limite rígido de plataforma: 100 comandos por escopo, ~4KB de payload total. A estratégia padrão do Hermes registra apenas 60 slots com os comandos mais usados. O problema: skills também são invocadas como comandos de barra, então cada skill instalada adiciona mais uma entrada — instale algumas dezenas de skills e a maioria dos comandos delas nunca caberá no menu /. Não é o Hermes sendo econômico; a caixa do Telegram é que é pequena.

Como funciona o seletor inline

Nenhuma configuração é necessária além do setup único abaixo. Em qualquer chat do Telegram, basta digitar:

@yourbotname keyword

Se o seu bot se chama myagent e você procura comandos de planejamento:

@myagent plan

O bot responde com um seletor ao vivo e pesquisável listando todos os comandos e skills correspondentes — calculado a cada tecla, paginado de 50 em 50, com um catálogo completo que nunca corta nada. Em testes oficiais, uma sessão com 72 skills instaladas exibiu 138 entradas (contra 60 slots no menu /), incluindo a skill menos usada, bem no fim da lista.

Toque em um resultado e o texto do comando (ex.: /plan migrate auth) é enviado para o chat como você. Como mensagens com prefixo de comando chegam ao bot mesmo no modo de privacidade padrão, o despacho flui pelo caminho de comando existente — não foi necessário nenhum código novo de despacho.

Setup único: /setinline no BotFather

O modo inline fica desligado por padrão em todo bot do Telegram. Habilite-o uma vez:

1. Abra o @BotFather;
2. Envie /setinline e escolha seu bot;
3. Defina um texto de placeholder (ex.: Search commands and skills...).

Até você fazer isso, o Telegram nunca entrega consultas inline e o seletor permanece inerte — por isso o handler é registrado incondicionalmente: inofensivo quando desligado, instantâneo quando ligado.

Limite de segurança: estranhos veem uma lista vazia

Consultas inline podem chegar de qualquer chat, inclusive daqueles em que seu bot não está, então a autenticação é uma barreira rígida: só usuários que passam pelo seu gateway allowlist / pareamento / roteamento multiplex veem resultados — usuários não autorizados recebem uma lista vazia, então seu catálogo de skills instaladas nunca vaza para estranhos. Os resultados também são marcados com is_personal=True, para o Telegram não compartilhar páginas em cache entre usuários.

A terceira investida contra o limite do menu

Esta é a última de três investidas contra o problema do “menu pequeno demais”: o PR #98272 tornou /plan um comando embutido que sobrevive ao limite de menu do Discord, o PR #98280 fez os comandos de skill fixados ocuparem slots prioritários, e este seletor inline contorna o menu por completo, em vez de se espremer nele. Para saber mais sobre como rodar o Hermes em plataformas de chat, veja nosso guia de Bot Mode em chats em grupo.

Quando você pode usar

O PR #98317 foi mesclado em 30 de agosto e não está no v0.20.6 (tag de 27 de agosto). Para testar hoje, puxe a main mais recente; caso contrário, ele chega no próximo release. Veja o guia de instalação para os caminhos de upgrade. Se você roteia vários profiles em plataformas de mensageria, o guia de roteamento multi-profile traz o contexto relevante.

Resumindo: a caixa do menu do Telegram só comporta até certo ponto, mas sua biblioteca de skills não precisa encolher para caber. O seletor de busca ao vivo @botname + palavra-chave torna todo comando e skill encontráveis — instale 100 skills sem perder nenhuma delas.