AI agent bots
for Telegram

Deploy SportMind-powered AI agents on Telegram in minutes. Pre-built prompts, configs, and examples — backed by SportMind's calibrated sports intelligence layer.

Try on Telegram ↗ View on GitHub Quick start

How it works

Telegram Managed Bots — the real flow.

Telegram's Managed Bots feature lets a manager bot create personal AI agents on behalf of users — natively, with a single tap. Each agent gets its own username and chat. Its intelligence is defined by your SportMind prompt.

01

🦞

User opens @LobsterClawBot — a Telegram Managed Bots manager. Taps "Create a New Bot".

02

💬

Telegram shows a native confirmation: "LobsterClawBot would like to create and manage a chatbot on your behalf." Bot name and username are auto-suggested.

03

✓

User taps Create. Child bot is live: "AI Agent #007 is ready. Its behaviour is defined by LobsterClawBot."

04

🧠

User messages the bot. Manager bot routes to your LLM, loaded with a SportMind system prompt from this kit's prompts/ directory.

05

📡

Agent responds with structured SportMind intelligence — pre-match signals, fan token analysis, sentiment, macro events.

Use cases

Five independently forkable bots.

Each use case ships with a complete config and a worked example. Clone only what you need.

Fan Token

Fan Token Trading Bot

Fan token signals, FTP PATH_2 supply event intelligence, CHI/TVS sentiment. Canonical example: $AFC Arsenal.

config/fan-token-trading-bot.yaml examples/fan-token-trading-bot.md

Match Intelligence

Match Intelligence Bot

Pre-match briefings for supporter groups. SMS, AFS, rivalry multipliers, and match conditions for any club.

config/match-intelligence-bot.yaml examples/match-intelligence-bot.md

Calibration

Calibration Bot

Collect prediction records from your community. Feeds directly into SportMind's calibration base. First 10 contributors earn Founding Calibrator status.

config/calibration-bot.yaml examples/calibration-bot.md

Sentiment

Sentiment Monitor

Passive or on-demand CHI and TVS sentiment snapshots for any fan token community. Divergence signals included.

config/sentiment-monitor.yaml

Macro

Macro Event Interpreter

MiCA, SEC/CFTC, Chiliz ecosystem events, and crypto cycle context interpreted through the SportMind macro layer.

config/macro-event-interpreter.yaml

Community

Add yours →

Fork the kit, build a new use case, open a pull request. Reviewed and merged by the Trusted Reviewer community — not the founder.

CONTRIBUTING.md ↗

Prompts

Intelligence built in.

Every prompt is pre-loaded with the SportMind metrics it depends on. Load as the system message in any OpenAI-compatible LLM call.

pre-match-signal.md

Full SMS, AFS, PS, and FTP PATH_2 reasoning chain. Produces structured JSON signal output with direction, confidence, modifiers, and flags.

SMS · FTP PATH_2

sentiment-monitor.md

CHI and TVS band definitions, divergence signals, and four-quadrant interpretation logic for fan token community health.

CHI · TVS

price-movement-explainer.md

Seven-layer cause attribution chain. Checks FTP PATH_2 first, works through every modifier layer before assigning primary and secondary drivers.

All modifiers

macro-event-interpreter.md

MiCA, SEC/CFTC, Chiliz ecosystem, crypto cycle, and US first-mover context. Classifies events by impact direction, magnitude, and timeframe.

Macro layer

pre-match signal output · FTP PATH_2 active ⚽ $AFC · UCL semi-final

{
  "direction":           "HOME",
  "adjusted_score":      71.2,
  "sms":                 82,
  "recommended_action":  "ENTER",
  "composite_modifier":  1.14,

  "flags": {
    "ftp_path2_active":    true,
    "supply_event_type":  "REDUCTION",
    "lineup_unconfirmed":  false
  }
}

Arsenal vs PSG · UCL · Emirates Stadium WIN → supply reduction · standard model sees half the signal

Quick start

Two paths. One kit.

Use @LobsterClawBot and be live in minutes. Or build your own manager bot with full control.

Path A — fastest

@LobsterClawBot

1

Open @LobsterClawBot on Telegram

2

Tap Create a New Bot — Telegram handles bot creation natively

3

Load a prompt from prompts/ as your agent's system message

4

Your SportMind agent is live — zero server setup required

Path B — full control

Self-hosted manager bot

1

Create your manager bot via @BotFather, enable Managed Bots

2

Clone the kit. Open config/bot-api-bootstrap.yaml

3

Add your LLM key and set system_prompt_file to a prompt from prompts/

4

Deploy with python-telegram-bot, grammY, telegraf, or aiogram

SportMind Suite

Part of a larger system.

This kit is one layer of the SportMind open sports intelligence suite. Each component is independently usable and MIT licensed.

Core library

SportMind

617 skill files. 129 calibration records. 42 sports. 96% direction accuracy. The intelligence layer everything else builds on.

sportmind.dev ↗

This repository

Telegram AI Bot Starter Kit

Deploy SportMind-powered AI agents on Telegram via Managed Bots. 4 prompts, 6 configs, 5 use cases, community governance.

GitHub ↗

On-chain

Fan Token Agentic Wallet Starter Kit

Chiliz Chain integration. Fan token on-chain mechanics, FTP PATH_2 supply events, and wallet-layer intelligence primitives.

GitHub ↗

More coming — sportmind.dev

Governance

Community reviewed. Founder not in the chain.

Pull requests are reviewed and merged by Trusted Reviewers — drawn from Founding Calibrators in the core SportMind library. The founder may contribute PRs like any other contributor.

Contributor

Anyone who opens a pull request. No prior approval needed. New use cases, prompt refinements, framework adapters.

Requirement: none

Trusted Reviewer

Review rights on pull requests. Nominated by existing Trusted Reviewers. 2 approvals required for prompts and configs.

Requirement: Founding Calibrator or 2+ merged PRs

Maintainer

Can merge pull requests once review thresholds are met. Governance changes require 3 Maintainer approvals.

Requirement: 90 days + 10 reviews as Trusted Reviewer

Read GOVERNANCE.md →

Free to use.
Free to build on.

MIT licensed. Any LLM. Any Bot API framework.
The kit is ready.

Try on Telegram ↗ View on GitHub → Contribute

AI agent botsfor Telegram