hermes-telegram-bot-setup

Creates and configures a dedicated Telegram bot profile with gateway for Hermes Agent.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/decniner/HermesP1 --skill hermes-telegram-bot-setup-decniner
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-telegram-bot-setup
Source: https://github.com/decniner/HermesP1/tree/main/.hermes-backup/skills/telegram-bots/hermes-telegram-bot-setup
Command: npx skills add https://github.com/decniner/HermesP1 --skill hermes-telegram-bot-setup-decniner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a new Telegram bot as a separate Hermes Agent profile involves many manual steps—creating the profile, writing SOUL.md and config.yaml, wiring bot tokens and API keys into .env, and starting the gateway—where missing any step causes silent failures like "no credentials configured" errors. ## Core Features & Use Cases - Profile Scaffolding: Creates a dedicated Hermes profile with its own SOUL.md personality, config.yaml model settings, and .env token wiring. - Gateway Startup & Verification: Starts the Telegram gateway, handles service installation prompts, and verifies connectivity via gateway logs. - Pitfall Guidance: Documents common failures such as missing DEEPSEEK_API_KEY, wrong Telegram user IDs, and token rotation. - Use Case: You want a separate Telegram bot for Japanese lessons with its own personality. Provide the @BotFather token and your Telegram user ID, and this Skill walks through profile creation, configuration, gateway start, and testing. ## Quick Start Set up a new Telegram bot profile named japanese-tutor using this bot token from @BotFather and my Telegram user ID, then start and verify its gateway.

Frequently Asked Questions about hermes-telegram-bot-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a Telegram bot with Hermes Agent?▼

Create a profile with hermes profile create, write SOUL.md and config.yaml, add TELEGRAM_BOT_TOKEN and TELEGRAM_ALLOWED_USERS to the profile .env, then run hermes --profile <name> gateway start. Verify connectivity in the profile's gateway.log.

Why does my Telegram bot say no credentials configured?▼

The profile .env is empty after profile create and contains no API keys. Copy DEEPSEEK_API_KEY from the main ~/.hermes/.env into the profile's .env, then restart the gateway.

Why does my Telegram bot ignore my messages?▼

The bot silently ignores users not listed in TELEGRAM_ALLOWED_USERS. The value must be your numeric Telegram user ID, not your username; get it from @userinfobot and restart the gateway.

Can I run multiple Telegram bot gateways on the same machine?▼

Yes, each Hermes profile gateway runs independently and automatically uses a different port, so no manual port configuration is needed. Use tasklist to see all gateway node processes.

How do I update a revoked Telegram bot token?▼

Update only the TELEGRAM_BOT_TOKEN value in the profile's .env file and restart the gateway with hermes --profile <name> gateway restart. No other profile changes are needed.