Telkomsel账户管理工具

一个基于Go的工具,通过Telegram机器人、终端CLI或MCP服务器管理Telkomsel账户,支持OTP登录、余额查询、套餐购买等功能。

  • by 0xtbug
  • Go
  • 本地部署
  • 83 星标
  • 更新于
在 GitHub 查看 0xtbug/telbot

使用说明

Telbot

基于Go的工具,用于通过以下方式管理Telkomsel帐户 电报机器人, 终端CLI,或 MCP服务器 (针对AI代理)。

特性

  • 🔑 使用会话缓存的短信OTP登录
  • 📊 配置文件、余额、配额检查
  • 📦 浏览推荐的套餐
  • 🛍️ 购买套餐(Pulsa/QRIS)
  • ⏰ 自动购买监控(配额耗尽或低于自定义MB阈值时自动购买)
  • 🔄 通过OTP webhook自动重新登录(无需手动干预即可续订会话)
  • 🤖 用于AI代理集成的MCP服务器

快速开始

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

模式

标志 描述
--bot Telegram机器人(需要 .env 配置)
--cli 交互式终端用户界面(Bubbletea)
--mcp 用于AI代理的MCP服务器(stdio)
go run . --bot       # Telegram bot
go run . --cli       # Terminal UI
go run . --mcp       # MCP server

安装(预构建二进制文件)

如果您不想安装Go或自己构建Go,可以直接从以下网址下载适用于Windows、Linux和macOS的预编译可执行文件 发布 此存储库的页面。

全局安装二进制文件以便运行 telbot 从任何文件夹:

Linux/macOS:

  1. 从发布页面下载相应的二进制文件。
  2. 使文件可执行:
    chmod +x telbot-linux-amd64  # Replace with your downloaded file name
    
  3. 将其移动到全局bin目录:
    sudo mv telbot-linux-amd64 /usr/local/bin/telbot
    
  4. 你现在可以跑了 telbot 从终端的任何地方。

窗户:

  1. 下载Windows .exe 可从“发布”页面执行。
  2. 将下载的文件重命名为 telbot.exe.
  3. 例如,将其移动到永久文件夹 C:\telbot\.
  4. 打开Windows“开始”菜单,搜索 编辑系统环境变量,并打开它。
  5. 点击 环境变量,查找 路径 在“系统变量”列表中,然后单击 编辑.
  6. 点击 新,添加 C:\telbot\,然后单击 好的 拯救一切。
  7. 你现在可以跑了 telbot 从任何新的PowerShell或命令提示符窗口。

环境变量

变量 必填 描述
TELKOMSEL_BOT_TOKEN 机器人模式 来自BotFather的Telegram机器人令牌
TELEGRAM_ADMIN_ID 机器人模式 您的Telegram用户ID
OTP_WEBHOOK_PORT 可选 OTP webhook侦听器的端口(例如。 8081)
OTP_WEBHOOK_SECRET 可选 用于webhook身份验证的共享密钥

您可以直接在终端中导出这些,也可以将它们放置在 .env 位于平台标准配置目录中的文件:

  • 窗户: %APPDATA%\telbot\.env (例如。, C:\Users\<User>\AppData\Roaming\telbot\.env)
  • Linux/macOS: ~/.config/telbot/.env

🤖 人工智能代理集成(OpenClaw)

此存储库包括对以下内容的官方支持 开爪,一个开源的AI代理框架。要教你的AI如何使用Telkomsel MCP服务器,只需向它提供原始的URL SKILL.md 此存储库中的文件:

提示您的AI:

Please load and use this telbot Skill:
https://raw.githubusercontent.com/0xtbug/telbot/main/telbot-skills/SKILL.md

文档

请参阅 docs/ 详细指南文件夹:

免责声明

该项目是一个非官方工具,用于与MyTelkomsel web服务交互以实现个人自动化。

它不会修改、绕过或利用MyTelkomsel平台的任何安全机制。所有请求都是使用类似于官方web界面的标准HTTP交互执行的。

本项目仅供教育和个人使用。使用风险自负。