Jeden Hermes-Befehl und jedes Skill in Telegram durchsuchen: Der @botname-Inline-Picker umgeht die 60-Slot-Grenze des Menüs


Kennst du diesen Moment: Du nutzt Hermes als deinen Hauptassistenten in Telegram, installierst Skill um Skill – und dann brauchst du eines Tages in einem Gruppenchat genau einen bestimmten Skill: Du tippst /, scrollst – und er ist nicht da. Er fehlt nicht; das Menü ist einfach voll. Telegram begrenzt das BotCommand-Menü hart (100 Befehle pro Scope, ~4 KB Payload; Hermes nutzt standardmäßig 60 Slots), sodass die meisten Skill-Befehle nie im /-Menü erscheinen können, sobald deine Skill-Sammlung wächst. Eine am 30. August gemergte Funktion umgeht diese Grenze komplett: Tippe @deinbotname + ein Stichwort in einen beliebigen Chat – und ein live durchsuchbarer Picker öffnet sich über alle Befehle und installierten Skills; ein Tipp sendet den Befehl in den Chat. Die Änderung stammt aus PR #98317 und liegt derzeit auf main, noch in keinem Release.

Warum das /-Menü „voll läuft“

Telegrams Befehlsmenü hat eine harte Plattformgrenze: 100 Befehle pro Scope, ~4 KB Gesamt-Payload. Hermes’ Standardstrategie registriert nur 60 Slots mit den am häufigsten genutzten Befehlen. Der Haken: Skills werden ebenfalls als Slash-Befehle aufgerufen, jeder installierte Skill fügt also einen weiteren Eintrag hinzu – installiere ein paar Dutzend Skills und die meisten ihrer Befehle werden nie in das /-Menü passen. Nicht Hermes ist knauserig; die Telegram-Box ist einfach so klein.

So funktioniert der Inline-Picker

Keine Konfiguration nötig – abgesehen von dem einmaligen Setup weiter unten. Tippe in einem beliebigen Telegram-Chat einfach:

@yourbotname keyword

Wenn dein Bot myagent heißt und du nach Planungsbefehlen suchst:

@myagent plan

Der Bot antwortet mit einem live durchsuchbaren Picker, der jeden passenden Befehl und jedes Skill auflistet – pro Tastendruck berechnet, 50 Einträge pro Seite, mit einem vollständigen Katalog, der nie etwas kürzt. In offiziellen Tests lieferte eine Session mit 72 installierten Skills 138 Einträge (gegenüber 60 Slots im /-Menü) – inklusive des am seltensten genutzten Skills ganz am Ende der Liste.

Tippe ein Ergebnis an und der Befehlstext (z. B. /plan migrate auth) wird als du in den Chat gesendet. Da befehlspräfixierte Nachrichten den Bot auch im Standard-Privacy-Modus erreichen, läuft die Zustellung über den bestehenden Befehlspfad – es war keinerlei neuer Dispatch-Code nötig.

Einmaliges Setup: /setinline im BotFather

Der Inline-Modus ist bei jedem Telegram-Bot standardmäßig deaktiviert. Aktiviere ihn einmal:

  1. Öffne @BotFather;
  2. Sende /setinline und wähle deinen Bot;
  3. Lege einen Platzhaltertext fest (z. B. Search commands and skills...).

Bis du das tust, liefert Telegram keine Inline-Queries aus und der Picker bleibt stumm – genau deshalb ist der Handler bedingungslos registriert: harmlos, wenn aus; sofort aktiv, wenn an.

Sicherheitsgrenze: Fremde sehen eine leere Liste

Inline-Queries können aus jedem Chat kommen, auch aus solchen, in denen dein Bot gar nicht ist – deshalb ist die Authentifizierung eine harte Grenze: Nur Nutzer, die deine Gateway-Allowlist, dein Pairing oder dein Multi-Profile-Routing passieren, sehen Ergebnisse – nicht autorisierte Nutzer bekommen eine leere Liste, dein Katalog installierter Skills wird also nie an Fremde durchgereicht. Ergebnisse sind zudem mit is_personal=True markiert, sodass Telegram keine gecachten Seiten zwischen Nutzern teilt.

Das dritte Bein der Menü-Limit-Arbeit

Das ist der letzte von drei Schritten gegen das Problem „Menü zu klein“: PR #98272 machte /plan zu einem eingebauten Befehl, der das Discord-Menü-Limit übersteht, PR #98280 verschaffte angepinnten Skill-Befehlen Prioritäts-Slots, und dieser Inline-Picker umgeht das Menü komplett, statt sich hineinzuquetschen. Mehr zum Betrieb von Hermes über Chat-Plattformen findest du in unserem Bot-Mode-Gruppenchat-Guide.

Wann du es nutzen kannst

PR #98317 wurde am 30. August gemergt und ist nicht in v0.20.6 (getaggt am 27. August). Um es heute auszuprobieren, ziehe das aktuelle main; ansonsten kommt es mit dem nächsten Release. Upgrade-Pfade findest du im Installations-Guide. Wenn du mehrere Profile über Messaging-Plattformen routest, liefert der Multi-Profile-Routing-Guide den passenden Hintergrund.

Fazit: In Telegrams Menü-Box passt nur eine begrenzte Menge – aber deine Skill-Bibliothek muss nicht schrumpfen, um hineinzupassen. Der Live-Such-Picker aus @botname + Stichwort macht jeden Befehl und jedes Skill auffindbar – installiere 100 Skills, ohne auch nur eines zu verlieren.