使用说明
🤖 电报MCP代理
将您的AI变成远程工作者。
通过连续的交互式循环直接从Telegram控制Claude或Cursor。
✨ 特性
- 🔄 无限远程环路:AI不只是发送一条消息然后退出。它进入“电报模式”循环,等待您的命令,执行它们,并无限期地报告。
- 🔘 智能交互按钮:每条消息都带有上下文感知按钮(例如,“运行测试”、“修复Bug”),可快速一键回复。
- 🗣️ 多语言支持:说你的语言!如果你用希伯来语写作,它会用希伯来语回复。
- 🎨 丰富的格式:发送带有粗体文本、代码块和列表的漂亮Markdown消息。
- 🔌 通用载体:针对以下方面进行了优化 克劳德桌面版, 克劳德代码,以及 光标.
🚀 快速开始
1.先决条件:设置Telegram📱
安装之前,您需要设置Telegram环境:
- 创建Bot:
- 打开 @植物学家 在Telegram中。
- 发送
/newbot并按照说明获取您的 机器人令牌.
- 创建超级组:
- 创建一个新组。
- 启用主题:前往群组设置>聊天记录>启用“主题”(或“论坛”)。 这很关键!
- 将Bot添加为管理员:
- 将您的新机器人添加到组中。
- 推广它 管理员 具有完全权限(特别是“管理主题”)。
- 初始化:
- 在组的“General”主题中发送一条虚拟消息(例如“Init”)。
- 这确保了组ID是可访问的。
- 获取组ID:
- 将群中的消息转发到 @原始数据点 (或使用其他方法)找到 聊天ID (通常以
-100).
- 将群中的消息转发到 @原始数据点 (或使用其他方法)找到 聊天ID (通常以
2.安装
我们提供了一个自动安装程序,可以为您设置所有内容。
python install.py
此脚本将:
- 安装Python依赖项。
- 问你的 Telegram Bot令牌 和 组ID.
- 配置 克劳德桌面版 和 克劳德代码 自动。
- 输出所需的配置 光标.
2.激活“电报模式”
要启动远程工作循环,只需告诉您的AI代理:
“我要走了。切换到Telegram。” 或者用希伯来语: “我要去喝咖啡,继续电报。
AI将:
- 在您的Telegram群中打开一个新主题。
- 给您发送一条消息: “我准备好了。我该怎么办?”
- 等待 等待您的回复(阻止执行)。
3.停止会话
要退出循环,只需单击 “暂时完成” (或 “我们已经结束了”)Telegram中的按钮。
📂 配置文件
CLAUDE.md:Claude Code执行循环和格式化的严格规则。.cursorrules:游标和其他代理的自动检测规则。TELEGRAM_MODE.md:如果需要,您可以手动粘贴系统提示。
🛠️ 手动配置(光标)
配置 光标:
- 打开设置(
Ctrl+,或Cmd+,). - 导航至 特性 > 主控程序.
- 添加具有以下详细信息的新MCP服务器:
{
"name": "telegram-agent",
"type": "stdio",
"command": "python",
"args": ["/absolute/path/to/telegram-mcp/server.py"]
}
(注意:使用python可执行文件和server.py文件的完整绝对路径)
内置于❤️ MCP社区。