sapphire-telegram

Telegram bot framework — handlers, commands, notification routing, agent dispatch

仓库: arigatoexpress/Sapphire
最近来源活动: 2026年7月29日 15:50
检测到的 SKILL.md 语言: 英语
星标: 1
分支: 0

安装方式

默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。

检查来源文件

决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。

返回搜索返回安装

name	sapphire-telegram
description	Telegram bot framework — handlers, commands, notification routing, agent dispatch
type	library
runtime	python
deploy_target	rari1
dependencies	["sapphire-core"]
entry_point	src/sapphire_telegram/bot.py
test_command	pytest tests/

sapphire.telegram

Shared Telegram bot framework used by control-plane and lighter services. Handles bot lifecycle, command routing, and outbound notifications.

Key Modules

bot.py — Bot init, webhook/polling mode switch, startup validator
handlers.py — Command handlers: /status, /pnl, /deploy, /task, /alert

Usage

from sapphire_telegram.bot import SapphireBot

bot = SapphireBot(token=os.getenv("TELEGRAM_BOT_TOKEN"))
bot.run_polling()

Notification Routing

Outbound notifications are tagged before send:

priority:p0 → immediate push, bypass quiet hours
type:trading → trading channel
agent:kimi → Kimi status channel

Deploy Notes

Runs on rari1 as part of control-plane service
Bot token in Secret Manager: sapphire-telegram-bot-token
Webhook URL (Cloud Run): https://pm.sapphirealpha.xyz/telegram/webhook