第5课 连接聊天工具#

为什么要学这一课?#

之前我们通过网页界面或终端与 AI 交流。但 OpenClaw 真正的魔力在于——你可以直接在 Telegram 或 WhatsApp 中给助手发消息,就像给普通联系人发消息一样。在这一课中我们会进行设置。


选项 A:连接 Telegram#

Telegram 是将聊天工具连接到 OpenClaw 的最简单方式。你将在 Telegram 中创建一个机器人,通过它与 AI 交流。

Telegram 中的机器人是一个由程序控制的特殊账户,不是真人。你给机器人发消息——OpenClaw 接收消息,传给 AI 并把回复发回来。

第1步 在 Telegram 中创建机器人#

  1. 在手机或电脑上打开 Telegram
  2. 搜索 @BotFather(这是 Telegram 官方的机器人创建工具)
  3. 确认是带蓝色认证标记的 @BotFather
  4. 给它发送:/newbot
  5. BotFather 会问机器人名称——输入任意名称(例如"我的AI助手")
  6. 然后会问 username——这是一个唯一名称,必须以 bot 结尾(例如 my_ai_helper_bot
  7. BotFather 会发给你一个令牌——一串长字符串,类似 123456789:ABCDefGhIJKlMNoPQRstuVWxyz

⚠️ 令牌就像机器人的密码。不要给任何人看!

第2步 在 OpenClaw 设置中添加令牌#

如果你使用了设置向导(openclaw onboard),它可能已经询问过 Telegram 的设置。如果没有——我们手动添加。

打开 OpenClaw 的配置文件。它通常位于:

~/.openclaw/openclaw.json

符号 ~ 表示你的用户主目录。在 macOS 上是 /Users/你的用户名/,在 Linux 上是 /home/你的用户名/

找到或添加 channels 部分:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你从BOTFATHER获得的令牌",
      "dmPolicy": "pairing"
    }
  }
}

dmPolicy: "pairing" 是安全策略。它意味着机器人不会回复任何人:每个新用户必须由你批准。

第3步 重启 Gateway#

openclaw gateway restart

第4步 给机器人发消息并批准自己#

  1. 打开 Telegram,通过 username 搜索你的机器人(例如 @my_ai_helper_bot
  2. 发送"你好"
  3. 机器人暂时不会回复——首先需要批准你的账户

在终端中执行:

openclaw pairing list telegram

你会看到请求代码。批准它:

openclaw pairing approve telegram 代码

现在再给机器人发消息——它会回复了! 🎉


选项 B:连接 WhatsApp#

WhatsApp 的连接方式不同:OpenClaw 使用 WhatsApp Web(就像你在电脑上打开 WhatsApp 一样)。

第1步 配置设置#

~/.openclaw/openclaw.json 文件中添加:

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "pairing",
      "allowFrom": ["+8613800138000"]
    }
  }
}

allowFrom 中填入你的国际格式手机号码。

第2步 绑定 WhatsApp#

openclaw channels login --channel whatsapp

屏幕上会出现一个 QR 码。在 WhatsApp 中扫描它:

  1. 在手机上打开 WhatsApp
  2. 进入设置关联设备关联新设备
  3. 将摄像头对准终端中的 QR 码

第3步 启动并检查#

openclaw gateway restart

现在向你的 WhatsApp 号码发送消息(从另一个号码或通过联系人)——AI 会回复!


还支持哪些聊天工具?#

OpenClaw 支持众多通道:

聊天工具 状态
Telegram ✅ 可以使用
WhatsApp ✅ 可以使用
Discord ✅ 可以使用
Slack ✅ 可以使用
Signal ✅ 可以使用
Google Chat ✅ 可以使用
iMessage ✅ 可以使用(仅限 macOS)
Microsoft Teams ✅ 可以使用
Matrix ✅ 可以使用

本课总结#

  • 你可以通过 TelegramWhatsApp 与 AI 交流——就像和普通联系人聊天一样
  • 对于 Telegram,需要通过 @BotFather 创建机器人并在设置中添加令牌
  • 对于 WhatsApp,需要扫描 QR 码,就像关联新设备一样
  • pairing(配对)系统保护机器人:它只回复被批准的用户
  • OpenClaw 支持超过 10 种聊天工具

在下一课中,我们将设置助手的个性——给它起名字、设定性格和行为规则!