docs: Telegram Quick setup on Desktop and the Messaging restart banner
This commit is contained in:
@@ -208,7 +208,7 @@ The app also surfaces the broader Hermes management surface so you don't have to
|
||||
- **Memory graph (Star Map)** — type `/journey` (aliases `/learning`, `/memory-graph`) in chat to open an interactive constellation of learned skills and memories over time, with a playback scrubber. Nodes can be edited or deleted right from the panel (skills are archived, memories removed). See [Learning Journey](./features/memory.md#learning-journey-journey).
|
||||
- **Cron** — view and manage [scheduled jobs](../reference/cli-commands.md#hermes-cron).
|
||||
- **Profiles** — switch between [Hermes profiles](./profiles.md) (isolated config/skills/sessions).
|
||||
- **Messaging** — set up gateway channels.
|
||||
- **Messaging** — set up gateway channels. Telegram has a **Quick setup** card: click **Create with QR**, scan the code (or open the link) in Telegram, and Hermes creates the bot, detects your user ID for the allowlist, saves the credentials, and restarts the gateway for you. Any credential save, clear, or enable toggle keeps a **Restart now** banner on the page until the gateway has actually restarted; if a restart fails, the banner stays so you can retry or restart manually.
|
||||
- **Agents** and **Command Center** — orchestration surfaces for multi-agent work.
|
||||
|
||||
### Bot Mode (built in)
|
||||
|
||||
@@ -8,6 +8,10 @@ description: "Set up Hermes Agent as a Telegram bot"
|
||||
|
||||
Hermes Agent integrates with Telegram as a full-featured conversational bot. Once connected, you can chat with your agent from any device, send voice memos that get auto-transcribed, receive scheduled task results, and use the agent in group chats. The integration is built on [python-telegram-bot](https://python-telegram-bot.org/) and supports text, voice, images, and file attachments.
|
||||
|
||||
## Quick setup (dashboard and desktop app)
|
||||
|
||||
The **Messaging → Telegram** page in the [dashboard](../features/web-dashboard.md) and the [desktop app](../desktop.md) has a **Create with QR** button. Scan the code (or open the link) in Telegram; Hermes creates the bot for you, detects your Telegram user ID, writes `TELEGRAM_BOT_TOKEN` and `TELEGRAM_ALLOWED_USERS` into your profile's `.env`, and restarts the gateway. If you prefer to create the bot yourself, follow the manual steps below.
|
||||
|
||||
## Step 1: Create a Bot via BotFather
|
||||
|
||||
Every Telegram bot requires an API token issued by [@BotFather](https://t.me/BotFather), Telegram's official bot management tool.
|
||||
|
||||
Reference in New Issue
Block a user