名称: telegram-bot-manager 描述: 管理和配置OpenClaw的Telegram机器人。用于设置Telegram集成、排查机器人连接问题、配置机器人令牌或管理Telegram频道/Webhook设置。处理机器人注册、令牌验证以及api.telegram.org的网络连接检查。
Telegram 机器人管理器
快速开始
设置新的Telegram机器人
-
通过BotFather创建机器人
- 在Telegram上联系@BotFather
- 使用
/newbot命令 - 按照提示输入机器人名称和用户名
- 复制机器人令牌（格式：
1234567890:ABCdefGHIjklMNOpqrsTUVwxyz）
-
在OpenClaw中配置
- 将令牌添加到OpenClaw配置
- 启用Telegram插件
- 为私信访问设置配对模式
验证机器人配置
# 测试Telegram API连接
curl -I https://api.telegram.org
# 检查机器人令牌有效性
curl -s "https://api.telegram.org/bot<你的令牌>/getMe"
常见工作流程
排查连接问题
当api.telegram.org无法访问时：
-
检查网络访问
curl -I -m 10 https://api.telegram.org -
验证DNS解析
nslookup api.telegram.org -
测试备用端点
curl -I https://telegram.org
配置OpenClaw Telegram集成
详细配置步骤请参阅OPENCLAW_CONFIG.md。
机器人令牌安全
- 切勿将机器人令牌提交到版本控制
- 将令牌存储在环境变量或安全配置文件中
- 如果令牌泄露，请及时更换
- 不同环境（开发/生产）使用不同的令牌
机器人命令参考
BotFather的常见Telegram机器人命令：
/newbot- 创建新机器人/mybots- 管理你的机器人/setdescription- 设置机器人描述/setabouttext- 设置关于文本/setuserpic- 设置机器人头像/setcommands- 设置机器人命令/token- 生成新令牌/revoke- 撤销当前令牌/setprivacy- 配置隐私模式
Webhook与轮询对比
Webhook（生产环境推荐）
- 机器人通过HTTP POST接收更新
- 需要公开的HTTPS端点
- 对高流量机器人更高效
轮询（适合开发）
- 机器人持续检查更新
- 设置更简单，无需公开端点
- 本地调试更容易
Webhook配置请参阅WEBHOOK_SETUP.md。
错误处理
常见错误及解决方案
“连接超时”
- 检查防火墙规则
- 验证代理配置
- 使用不同网络测试
“无效令牌”
- 验证令牌格式（应包含冒号）
- 检查是否有额外空格或字符
- 如有需要，重新生成令牌
“机器人无响应”
- 确认机器人未被屏蔽
- 检查机器人隐私设置
- 确保机器人拥有适当权限
测试你的机器人
手动测试
- 在Telegram上搜索你的机器人用户名
- 使用
/start开始对话 - 测试基本命令
自动化测试
使用scripts/test_bot.py中的测试脚本进行自动化验证。