如何让 OpenClaw 在 Telegram 上回复你？

在 OpenClaw 支持的所有通讯平台中，Telegram 是最推荐新手首选的平台。原因很简单：它使用官方 Bot API 接入，配置步骤最清晰，稳定性最好，没有任何账号封禁风险，而且三分钟内就能完成全套配置。

本文带你从零开始，完整走一遍 OpenClaw 与 Telegram 的连接流程。

为什么 Telegram 是 OpenClaw 的最佳搭档？

在深入步骤之前，先说清楚 Telegram 的优势——这让你更有信心选择它：

官方 Bot API：Telegram 原生支持 Bot，有完整的官方接口文档，OpenClaw 通过正规渠道接入，不存在任何违反服务条款的风险
零封号风险：与 WhatsApp 不同，Telegram Bot 是官方支持的自动化形式，不会因为”自动化行为”被封
配置最简单：只需要一个 Bot Token，没有 QR 码扫描、没有关联设备操作，粘贴一个字符串就完成
跨设备使用：Telegram 全平台同步，你在手机、电脑、iPad 上都能看到和 OpenClaw 的对话记录
群组支持完善：Bot 在群组中的行为可以精细控制，支持 @提及触发、斜杠命令等

第一步：通过 BotFather 创建 Telegram Bot

Telegram 的所有 Bot 都通过官方机器人 @BotFather 创建和管理。

打开 Telegram，在搜索框输入 @BotFather，点击进入（认准蓝色官方认证标志）
发送 /newbot
BotFather 会要求你给 Bot 取一个显示名称，输入任意名称（如”我的AI助手”），按回车
再输入 Bot 的用户名（必须以 bot 结尾，如 my_openclaw_bot），按回车
创建成功后，BotFather 会发给你一个 Bot Token，格式类似：1234567890:ABCdefGHIjklMNOpqrsTUVwxyz

立即复制并保存这个 Token——这是连接 OpenClaw 的唯一凭证，丢失后需要重新在 BotFather 中生成。

💡 Bot 名称建议：给 Bot 起一个只有你知道的用户名（不要用通用词汇），避免陌生人找到并尝试使用你的 OpenClaw。

第二步：将 Bot Token 配置到 OpenClaw

有两种方式配置 Bot Token，选择其中一种即可。

方式 A：通过 CLI 命令（推荐）

# 添加 Telegram 频道并输入 Bot Token
openclaw channels add --channel telegram --token 你的BotToken

# 设置消息权限策略（推荐 pairing 模式）
openclaw config set channels.telegram.dmPolicy "pairing"

# 重启 Gateway 使配置生效
openclaw gateway restart

方式 B：直接编辑配置文件

在 ~/.openclaw/openclaw.json 中添加：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的BotToken",
      "dmPolicy": "pairing"
    }
  }
}

保存后重启 Gateway：

openclaw gateway restart

方式 C：通过控制面板配置

打开控制面板（http://127.0.0.1:18789），进入”Channels”→”Telegram”，填入 Bot Token，选择 dmPolicy，保存即可。

第三步：发送第一条消息完成配对

配置完成后，在 Telegram 中找到你刚创建的 Bot（搜索你设置的用户名），点击”Start“（开始）按钮，然后发送任意一条消息，如”你好”。

由于默认使用 pairing 模式，Bot 会回复一个 配对码。在服务器终端运行：

openclaw pairing approve telegram 配对码

配对完成后，Bot 会发送确认消息。之后你发送的所有消息都会直接由 OpenClaw 处理并回复，无需再次配对。

💡 提示：如果你在 VPS 上部署，配对码需要通过 SSH 连接到服务器后运行上述命令。配对码有效期约1小时，超时需重新发消息获取新配对码。

第四步：配置消息权限（重要）

OpenClaw 的 Telegram 频道支持精细的权限控制，防止未授权用户使用你的 AI 助手。

完整配置示例

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的BotToken",
      "dmPolicy": "pairing",
      "allowFrom": ["tg:你的用户ID"],
      "groupPolicy": "allowlist",
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

dmPolicy 三种模式

模式	行为	推荐场景
`pairing`（默认推荐）	首次发消息需配对，之后自动授权	个人使用，平衡安全和便捷
`allowlist`	只有 allowFrom 列表中的用户 ID 可以发消息	严格控制访问
`open`	任何人都可以发消息	仅限完全受控的私有环境
`disabled`	关闭私信功能，仅群组可用	仅作为群组 Bot 使用

如何获取你的 Telegram 用户 ID？

在 Telegram 中搜索 @userinfobot，发送任意消息，它会回复你的用户 ID（一串数字）。然后用 tg:用户ID 格式加入 allowFrom 列表。

在群组中使用 OpenClaw

如果你想在 Telegram 群组或频道中使用 OpenClaw，需要额外配置：

第一步：将 Bot 添加到群组

在 Telegram 群组中，点击群组名称→编辑→添加成员，搜索你的 Bot 用户名并添加。

第二步：赋予 Bot 必要权限

在群组设置中，将 Bot 设置为管理员，并开启以下权限：

发送消息
读取消息（Message Content Intent）

第三步：配置群组策略

openclaw config set channels.telegram.groupPolicy "allowlist"
# requireMention: true 表示群组中必须 @Bot 才会触发
openclaw config set channels.telegram.groups.*.requireMention true

requireMention: true 非常重要——开启后，只有在消息中 @你的 Bot 时才会触发 OpenClaw 回复，避免它响应群组中所有消息。

Telegram 斜杠命令：在聊天中直接控制 OpenClaw

OpenClaw 支持通过 Telegram 内的斜杠命令（slash commands）直接控制 Agent 行为，这些命令由 Gateway 拦截处理，不会发送给 AI 模型：

命令	功能
`/status`	查看 OpenClaw 运行状态、连接的通道和当前模型
`/new`	开启新对话（清除当前会话上下文）
`/compact`	压缩当前对话历史（上下文太长时使用，节省 Token）
`/model`	切换当前对话使用的 AI 模型
`/think`	开启扩展思考模式（需要支持 thinking 的模型）
`/reasoning`	显示 AI 的推理过程
`/skills`	列出当前已安装的技能
`/memory`	查看 Agent 当前的记忆摘要

在 Telegram 聊天框中直接输入这些命令发送即可，无需任何额外操作。

设置 Bot 命令菜单（可选但推荐）

你可以给 Bot 设置一个命令菜单，让用户在 Telegram 输入框左边看到可用命令列表，体验更友好。回到 @BotFather：

发送 /setcommands
选择你的 Bot
按以下格式发送命令列表：

status - 查看运行状态
new - 开始新对话
compact - 压缩对话历史
model - 切换AI模型
skills - 查看已安装技能
memory - 查看记忆摘要

设置完成后，用户在聊天框输入 / 就会弹出命令提示。

让 OpenClaw 主动给你发消息

连接 Telegram 后，OpenClaw 不只是等你发消息——配合 Heartbeat 和 Cron，它可以主动给你推送信息：

配置每日早报（示例）

# 每天早上8点向你的 Telegram 发送日报
openclaw cron add \
  --name "morning-brief" \
  --cron "0 8 * * *" \
  --message "用中文总结：今日天气、我的日程安排、未读重要邮件，控制在200字以内"

Heartbeat 的主动推送也会直接发到你的 Telegram，无需你先发消息触发。这就是为什么 Telegram 是”最像真正私人助理”的通讯平台选择。

常见问题排查

Q：发消息后 Bot 没有任何回复怎么办？

# 检查 Telegram 频道连接状态
openclaw channels status --probe

# 查看实时日志，发一条消息后观察是否有接收记录
openclaw logs --follow

如果日志中完全没有消息接收记录，说明 Bot Token 有误或 Gateway 未正确启动。检查 Token 是否完整复制，然后运行 openclaw doctor。

Q：Bot 回复了配对码，但运行配对命令后没有确认消息怎么办？
确认配对命令中的配对码是否完整，注意不要包含尖括号。如果配对码已过期（超过1小时），重新在 Telegram 中发一条消息获取新的配对码。

Q：Gateway 重启后 Telegram 连接断了怎么办？
Telegram Bot 的连接在 Gateway 正常重启后会自动恢复，不需要重新配置。如果重启后确实断连，检查 Bot Token 是否还有效（在 BotFather 中可以查看），运行 openclaw channels status --probe 诊断。

Q：在群组里@Bot 后没有反应怎么办？
确认 Bot 在群组中具有”读取消息”权限，并且 groupPolicy 不是 disabled。Telegram 需要在 Bot 管理员设置中开启 Message Content Intent 才能读取普通消息。

Q：想更换 Bot Token（如旧 Token 泄露）怎么办？
在 BotFather 中通过 /revoke 命令撤销旧 Token 并生成新 Token，然后更新配置：

openclaw config set channels.telegram.botToken "新的BotToken"
openclaw gateway restart

多账号：同时连接多个 Telegram Bot

如果你有多个场景需求（如一个个人 Bot、一个工作 Bot），可以在 OpenClaw 中配置多个 Telegram 账号：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "accounts": {
        "personal": {
          "botToken": "个人BotToken",
          "dmPolicy": "pairing"
        },
        "work": {
          "botToken": "工作BotToken",
          "dmPolicy": "allowlist",
          "allowFrom": ["tg:同事用户ID"]
        }
      }
    }
  }
}

完成！你的 OpenClaw Telegram Bot 已上线

到这里，你已经拥有了一个在 Telegram 上随时待命的 AI 助手。它能：

回答你的任何问题，联网搜索实时信息
帮你管理日程、提醒事项
在你睡觉时主动推送早报、天气、邮件摘要
执行复杂的多步骤自动化任务
记住你的偏好和历史对话，越用越懂你

下一步建议：配置 HEARTBEAT.md 让它定期主动联系你，以及安装更多 Skills 扩展它的能力边界。

更多配置细节，访问 OpenClaw官网中文版（通过浏览器翻译访问 openclaw.ai）或官方 Telegram 频道文档 docs.openclaw.ai/channels/telegram。

本文内容基于 OpenClaw 官方文档及公开社区资料整理，信息截至2026年3月28日。