Skip to content

Telegram Notifications Setup

Lets the agent create a Telegram bot, store its token, and turn on Sentinel alerts for a colony

Repository
aden-hive/hive
Stars
11,132
Licence
Apache-2.0
Files
1 file

What it does

This skill teaches an AI agent to set up Telegram alerts for the Hive colony system. The agent drives the user's own Chrome browser through Telegram Web to create a bot with @BotFather, saves the bot token, detects which chat to notify, and turns on Sentinel so the colony can message the user when it stalls and accept replies. The user must already be logged into Telegram Web, since the agent cannot handle logins.

Great for

  • Hive users who want to be pinged on Telegram when a colony stalls
  • Developers setting up a bot-based notification channel without copying tokens by hand
  • Users who clicked the in-app 'Set this up with the agent' button on the Telegram step

Skip it if

  • Users who are not signed into Telegram Web or cannot use their own Chrome, because the agent cannot log in for them
  • Anyone who does not want an agent to create bots and handle a bot token in their account, since the token grants control of the bot and the file describes a flow that sends and reads messages in their Telegram account
  • Setups that need a group chat without understanding privacy mode, because the bot may not read group messages unless the user changes BotFather settings

Try asking

  • “Set up Telegram notifications so I get pinged when a colony stalls”
  • “Connect Telegram for alerts and send me a test message”
  • “Set up Sentinel on Telegram and allow only my user ID to control the colony”
Step-by-step guide: how to use Telegram Notifications SetupInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the Apache-2.0 licence and an attribution note.

    telegram-notifications-setup.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip telegram-notifications-setup.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip telegram-notifications-setup.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Log into Telegram Web in your own Chrome before asking the agent to start, since it cannot enter your phone number or SMS code
  • If a setup is stuck on PENDING when detecting the chat, send /start to the bot yourself and retry rather than poking at the API
  • Check the bot's @username and the test message in your Telegram chat to confirm the setup worked

What's inside

  • SKILL.md

Redistributed unmodified from aden-hive/hive under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.