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:
- 从发布页面下载相应的二进制文件。
- 使文件可执行:
chmod +x telbot-linux-amd64 # Replace with your downloaded file name- 将其移动到全局bin目录:
sudo mv telbot-linux-amd64 /usr/local/bin/telbot- 你现在可以跑了
telbot从终端的任何地方。
窗户:
- 下载Windows
.exe可从“发布”页面执行。 - 将下载的文件重命名为
telbot.exe. - 例如,将其移动到永久文件夹
C:\telbot\. - 打开Windows“开始”菜单,搜索 编辑系统环境变量,并打开它。
- 点击 环境变量,查找 路径 在“系统变量”列表中,然后单击 编辑.
- 点击 新,添加
C:\telbot\,然后单击 好的 拯救一切。 - 你现在可以跑了
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\\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交互执行的。
本项目仅供教育和个人使用。使用风险自负。
