学习目标

学会把 OpenClaw 连接到 Telegram，让小龙虾从”只能用电脑浏览器聊天”变成”随时随地手机上就能对话”。

概念解释

到目前为止，你跟小龙虾聊天都是在电脑上的浏览器或者终端里进行的。这就像小龙虾只有一部”座机”——你得坐在电脑前才能跟它说话。

但是！如果我们给小龙虾配一部”手机”呢？连接 Telegram 就相当于给小龙虾发了一部手机。从此以后，不管你是在地铁上、沙发上、还是排队买奶茶，掏出手机打开 Telegram 就能跟小龙虾对话。

Telegram 是一个很流行的聊天工具（类似微信），它允许你创建”机器人”（Bot）。我们做的事就是把小龙虾”装进”这个机器人里，让它通过 Telegram 跟你聊天。

为什么选 Telegram？ 因为 Telegram 的 Bot 接口非常开放和简单，是 OpenClaw 官方支持的第一批渠道之一。如果你更习惯用其他聊天工具，OpenClaw 也支持 Discord、Slack 等渠道，原理都一样。

动手做

第一步：在 Telegram 创建 Bot

Bot 就是”机器人账号”。我们需要在 Telegram 里创建一个 Bot，拿到它的”身份证号”（Token），后面才能让小龙虾住进去。

1. 打开 Telegram（手机或电脑版都行），在搜索框里搜索 @BotFather
2. 点击进入 BotFather 的对话，点”启动”或发送 /start
3. 发送 /newbot——这是告诉 BotFather”我要创建一个新机器人”
4. BotFather 会问你给 Bot 起个名字，比如输入：我的AI助手（这个是显示名，可以随便起）
5. 然后它会让你再起一个用户名，必须以 bot 结尾，比如输入：my_ai_helper_bot（这个是唯一的，不能跟别人重复）
6. 创建成功后，BotFather 会回复一段话，里面有一串 token，格式长这样：

123456789:ABCdefGHIjklMNOpqrsTUVwxyz

7. 复制保存这个 token！ 这就是 Bot 的”身份证号”，下一步要用到

什么是 token？ 你可以把它理解成 Bot 的密码。有了这个密码，OpenClaw 才能以这个 Bot 的身份收发消息。所以千万保管好，不要发给别人。

第二步：配置 OpenClaw

拿到了 Bot 的 token 之后，我们要告诉 OpenClaw：“嘿，我已经准备好了 Telegram 机器人，请连上它。“有三种方式，选一种就行。

方式一：用配置向导（推荐新手）

在终端里运行：

openclaw configure --section channels

这个命令会启动一个向导（就是一问一答的引导程序）。向导会问你：

1. 选择渠道类型——选 Telegram
2. 粘贴 Bot Token——把上一步复制的那串 token 粘贴进去

跟着向导走就行，它会帮你搞定一切。

方式二：用 config set 命令

如果你更喜欢一条命令搞定，直接运行：

openclaw config set channels.telegram.botToken "你的Bot Token"

把 "你的Bot Token" 替换成你自己的 token，比如：

openclaw config set channels.telegram.botToken "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"

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

如果你喜欢手动操作文件，也可以用记事本打开配置文件 ~/.openclaw/openclaw.json，手动添加以下内容：

{
  channels: {
    telegram: {
      botToken: "你的Bot Token",
      dmPolicy: "open",
      allowFrom: ["*"]
    }
  }
}

如果文件里已经有其他配置，只需要把 channels 部分加进去就行，不要把原来的内容覆盖掉。

dmPolicy 是什么？ 这是”私聊策略”（DM Policy），控制谁可以跟你的 Bot 聊天。设为 "open" 表示允许所有人对话，方便测试。后面我们会讲怎么限制。

第三步：验证连接

配置保存之后，OpenClaw 的 Gateway（网关，负责消息转发的组件）会自动热重载——不需要你手动重启任何东西。

现在来验证一下：

1. 打开 Telegram，找到你刚才创建的 Bot
2. 给它发送：你好
3. 等几秒钟……

如果小龙虾正常回复了，恭喜你——连接成功！你已经在手机上跟 AI 对话了。

第四步：了解 DM 策略（谁可以跟你的 Bot 聊天）

刚才我们把 dmPolicy 设成了 "open"，意味着任何人都能跟你的 Bot 聊天。但在实际使用中，你可能想控制一下访问权限。OpenClaw 提供了四种策略：

安全提醒： 建议测试完连接后，把 dmPolicy 从 "open" 改回更安全的 "pairing" 或 "allowlist"，避免陌生人消耗你的 API 额度。

策略	说明	适合场景
pairing（默认）	新用户需要输入配对码验证	日常使用，只让信任的人用
allowlist	只有白名单里的用户可以聊	只给自己或指定的人用
open	所有人都能聊	测试阶段
disabled	关闭私聊	不想让任何人通过私聊找 Bot

如何获取你的 Telegram 用户 ID

如果你想用 allowlist 策略只允许自己使用，需要知道你自己的 Telegram 用户 ID（一串数字）。方法很简单：

1. 先给你的 Bot 发一条消息（随便说什么都行）
2. 然后在终端运行：

openclaw logs --follow

3. 在输出的日志中找到 from.id 字段，那个数字就是你的 Telegram 用户 ID

拿到 ID 之后，把配置改成：

{
  channels: {
    telegram: {
      botToken: "你的Bot Token",
      dmPolicy: "allowlist",
      allowFrom: ["你的Telegram用户ID"]
    }
  }
}

这样除了你之外，别人即使找到了你的 Bot 也无法跟它对话。

检查你的成果

完成以上步骤后，检查一下：

• Bot 创建成功，从 BotFather 那里拿到了 token
• 用三种方式之一把 token 配置到了 OpenClaw
• 在 Telegram 里给 Bot 发消息，能收到 AI 的回复
• 了解 DM 策略，知道如何控制谁能跟 Bot 聊天

常见失败排查

1. Bot 不回复消息

排查步骤：

• 检查 token 是否粘贴正确（没有多余空格、没有漏字符）
• 检查 Gateway 是否在运行：openclaw gateway status
• 如果 Gateway 没在运行，用 openclaw gateway start 启动它

2. 回复很慢

原因： 可能是你选择的 AI 模型响应速度较慢，尤其是大模型处理复杂问题时。

解决： 试试在配置中换一个更轻量的模型（比如把 GPT-4 换成 GPT-4o-mini），响应速度会快很多。

3. 别人也能跟我的 Bot 聊天

原因： dmPolicy 设为了 "open"，任何人都可以对话。

解决： 把 dmPolicy 从 "open" 改为 "pairing" 或 "allowlist"。改完后让朋友给 Bot 发条消息试试，应该会被拒绝。

4. 配置文件改了但没生效

原因： Gateway 可能没有成功热重载，或者配置文件的 JSON 格式写错了。

解决： 检查 JSON 格式是否正确（可以用在线 JSON 校验工具），确认没有遗漏逗号或括号。如果还是不行，手动重启 Gateway：openclaw gateway restart。

挑战任务

试着把 dmPolicy 设置为 "allowlist"，只允许你自己的 Telegram 账号跟 Bot 对话。步骤提示：

1. 先用 openclaw logs --follow 获取你的 Telegram 用户 ID
2. 修改配置，把 dmPolicy 改为 "allowlist"，在 allowFrom 里填入你的 ID
3. 让朋友（或者用另一个账号）给 Bot 发消息，验证是否能被拦截

这样你就拥有了一个”私人专属 AI 助手”，只有你自己能跟它聊天。