← 返回教程列表

把 OpenClaw 接入 Telegram、WhatsApp、Discord、Slack 与 iMessage

逐个讲解 OpenClaw 支持的聊天渠道接入步骤，以及接入失败时的排查方法。

OpenClaw 最具辨识度的特性是它住在你已经使用的地方。只要接好一个渠道，你就能在安装了对应 IM 的任何设备上联系助手——无需额外 App、无需新登录。本教程逐一讲解每个支持的渠道，以及所需的全部配置。

渠道工作原理

OpenClaw 中的每个聊天渠道都是 Gateway 内部的一个小型适配器。适配器：

1. 拉取或接收来自聊天平台的消息；
2. 将其翻译为内部的"聊天消息"信封；
3. 把回复送回同一会话。

适配器对你而言是无状态的——配一次就一直在跑。你可以同时接入任意多个渠道；同一个助手实例会和所有渠道对话。

Telegram

Telegram 是最容易接入的渠道，因为它使用简单的 bot token。

1. 打开 Telegram，给 @BotFather 发消息；
2. 发送 /newbot，按提示命名并设置唯一用户名；
3. 复制 BotFather 返回的 token；
4. 在 OpenClaw 中运行：

   openclaw channels add telegram --token ""

1. 在 Telegram 中打开与你 bot 的对话，发一句 hello。几秒内就会收到回复。

后续要删除渠道：

openclaw channels remove telegram

限制谁能与 bot 对话

openclaw channels set telegram --allow-user "@your_telegram_handle"

--allow-user 可以多次传入。白名单之外的用户会被静默忽略。

WhatsApp

WhatsApp 使用链接设备协议——没有 API token，你只需要用手机扫码，就像登录 WhatsApp Web 一样。

openclaw channels add whatsapp

终端会打印一个二维码。打开手机上的 WhatsApp → 设置 → 已链接设备 → 链接设备，扫码即可。

给助手配一个真实号码

想让助手拥有真实电话号码（让外部用户能呼叫或发短信），OpenClaw 支持 Twilio 集成：

openclaw integrations add twilio \\
  --account-sid "" \\
  --auth-token "" \\
  --number "+14155550199"

先在 Twilio 控制台购买号码，再填入上面的 SID、Auth Token 与 E.164 号码。

Discord

Discord 使用 bot token，需要打开一个特权 Intent。

1. 打开 Discord 开发者门户，点击 New Application 创建应用；
2. 在侧栏打开 Bot，点击 Add Bot，然后 Reset Token 并复制；
3. 在 Privileged Gateway Intents 下打开 Message Content Intent；
4. 用侧栏 OAuth2 → URL Generator 生成邀请链接，勾选 bot scope 和 Send Messages 权限，把机器人加入你的服务器；
5. 回到终端：

   openclaw channels add discord \\
     --token "" \\
     --guild ""

在任何机器人有权限的频道 @你的机器人 hello，就会收到回复。

Slack

Slack 使用 Socket Mode 应用 token，让 Gateway 无需暴露公网 URL 即可接收事件。

1. 在 api.slack.com/apps 创建一个新的 Slack 应用；
2. 启用 Socket Mode，并生成一个 App-Level Token，至少勾选 connections:write；
3. 在 OAuth & Permissions 下添加权限 chat:write、app_mentions:read、im:history、im:read、im:write；
4. 把应用安装到你的工作区，复制 Bot User OAuth Token；
5. 配置 OpenClaw：

   openclaw channels add slack \\
     --bot-token "" \\
     --app-token ""

@机器人或在私信中直接对话即可。Slack 私信开箱即用；频道消息需要先用 /invite @你的机器人 把机器人请进频道。

iMessage（仅 macOS）

iMessage 适配器使用 macOS 原生的 Messages 应用，所以需要授予"完整磁盘访问权限"。

1. 打开 系统设置 → 隐私与安全性 → 完整磁盘访问权限，把 OpenClaw 加入列表；
2. 在终端执行：

   openclaw channels add imessage

1. 在弹出的系统权限提示中点击同意。

iMessage 会话与联系人之间端到端加密——OpenClaw 只是通过本地 Messages 数据库读写消息。

Signal、Matrix、邮件等

生态里还提供了更多适配器：

渠道	包	说明
Signal	openclaw-signal	基于 signal-cli
Matrix	openclaw-matrix	E2EE 家庭服务器桥接
邮件	openclaw-email	通过应用密码走 IMAP + SMTP
Webhook	内置	在 Gateway 上暴露 /incoming 端点

安装方式一致：

openclaw integrations install openclaw-email
openclaw channels add email --imap imap.gmail.com --user you@gmail.com

渠道连不上的排查方法

执行：

openclaw doctor --channel telegram

它会逐项检查 Gateway 拉起渠道时做的所有事情：token 合法性、网络可达性、权限范围、Gateway 延迟。输出会比较详细——如果你卡住了，可以把失败片段贴到联系表单里给我们。

也可以只流式查看单个渠道的实时日志：

openclaw logs --channel telegram --follow

按消息路由到不同技能

当你接入多个渠道后，可以按聊天 ID 路由，让同一个助手在不同群里表现不同：

openclaw routes add \\
  --match "channel=telegram,chat_id=123456789" \\
  --skill personal

这样可以让工作回复和家庭回复使用不同的技能集。

删除渠道

openclaw channels remove 

删除渠道会撤销本机的凭据。平台侧（BotFather、Slack app、Discord bot）的 token 仍然存在，需要你在平台侧也删除。

下一步

• 渠道配好后，教你的助手编写可复用的技能来调用日历、CRM 或 CI；
• 用长期记忆，让助手能在不同渠道之间记住同事是谁；
• 渠道出问题时，去看排错指南。

发现问题或需要更正？ 联系我们.