Skip to content
Back to search

telbot

Go-based tool for managing Telkomsel accounts via Telegram Bot, Terminal CLI, or MCP Server (for AI agents).

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/0xtbug--telbot/badge.svg)](/listings/0xtbug--telbot)

HTML

<a href="/listings/0xtbug--telbot"><img src="/api/listings/0xtbug--telbot/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

git clone https://github.com/0xtbug/telbot
cd telbot
cp .env.example .env   # fill in your tokens
go mod tidy

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 107 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Telbot
  2. Go-based tool for managing Telkomsel accounts via **Telegram Bot**, **Terminal CLI**, or **MCP Server** (for AI agents).
  3. ## Features
  4. - 🔑 SMS OTP login with session caching
  5. - 📊 Profile, balance, quota checking
  6. - 📦 Browse recommended packages
  7. - 🛍️ Purchase packages (Pulsa / QRIS)
  8. - ⏰ Auto-buy monitor (auto-purchase when quota is depleted or below a custom MB threshold)
  9. - 🔄 Auto re-login via OTP webhook (session renewal without manual intervention)
  10. - 🤖 MCP server for AI agent integration
  11. ## Quick Start
  12. ```bash
  13. git clone https://github.com/0xtbug/telbot
  14. cd telbot
  15. cp .env.example .env # fill in your tokens
  16. go mod tidy
  17. ```
  18. ## Modes
  19. | Flag | Description |
  20. |------|-------------|
  21. | `--bot` | Telegram bot (requires `.env` config) |
  22. | `--cli` | Interactive terminal UI (Bubbletea) |
  23. | `--mcp` | MCP server for AI agents (stdio) |
  24. ```bash
  25. go run . --bot # Telegram bot
  26. go run . --cli # Terminal UI
  27. go run . --mcp # MCP server
  28. ```
  29. ## Installation (Pre-built Binaries)
  30. 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](https://github.com/0xtbug/telbot/releases)** page of this repository.
  31. To install the binary globally so you can run `telbot` from any folder:
  32. **Linux / macOS:**
  33. 1. Download the appropriate binary from the Releases page.
  34. 2. Make the file executable:
  35. ```bash
  36. chmod +x telbot-linux-amd64 # Replace with your downloaded file name
  37. ```
  38. 3. Move it to your global bin directory:
  39. ```bash
  40. sudo mv telbot-linux-amd64 /usr/local/bin/telbot
  41. ```
  42. 4. You can now run `telbot` from anywhere in your terminal.
  43. **Windows:**
  44. 1. Download the Windows `.exe` executable from the Releases page.
  45. 2. Rename the downloaded file to `telbot.exe`.
  46. 3. Move it to a permanent folder, for example `C:\telbot\`.
  47. 4. Open the Windows Start menu, search for **Edit the system environment variables**, and open it.
  48. 5. Click **Environment Variables**, find **Path** in the System variables list, and click **Edit**.
  49. 6. Click **New**, add `C:\telbot\`, and click **OK** to save everything.
  50. 7. You can now run `telbot` from any new PowerShell or Command Prompt window.
  51. ## Environment Variables
  52. | Variable | Required | Description |
  53. |----------|----------|-------------|
  54. | `TELKOMSEL_BOT_TOKEN` | Bot mode | Telegram bot token from BotFather |
  55. | `TELEGRAM_ADMIN_ID` | Bot mode | Your Telegram user ID |
  56. | `OTP_WEBHOOK_PORT` | Optional | Port for OTP webhook listener (e.g. `8081`) |
  57. | `OTP_WEBHOOK_SECRET` | Optional | Shared secret for webhook authentication |
  58. You can either export these directly in your terminal, or place them in a `.env` file located in your platform's standard configuration directory:
  59. - **Windows:** `%APPDATA%\telbot\.env` (e.g., `C:\Users\<User>\AppData\Roaming\telbot\.env`)
  60. - **Linux/macOS:** `~/.config/telbot/.env`
  61. ## 🤖 AI Agent Integration (OpenClaw)
  62. This repository includes official support for [OpenClaw](https://github.com/0xtbug/telbot), 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:
  63. **Prompt your AI with:**
  64. ```text
  65. Please load and use this telbot Skill:
  66. https://raw.githubusercontent.com/0xtbug/telbot/main/telbot-skills/SKILL.md
  67. ```
  68. ## Documentation
  69. See the [docs/](docs/) folder for detailed guides:
  70. - [Telegram Bot](docs/telegram-bot.md)
  71. - [CLI Mode](docs/cli.md)
  72. - [MCP Server](docs/mcp-server.md)
  73. - [Auto Re-login (OTP Webhook)](docs/auto-relogin.md)
  74. - [Systemd Service (Linux)](docs/systemd.md)
  75. - [OpenWrt](docs/openwrt.md)
  76. - [OpenClaw Skill](telbot-skills/SKILL.md)
  77. ## Disclaimer
  78. This project is an unofficial tool that interacts with MyTelkomsel web services for personal automation purposes.
  79. 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.
  80. This project is intended for educational and personal use only. Use at your own risk.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.