基于Go的工具，通过Telegram Bot、Terminal CLI或MCP Server（针对AI代理）管理Telkomsel账户。

特色

• 🔑 带会话缓存的短信一次性登录
• 📊 档案、平衡、配额核查
• 📦 浏览推荐套餐
• 🛍️ 购买套餐（Pulsa / QRIS）
• ⏰ 自动购买监控（当配额用尽或低于自定义MB阈值时自动购买）
• 🔄 通过OTP网页钩自动重新登录（会话续订无需人工干预）
• 🤖 用于AI代理集成的MCP服务器

快速启动

模式

安装（预制双板）

如果你不想安装或自己构建 Go，可以直接从本仓库的 Releases 页面下载预编译的 Windows、Linux 和 macOS 可执行文件。

要全局安装二进制文件，以便你可以从任意文件夹运行telbot：

Linux / macOS：

1. 从发布页面下载相应的二进制文件。

2. 使文件可执行：

3. 将其移到你的全局bin目录：

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

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:

1. Download the appropriate binary from the Releases page.
2. Make the file executable:

   chmod +x telbot-linux-amd64  # Replace with your downloaded file name
   

3. Move it to your global bin directory:

   sudo mv telbot-linux-amd64 /usr/local/bin/telbot
   

4. You can now run telbot from anywhere in your terminal.

Windows:

1. Download the Windows .exe executable from the Releases page.
2. Rename the downloaded file to telbot.exe.
3. Move it to a permanent folder, for example C:\telbot\.
4. Open the Windows Start menu, search for Edit the system environment variables, and open it.
5. Click Environment Variables, find Path in the System variables list, and click Edit.
6. Click New, add C:\telbot\, and click OK to save everything.
7. You can now run telbot from any new PowerShell or Command Prompt window.

Environment Variables

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\\AppData\Roaming\telbot\.env)
• Linux/macOS: ~/.config/telbot/.env

🤖 AI Agent Integration (OpenClaw)