platform-telegram

Wire a Hermes agent to Telegram with token validation and allowlist gating.

13|1|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/paarths-collab/hstack --skill platform-telegram
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: platform-telegram
Source: https://github.com/paarths-collab/hstack/tree/main/skills/platform-telegram
Command: npx skills add https://github.com/paarths-collab/hstack --skill platform-telegram

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill connects a self-hosted Hermes agent to Telegram so users can control a remote AI agent without QR pairing, OAuth setup, or unreliable headless platform workarounds.

Core Features & Use Cases

  • Verified Telegram bot wiring: Stores a BotFather token, validates it against the Telegram API, and enables the bot only after the token is confirmed.
  • Hard allowlist protection: Requires numeric Telegram user IDs before activation so only approved users can message the agent.
  • SSH-first remote deployment: Updates Hermes configuration on a VPS, reloads the gateway, and supports idempotent re-runs with rollback-safe behavior.
  • Use Case: A developer wants to expose a private Hermes agent to Telegram for personal remote control, then verify that only their account can interact with it.

Quick Start

Ask the agent to wire an existing Hermes deployment to Telegram using your BotFather token and numeric allowlist, then verify the bot is reachable and safely enabled.

Frequently Asked Questions about platform-telegram

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

FAQPage Schema
How do I connect a Telegram bot to a remote agent on a VPS?

To connect a Telegram bot to a remote agent on a VPS, you wire a verified BotFather token and numeric user ID allowlist into the agent's configuration via SSH, then reload the gateway to enable secure messaging.

Can I restrict Telegram bot access to specific users only?

Yes, you can restrict Telegram bot access using a hard numeric allowlist that requires approved Telegram user IDs before activation, ensuring only authorized accounts can message and control the agent.

Do I need OAuth or QR pairing to control an AI agent through Telegram?

No, you do not need OAuth or QR pairing to control an AI agent through Telegram. Wiring a verified bot token directly into the gateway bypasses unreliable headless platform workarounds for remote access.

What happens if my gateway restart fails during Telegram bot deployment?

If a gateway restart fails during Telegram bot deployment, the SSH-first workflow applies rollback-safe behavior and idempotent environment writes, allowing safe re-runs without corrupting the existing configuration.

How is the Telegram bot token verified before activating the agent?

The Telegram bot token is verified by validating its format and querying the Telegram getMe API, which confirms the token's validity before the bot is enabled and wired into the agent environment.