OpenClaw连接Telegram机器人教程

Telegram是全球最流行的即时通讯工具之一，拥有强大的Bot API生态。通过OpenClaw提供的开源自托管AI助手，你可以轻松创建一个属于自己的Telegram AI机器人，随时随地与Claude、GPT等大语言模型对话。本教程将详细讲解从零开始配置OpenClaw与Telegram的完整流程。

前置条件

在开始之前，请确保你已经完成以下准备工作：

已安装Node.js 22或更高版本
已安装并完成OpenClaw初始化（openclaw onboard）
拥有一个Telegram账号
OpenClaw网关已正常运行（默认端口18789）

如果你还没有安装OpenClaw，可以通过以下命令快速安装：

npm install -g openclaw@latest
openclaw onboard

安装过程中会引导你完成基础配置，包括选择AI模型提供商和设置API密钥。

第一步：通过BotFather创建Telegram机器人

Telegram的所有机器人都通过官方的@BotFather来创建和管理。打开Telegram，搜索 @BotFather 并发起对话，然后按照以下步骤操作：

发送 /newbot 命令
BotFather会要求你为机器人起一个显示名称，例如 我的AI助手
接着需要设置一个用户名，必须以 bot 结尾，例如 my_ai_assistant_bot
创建成功后，BotFather会返回一个Bot Token，格式类似 7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

重要提示： 请妥善保管这个Token，不要泄露给任何人。拥有Token意味着可以完全控制你的机器人。

你还可以通过BotFather进一步自定义机器人：

/setdescription - 设置机器人描述
/setabouttext - 设置"关于"信息
/setuserpic - 设置头像

第二步：在OpenClaw中配置Telegram频道

获得Bot Token后，需要将其添加到OpenClaw的配置文件中。打开配置文件：

nano ~/.config/openclaw/openclaw.json5

在配置文件的 channels 部分添加Telegram频道配置：

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      // 可选：设置允许使用机器人的用户ID列表
      allowedUsers: [],
      // 可选：设置机器人在群组中的触发方式
      groupBehavior: "mention", // "mention" 需要@提及, "always" 始终响应
    }
  }
}

保存文件后，重启OpenClaw网关使配置生效：

openclaw gateway restart

第三步：验证连接状态

配置完成后，使用内置的诊断工具检查连接是否正常：

openclaw doctor

该命令会检查所有已配置频道的连接状态。如果Telegram频道显示为绿色或"connected"，说明配置成功。你也可以通过Dashboard查看更详细的状态信息：

openclaw dashboard

此时打开Telegram，找到你刚才创建的机器人，发送一条消息测试一下。如果一切正常，机器人应该会回复你。

第四步：将机器人添加到群组

OpenClaw的Telegram机器人不仅支持私聊，还可以添加到群组中为多人服务。操作步骤如下：

打开目标Telegram群组的设置
点击"添加成员"，搜索你的机器人用户名
将机器人添加到群组中

默认情况下，机器人在群组中使用 mention 模式，即只有当消息中@提及机器人时才会响应。这样可以避免机器人对每条消息都做出回复，影响正常聊天。

如果你希望机器人响应群组中的所有消息，可以将 groupBehavior 改为 "always"，但这通常只适用于专门的AI讨论群。

第五步：配置隐私模式

Telegram机器人默认开启了隐私模式（Privacy Mode），这意味着在群组中机器人只能看到以下类型的消息：

以 / 开头的命令
直接@提及机器人的消息
对机器人消息的回复

如果你需要机器人能够看到群组中的所有消息（例如用于上下文理解），需要在BotFather中关闭隐私模式：

向 @BotFather 发送 /mybots
选择你的机器人
进入 Bot Settings → Group Privacy
选择 Turn off

注意：关闭隐私模式后，机器人需要被移除并重新添加到群组中才能生效。

安全建议

在部署Telegram机器人时，安全性不容忽视：

限制用户访问： 在 allowedUsers 中填入允许使用的Telegram用户ID，防止陌生人滥用你的AI额度
保护网关端口： 永远不要将18789端口直接暴露到公网，务必使用Nginx等反向代理
定期更换Token： 如果你怀疑Token泄露，立即通过BotFather的 /revoke 命令重新生成

获取自己的Telegram用户ID可以通过向 @userinfobot 发送任意消息来查询。

总结

通过本教程，你已经成功将OpenClaw与Telegram连接起来，拥有了一个私有的AI聊天机器人。你可以在私聊中快速提问，也可以将它添加到工作群组中辅助团队协作。更多高级配置和使用技巧，请参考OpenClaw官方文档。如果在配置过程中遇到问题，欢迎访问OpenClaw GitHub仓库查看Issue或提交反馈。