Telbot
Go-based tool for managing Telkomsel accounts via Telegram Bot, Terminal CLI, or MCP Server (for AI agents).
Ask AI about Telbot
Powered by Claude Β· Grounded in docs
I know everything about Telbot. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Telbot
Go-based tool for managing Telkomsel accounts via Telegram Bot, Terminal CLI, or MCP Server (for AI agents).
Features
- π SMS OTP login with session caching
- π Profile, balance, quota checking
- π¦ Browse recommended packages
- ποΈ Purchase packages (Pulsa / QRIS)
- β° Auto-buy monitor (auto-purchase when quota is depleted or below a custom MB threshold)
- π Auto re-login via OTP webhook (session renewal without manual intervention)
- π€ MCP server for AI agent integration
Quick Start
git clone https://github.com/0xtbug/telbot
cd telbot
cp .env.example .env # fill in your tokens
go mod tidy
Modes
| Flag | Description |
|---|---|
--bot | Telegram bot (requires .env config) |
--cli | Interactive terminal UI (Bubbletea) |
--mcp | MCP server for AI agents (stdio) |
go run . --bot # Telegram bot
go run . --cli # Terminal UI
go run . --mcp # MCP server
Installation (Pre-built Binaries)
If you don't want to install Go or build it yourself, you can download the pre-compiled executables for Windows, Linux, and macOS directly from the Releases page of this repository.
To install the binary globally so you can run telbot from any folder:
Linux / macOS:
- Download the appropriate binary from the Releases page.
- Make the file executable:
chmod +x telbot-linux-amd64 # Replace with your downloaded file name - Move it to your global bin directory:
sudo mv telbot-linux-amd64 /usr/local/bin/telbot - You can now run
telbotfrom anywhere in your terminal.
Windows:
- Download the Windows
.exeexecutable from the Releases page. - Rename the downloaded file to
telbot.exe. - Move it to a permanent folder, for example
C:\telbot\. - Open the Windows Start menu, search for Edit the system environment variables, and open it.
- Click Environment Variables, find Path in the System variables list, and click Edit.
- Click New, add
C:\telbot\, and click OK to save everything. - You can now run
telbotfrom any new PowerShell or Command Prompt window.
Environment Variables
| Variable | Required | Description |
|---|---|---|
TELKOMSEL_BOT_TOKEN | Bot mode | Telegram bot token from BotFather |
TELEGRAM_ADMIN_ID | Bot mode | Your Telegram user ID |
OTP_WEBHOOK_PORT | Optional | Port for OTP webhook listener (e.g. 8081) |
OTP_WEBHOOK_SECRET | Optional | Shared secret for webhook authentication |
You can either export these directly in your terminal, or place them in a .env file located in your platform's standard configuration directory:
- Windows:
%APPDATA%\telbot\.env(e.g.,C:\Users\<User>\AppData\Roaming\telbot\.env) - Linux/macOS:
~/.config/telbot/.env
π€ AI Agent Integration (OpenClaw)
This repository includes official support for OpenClaw, an open-source AI agent framework. To teach your AI exactly how to use the Telkomsel MCP Server, simply provide it with the URL to the raw SKILL.md file in this repository:
Prompt your AI with:
Please load and use this telbot Skill:
https://raw.githubusercontent.com/0xtbug/telbot/main/telbot-skills/SKILL.md
Documentation
See the docs/ folder for detailed guides:
- Telegram Bot
- CLI Mode
- MCP Server
- Auto Re-login (OTP Webhook)
- Systemd Service (Linux)
- OpenWrt
- OpenClaw Skill
Disclaimer
This project is an unofficial tool that interacts with MyTelkomsel web services for personal automation purposes.
It does not modify, bypass, or exploit any security mechanisms of the MyTelkomsel platform. All requests are performed using standard HTTP interactions similar to those made by the official web interface.
This project is intended for educational and personal use only. Use at your own risk.
