OpenClaw 支持 20 余个主流通讯平台,其中微信、Discord 和 WhatsApp 是国内外用户最常接入的三个渠道。本文将逐一拆解三个平台的完整接入流程,帮你真正把 AI 助手”搬进”日常使用的消息软件里。更多资源请访问 OpenClaw 中文版官网。
前提条件:开始以下任何接入流程前,请确保 OpenClaw 已完成安装并正常运行(
openclaw gateway status显示运行中,Web 控制面板http://127.0.0.1:18789可正常访问)。
一、OpenClaw 多平台架构简介
在开始操作之前,有一个概念值得先了解:OpenClaw 采用的是单 Gateway 多频道架构。你只需运行一个 OpenClaw 实例,就可以同时连接微信、Discord、WhatsApp 等多个平台——它们共享同一个 AI 智能体和同一套记忆系统。
这意味着你可以早上在微信里向助手布置任务,下午在 Discord 里查看进度,晚上通过 WhatsApp 收到任务完成通知——同一个助手,同一段记忆,随时随地切换入口。
二、微信(WeChat)接入教程
2026 年 3 月 22 日,腾讯正式发布了 WeChat ClawBot 插件(官方包名 @tencent-weixin/openclaw-weixin),这是微信首次为开源 AI 智能体框架提供原生支持,无需第三方破解,不存在封号风险。
注意:微信 ClawBot 插件目前仍在逐步灰度推送中,需要 OpenClaw 版本 ≥ 2026.3.22,且当前仅支持私聊场景,不支持群聊。
第一步:更新微信至最新版本
打开手机微信,前往 「我」→「设置」→「关于微信」,确认已更新至最新版本。ClawBot 插件需要最新版微信才能正常显示。
第二步:在微信中启用 ClawBot 插件
在微信中依次进入:「我」→「设置」→「功能」→「插件」,在可用插件列表中找到 ClawBot,点击启用。如果暂未看到该插件,说明灰度推送尚未覆盖你的账号,可稍后再试。
第三步:在 OpenClaw 中安装微信插件
打开终端,执行以下命令安装官方微信插件:
openclaw plugins install "@tencent-weixin/openclaw-weixin"
第四步:扫码绑定微信账号
执行登录命令,终端中会生成一个二维码:
openclaw channels login --channel openclaw-weixin
用你的微信扫描终端中显示的二维码,确认授权后即可完成绑定。绑定成功后,终端会提示”WeChat channel connected”。
第五步:在微信中测试
打开微信,在搜索框搜索你的 ClawBot 助手名称,向其发送一条消息(如”你好”),如果 AI 助手正常回复,说明接入成功。
常见问题:扫码后提示”连接超时”
二维码有效期较短,请在生成后 30 秒内完成扫描。如已过期,重新执行登录命令即可生成新二维码。
三、Discord 接入教程
Discord 使用官方 Bot API 接入,配置最稳定,推荐团队和社群用户优先选择此平台。整个流程约 10 分钟。
第一步:创建 Discord 应用和 Bot
- 打开
discord.com/developers/applications,登录后点击右上角 「New Application」 - 输入应用名称(例如”My OpenClaw Bot”),点击 Create
- 在左侧菜单选择 「Bot」,点击 「Add Bot」 确认创建
- 点击 「Reset Token」 生成 Bot Token,立即复制保存(此 Token 只显示一次)
第二步:开启必要权限
在 Bot 设置页面,向下滚动找到 「Privileged Gateway Intents」,开启以下两项:
- Message Content Intent(必须开启,否则 Bot 无法读取消息内容)
- Server Members Intent(可选,用于成员相关功能)
点击页面底部的 「Save Changes」 保存。
第三步:邀请 Bot 加入你的服务器
- 在左侧菜单选择 「OAuth2」→「URL Generator」
- 在 Scopes 中勾选 「bot」
- 在 Bot Permissions 中勾选:Send Messages、Read Message History、View Channels(以及你需要的其他权限)
- 复制页面底部生成的邀请链接,粘贴到浏览器中打开,选择目标服务器并确认邀请
第四步:在 OpenClaw 中配置 Discord 频道
打开 OpenClaw Web 控制面板(http://127.0.0.1:18789),进入 Channels 页面,选择 Discord,粘贴第一步获取的 Bot Token,点击保存。
也可通过命令行完成:
openclaw channels add discord --token "你的Bot Token"
第五步:配置允许访问的用户 ID
为了安全起见,需要将你的 Discord 用户 ID 添加到允许列表。在 Discord 中开启开发者模式(设置 → 高级 → 开发者模式),然后右键点击自己的头像,选择「复制用户 ID」。
将用户 ID 填入 OpenClaw 的频道配置中,确保只有你本人可以与 Bot 交互。
第六步:测试连接
在你邀请了 Bot 的 Discord 服务器中,向 Bot 发送私信或 @提及它,如果收到 AI 回复,说明接入成功。
常见问题:Bot 在线但不响应消息
最常见原因是未开启 Message Content Intent。回到 Discord 开发者后台,确认该权限已开启并保存,然后重启 OpenClaw 服务:openclaw daemon restart。
四、WhatsApp 接入教程
WhatsApp 接入相比 Telegram 和 Discord 略复杂,且有一定账号风险需要注意。OpenClaw 通过 Baileys 库实现 WhatsApp Web 协议连接,原理与扫码登录 WhatsApp Web 网页版相同。
重要提示:强烈建议使用专用手机号码(而非个人主号)接入 WhatsApp。使用个人号在服务器 IP 上进行 24 小时自动化操作,存在被 WhatsApp 检测封号的风险。如果你日常主要使用 Telegram 或微信,可以考虑跳过此部分。
第一步:了解 WhatsApp 关联设备机制
WhatsApp 允许每个账号最多绑定 4 台关联设备(手机为主设备,不占用名额)。OpenClaw 会占用其中一个关联设备槽位,你还剩 3 个可用于 WhatsApp Web、WhatsApp Desktop 等。
第二步:启动 WhatsApp 频道配置
在终端执行以下命令启动 WhatsApp 接入向导:
openclaw channels add whatsapp
执行后,终端中会生成一个二维码。
第三步:在手机上扫码配对
- 打开手机 WhatsApp,点击右上角菜单(Android)或点击底部「设置」(iOS)
- 选择 「关联设备」
- 点击 「关联新设备」
- 用摄像头扫描终端中显示的二维码
扫码成功后,终端会提示”WhatsApp channel connected”,你的 WhatsApp 账号已与 OpenClaw 绑定。
第四步:在控制面板中完成配置
打开 Web 控制面板,在 Channels 页面确认 WhatsApp 显示为已连接状态。建议开启以下设置以保护隐私:
- 设置
ignoreGroups: true,让 Bot 忽略群聊消息,仅响应私聊 - 配置消息来源白名单,只允许指定联系人触发 AI 回复
第五步:测试连接
在 WhatsApp 中给你的 Bot 账号发送一条消息(可以给自己发),正常情况下 AI 助手会在数秒内回复。
常见问题:连接断开后无法自动重连
WhatsApp Web 连接受网络稳定性影响,偶尔会断开。OpenClaw 内置自动重连机制,大多数情况下无需手动干预。如果频繁断开,检查服务器 IP 是否被 WhatsApp 标记(使用数据中心 IP 风险较高),建议改用家庭宽带 IP 运行 OpenClaw。
五、同时运行多个平台:路由配置技巧
OpenClaw 支持多个平台同时运行,且共享同一个 AI 记忆。以下是几个实用配置技巧:
统一身份绑定:你的微信账号、Discord 用户 ID 和 WhatsApp 号码默认被视为三个独立用户。如果你希望跨平台共享同一段对话记忆,需要在 OpenClaw 配置文件(~/.openclaw/openclaw.json)中将它们绑定为同一身份。
群组安全设置:强烈建议在所有平台的配置中开启 DM Pairing(陌生人配对验证),以及在群聊中设置 requireMention: true(需要 @提及才响应),避免 Bot 被滥用。
检查多平台状态:随时可以通过以下命令查看所有已连接频道的状态:
openclaw channels list
openclaw doctor
六、三个平台横向对比
| 对比维度 | 微信 | Discord | |
|---|---|---|---|
| 接入方式 | 官方 ClawBot 插件 | 官方 Bot API | WhatsApp Web 协议 |
| 配置难度 | 简单 | 简单 | 中等 |
| 连接稳定性 | 高(官方支持) | 高(官方支持) | 中(非官方协议) |
| 封号风险 | 无 | 无 | 有(建议专用号) |
| 群聊支持 | 暂不支持 | 支持 | 支持(建议关闭) |
| 国内可用性 | ✅ 最佳 | 需科学上网 | 需科学上网 |
| 推荐场景 | 国内个人日常使用 | 开发者 / 团队协作 | 海外用户 / 业务场景 |
总结
三个平台各有优势:国内用户首选微信(官方插件,零风险,配置最简单);开发者和团队用户首选 Discord(Bot API 最稳定,权限管理精细);海外用户或有业务需求的用户选择 WhatsApp(覆盖最广,但建议使用专用号)。
完成接入后,建议运行 openclaw doctor 做一次全面健康检查,并在控制面板中配置合理的安全策略。想获取更多中文配置指南和技巧,欢迎访问 OpenClaw 中文版官网。