- 打开 Telegram,搜索 @BotFather(官方机器人管理账号)。
- 发送
/newbot,按提示设置:- 输入机器人名称(显示名称)。
- 输入机器人唯一用户名(以
bot如myopenclaw_bot)。
- 创建成功后,保存生成的 Token(格式如
123456:ABCdefGhIJKlmNoPQRsTUVwxyZ)。
步骤 2:配置 OpenClaw 环境
-
编辑配置文件
进入 OpenClaw 安装目录,找到配置文件(如config.yaml或.env),添加 Telegram 相关参数:
telegram: token: "你的TELEGRAM_BOT_TOKEN" admin_ids: [123456789] # 管理员用户ID(可选) proxy: "" # 如需代理可配置("socks5://127.0.0.1:1080")
提示:可通过向 Telegram 的
@userinfobot发送消息获取自己的用户ID。 -
设置 Webhook(如需)
如果使用 Webhook 模式(非长轮询),需配置公网可访问的 HTTPS 地址:curl -X POST "https://api.telegram.org/bot<TELEGRAM_BOT_TOKEN>/setWebhook?url=<你的HTTPS回调地址>"
步骤 3:启动 OpenClaw 服务
-
启动服务
根据部署方式执行命令(示例):# 使用 Docker docker-compose up -d # 或直接运行(根据项目文档) python main.py --platform telegram
-
检查日志
确认服务正常运行,无报错:docker logs openclaw # 或查看应用日志
步骤 4:测试机器人
- 在 Telegram 中搜索你的机器人(通过
@用户名)。 - 发送
/start或/help,检查是否正常响应。 - 测试核心功能(如对话、工具调用等)。
常见问题
-
收不到消息回复
- 检查 Token 是否正确,确保网络可访问 Telegram API。
- 如在国内环境,需配置代理(在
proxy字段设置 SOCKS5/HTTP 代理)。
-
Webhook 证书问题
需使用 HTTPS 地址(可通过 Nginx 反代或云服务商获取证书)。
-
权限限制
- 如机器人无法在群组中使用,需在 @BotFather 中关闭 Group Privacy 模式。
-
多平台支持
OpenClaw 可同时连接多个平台(如 Discord、Slack),确保配置文件中各平台参数独立。
安全建议
- 勿将 Token 提交至公开仓库。
- 限制
admin_ids为可信用户。 - 定期更新 OpenClaw 版本以获取安全修复。
通过以上步骤,你的 OpenClaw 机器人即可在 Telegram 上正常运行,如遇复杂问题,可查阅项目文档或提交 Issue 到官方仓库。