步骤 1,创建 Telegram 机器人

openclaw openclaw中文博客 2
  1. 打开 Telegram,搜索 @BotFather(官方机器人管理账号)。
  2. 发送 /newbot,按提示设置:
    • 输入机器人名称(显示名称)。
    • 输入机器人唯一用户名(以 botmyopenclaw_bot)。
  3. 创建成功后,保存生成的 Token(格式如 123456:ABCdefGhIJKlmNoPQRsTUVwxyZ)。

步骤 2:配置 OpenClaw 环境

  1. 编辑配置文件
    进入 OpenClaw 安装目录,找到配置文件(如 config.yaml.env),添加 Telegram 相关参数:

    步骤 1,创建 Telegram 机器人-第1张图片-OpenClaw 中文版 - 真正能做事的 AI

    telegram:
      token: "你的TELEGRAM_BOT_TOKEN"
      admin_ids: [123456789]  # 管理员用户ID(可选)
      proxy: ""  # 如需代理可配置("socks5://127.0.0.1:1080")

    提示:可通过向 Telegram 的 @userinfobot 发送消息获取自己的用户ID。

  2. 设置 Webhook(如需)
    如果使用 Webhook 模式(非长轮询),需配置公网可访问的 HTTPS 地址:

    curl -X POST "https://api.telegram.org/bot<TELEGRAM_BOT_TOKEN>/setWebhook?url=<你的HTTPS回调地址>"

步骤 3:启动 OpenClaw 服务

  1. 启动服务
    根据部署方式执行命令(示例):

    # 使用 Docker
    docker-compose up -d
    # 或直接运行(根据项目文档)
    python main.py --platform telegram
  2. 检查日志
    确认服务正常运行,无报错:

    docker logs openclaw  # 或查看应用日志

步骤 4:测试机器人

  1. 在 Telegram 中搜索你的机器人(通过 @用户名)。
  2. 发送 /start/help,检查是否正常响应。
  3. 测试核心功能(如对话、工具调用等)。

常见问题

  1. 收不到消息回复

    • 检查 Token 是否正确,确保网络可访问 Telegram API。
    • 如在国内环境,需配置代理(在 proxy 字段设置 SOCKS5/HTTP 代理)。
  2. Webhook 证书问题

    需使用 HTTPS 地址(可通过 Nginx 反代或云服务商获取证书)。

  3. 权限限制

    • 如机器人无法在群组中使用,需在 @BotFather 中关闭 Group Privacy 模式。
  4. 多平台支持

    OpenClaw 可同时连接多个平台(如 Discord、Slack),确保配置文件中各平台参数独立。


安全建议

  • 勿将 Token 提交至公开仓库。
  • 限制 admin_ids 为可信用户。
  • 定期更新 OpenClaw 版本以获取安全修复。

通过以上步骤,你的 OpenClaw 机器人即可在 Telegram 上正常运行,如遇复杂问题,可查阅项目文档或提交 Issue 到官方仓库。

抱歉,评论功能暂时关闭!