# Hive.telegram Notifications Setup

Set up a Telegram notification channel (Sentinel) for a colony by driving the browser, ...

- Repository: https://github.com/aden-hive/hive (11131 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-10-26
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add aden-hive/hive --skill hive.telegram-notifications-setup -g -a claude-code -y`
Codex: `npx skills add aden-hive/hive --skill hive.telegram-notifications-setup -g -a codex -y`
Cursor: `npx skills add aden-hive/hive --skill hive.telegram-notifications-setup -g -a cursor -y`
Gemini CLI: `npx skills add aden-hive/hive --skill hive.telegram-notifications-setup -g -a gemini-cli -y`

## Description

Set up a Telegram notification channel (Sentinel) for a colony by driving the browser, create a bot via @BotFather in Telegram Web, store its token, detect the chat to notify, and turn Sentinel on so the colony can ping the user on Telegram and accept replies. Use when the user asks to "set up Telegram notifications", "get pinged on Telegram", "connect Telegram for alerts", "set up Sentinel on Telegram", or clicks the in-app "Set this up with the agent" button on the Telegram step. Requires hive.browser-automation.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Telegram Notifications Setup (Sentinel)

Sentinel pings the user on Telegram when a colony stalls and lets them reply to
keep it going. It needs one thing: a **Telegram bot token** (`123456:ABC-…`),
created via @BotFather and stored under credential id `telegram`. The same token
sends alerts and reads the user's replies.

You do the whole thing end to end with the **`sentinel_setup`** tool (the same API
the desktop connector uses): create the bot, store the token, detect the chat,
point Sentinel at it, and send a test, without making the user paste anything.

**Activate `hive.browser-automation` first**, this skill assumes you know the
lifecycle rules (the bridge attaches to the user's own Chrome; never launch or kill
a browser), the screenshot + viewport-fraction coordinate workflow, and
`hive-browser interact`. Telegram Web is a heavy SPA with custom rendering, so prefer the
screenshot + coordinate path over selectors when the snapshot is unclear.

### Telegram Web specifics (verified)

- Telegram Web defaults to the **K version** at `https://web.telegram.org/k/`. The
  selectors below are verified there; fall back to screenshot + coordinates if a
  selector doesn't match (e.g. the older `/a/` version).
- **Message composer:** `#editable-message-text`, click it, `type` your text, send
  with the Enter key. Used for `/newbot`, `/start`, etc.
- **Global search:** the search box is top-left (around `[0.13, 0.04]`). Click it,
  type a name, then click the result row to open that chat.
- **Read a bot's reply as text** (don't OCR a screenshot): run `hive-browser page
  text ".chat-message:last-child" --json` in the terminal, it returns the latest message verbatim, this is
  how you capture the token without transposing characters.

## Before you start, check what already exists

The rest: https://github.com/aden-hive/hive/blob/HEAD/core/framework/skills/_default_skills/telegram-notifications-setup/SKILL.md