fix(telegram): actionable error for DM topics when Topics mode not enabled (#13162)

When createForumTopic fails with 'not a forum' in a private chat,
the error now tells the user exactly what to do: enable Topics in
the DM chat settings from the Telegram app.

Also adds a Prerequisites callout to the docs explaining this
client-side requirement before the config section.
This commit is contained in:
Teknium 2026-04-20 12:29:22 -07:00 committed by GitHub
parent 3cba81ebed
commit b65f6ca7fe
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 17 additions and 0 deletions

View file

@ -325,6 +325,16 @@ Each topic gets its own conversation session, history, and context — completel
### Configuration
:::caution Prerequisites
Before adding topics to your config, the user must **enable Topics mode** in the DM chat with the bot:
1. Open your private chat with the Hermes bot in Telegram
2. Tap the bot's name at the top to open chat info
3. Enable **Topics** (the toggle to turn the chat into a forum)
Without this, Hermes will log `The chat is not a forum` on startup and skip topic creation. This is a Telegram client-side setting — the bot cannot enable it programmatically.
:::
Add topics under `platforms.telegram.extra.dm_topics` in `~/.hermes/config.yaml`:
```yaml