词元广场TOKPUB.COM - 欢迎您,支持一个 Key 调用近 600+ 海内外模型,限时特价模型低至 1 折,欢迎上岸!
课程信息 本篇你将学会: 把 AI 助手接到 WhatsApp、Telegram、Discord 等消息平台,在手机上随时跟 AI 聊天 小白速通: 只看你要用的那个平台的章节就行,不需要全部看完。 最简单的是 Telegram(只需要一个 Bot Token)
添加 Channel(配置凭证)→ 登录/链接账号 → 接收/发送消息 → (可选)移除~/.openclaw/openclaw.json(JSON5 格式)和 CLI 命令完成。可以用 openclaw channels status 查看各频道的当前状态。| 平台 | 类型 | 双向消息 | 群组支持 | 接入难度 |
|---|---|---|---|---|
| Telegram | grammY | ✅ | ✅ | ⭐ 简单 |
| Baileys(非官方) | ✅ | ✅ | ⭐ 简单(扫码) | |
| Discord | @buape/carbon | ✅ | ✅ | ⭐⭐ 中等 |
| Slack | @slack/bolt | ✅ | ✅ | ⭐⭐ 中等 |
| Signal | signal-cli | ✅ | ✅ | ⭐⭐ 中等 |
| 飞书 | Extension(@larksuiteoapi/node-sdk) | ✅ | ✅ | ⭐⭐ 中等 |
| Microsoft Teams | 内置 | ✅ | ✅ | ⭐⭐ 中等 |
| Google Chat | 内置 | ✅ | ✅ | ⭐⭐ 中等 |
| Google Meet | 捆绑参与者插件(v2026.4.24+) | ✅(语音) | ✅ | ⭐⭐ 中等 |
| QQ Bot | 内置(v2026.3.31+) | ✅ | ✅ | ⭐⭐ 中等 |
| LINE | @line/bot-sdk | ✅ | ✅ | ⭐⭐ 中等 |
| Matrix | 内置 | ✅ | ✅ | ⭐⭐ 中等 |
| BlueBubbles | iMessage(推荐) | ✅ | ✅ | ⭐⭐ 中等 |
| iMessage | Legacy(macOS only) | ✅ | ❌ | ⭐⭐⭐ 较难 |
| Zalo / Zalo Personal | 内置 | ✅ | ✅ | ⭐⭐ 中等 |
| Web Chat | Gateway WebSocket | ✅ | ❌ | ⭐ 简单 |
📋 开始之前你需要: 一个 Telegram 账号、通过 @BotFather 创建的 Bot Token
@BotFather/newbot123456789:ABCdefGHIjklMNOpqrsTUVwxyz)BotFather: Done! Congratulations on your new bot.
Use this token to access the HTTP API:
123456789:ABCdefGHIjklMNOpqrsTUVwxyz~/.openclaw/openclaw.json(JSON5 格式)中添加 Telegram 配置:{
channels: {
telegram: {
botToken: "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
// 或者使用环境变量 TELEGRAM_BOT_TOKEN,此处可省略 botToken
// 群组配置(可选,按群组 ID 配置)
// groups: {
// "-1001234567890": { ... }, // 以群组 ID 为键
// },
// Webhook 模式(可选,默认使用 polling)
// webhookUrl: "https://your-domain.com/webhook/telegram",
// webhookSecret: "your-webhook-secret",
},
},
}| 特性 | Webhook | Polling |
|---|---|---|
| 实时性 | 即时推送 | 有延迟(取决于轮询间隔) |
| 资源消耗 | 低(被动接收) | 高(持续请求) |
| 网络要求 | 需要公网 HTTPS 地址 | 不需要公网地址 |
| 适用场景 | 生产环境 | 开发/测试环境 |
{
channels: {
telegram: {
botToken: "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
// 群组配置(按群组 ID 配置)
// groups: {
// "-1001234567890": { ... }, // 以群组 ID 为键
// },
// Webhook 配置(可选)
webhookUrl: "https://your-domain.com/webhook/telegram",
webhookSecret: "your-webhook-secret",
},
},
}/setprivacy → Disable)📋 开始之前你需要: 一部安装了 WhatsApp 的手机、手机和电脑在同一网络环境下
@whiskeysockets/baileys)接入 WhatsApp,通过扫码链接设备,无需 Meta Cloud API。~/.openclaw/credentials 目录中。~/.openclaw/openclaw.json 中配置 WhatsApp:{
channels: {
whatsapp: {
// 控制谁可以和 Bot 对话
// 设置为 ["*"] 表示允许所有人
allowFrom: ["+8613800138000", "+8613900139000"],
// 群组配置(按群组 JID 为键配置)
// groups: {
// "120363xxx@g.us": { ... }, // 以群组 JID 为键
// },
},
},
}~/.openclaw/credentials 目录后重新扫码allowFrom 配置是否包含了对方的号码allowFrom: ["*"]注意:Baileys 是非官方库,WhatsApp 可能会对自动化使用进行限制。建议仅用于个人或小规模场景。
📋 开始之前你需要: 一个 Discord 账号、一个你有管理权限的 Discord 服务器
https://discord.com/api/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=274877975552&scope=bot%20applications.commandsSend Messages:发送消息Read Message History:读取历史消息Use Slash Commands:使用斜杠命令Attach Files:发送文件Embed Links:发送嵌入消息~/.openclaw/openclaw.json 中配置 Discord:{
channels: {
discord: {
token: "YOUR_DISCORD_BOT_TOKEN",
// 或者使用环境变量 DISCORD_BOT_TOKEN,此处可省略 token
// 命令配置
commands: {
native: true, // 启用原生 Slash Commands
// nativeSkills: true, // 将技能注册为 Slash Commands
},
// 允许的用户(可选)
// allowFrom: ["user-id-1", "user-id-2"],
// 服务器白名单(可选)
// guilds: ["guild-id-1"],
// 媒体大小限制(MB)
// mediaMaxMb: 25,
},
},
}commands.native: true)。📋 开始之前你需要: 一个 Slack 工作区的管理员权限、能访问 Slack API 的浏览器
chat:write - 发送消息channels:history - 读取公共频道消息groups:history - 读取私有频道消息im:history - 读取私聊消息app_mentions:read - 读取 @提及files:read - 读取文件files:write - 上传文件https://your-domain.com/webhook/slackmessage.channels - 公共频道消息message.groups - 私有频道消息message.im - 私聊消息app_mention - @提及~/.openclaw/openclaw.json 中配置 Slack:{
channels: {
slack: {
botToken: "xoxb-xxx", // 或环境变量 SLACK_BOT_TOKEN
appToken: "xapp-xxx", // 或环境变量 SLACK_APP_TOKEN(Socket Mode 必需)
},
},
}| 特性 | Socket Mode | Events API |
|---|---|---|
| 网络要求 | 不需要公网地址 | 需要公网 HTTPS |
| 实时性 | WebSocket 实时 | HTTP 推送 |
| 适用场景 | 开发/内部工具 | 生产环境 |
| 配置复杂度 | 简单 | 需要配置 Webhook |
/invite @your-bot)📋 开始之前你需要: 飞书企业管理员权限、能访问 飞书开放平台 的浏览器
注意:飞书是通过 OpenClaw 的 extension 机制支持的( extensions/feishu/),使用@larksuiteoapi/node-sdk。详细配置请参考 OpenClaw 官方文档docs/channels/feishu.md。
im:message - 获取与发送单聊、群组消息im:message.group_at_msg - 接收群聊中 @机器人消息im:resource - 获取与上传图片或文件资源https://your-domain.com/webhook/feishuim.message.receive_v1 - 接收消息docs/channels/feishu.md 为准。一般需在飞书开放平台获取 App ID 和 App Secret,并在 OpenClaw 配置中填写。📋 开始之前你需要: OpenClaw Gateway 已启动运行(默认端口 18789)
18789),实现实时双向通信。这不是一个独立的 HTTP 服务,而是 Gateway 的一部分。ws://localhost:18789📋 开始之前你需要: Google 账号、Chrome 浏览器或 Twilio 语音通道
具体配置字段和认证流程可能随版本演进,请参考 openclaw官方文档中的 Google Meet 章节。
📋 开始之前你需要: QQ 开放平台开发者账号
~/.openclaw/openclaw.json 的 channels 中添加对应配置即可。具体配置字段以 OpenClaw 官方文档为准。| 平台 | 说明 |
|---|---|
| Signal | 通过 signal-cli 接入 |
| BlueBubbles | iMessage 接入(推荐方式) |
| iMessage | Legacy 方式,仅 macOS |
| Microsoft Teams | 内置支持 |
| Google Chat | 内置支持 |
| Matrix | 内置支持(v2026.4.22 新增交叉签名验证) |
| Zalo / Zalo Personal | 内置支持 |
| LINE | 通过 @line/bot-sdk 接入 |
~/.openclaw/openclaw.json 的 channels 中添加对应平台的配置即可。⏭️ 小白可跳过 — 这部分面向开发者,普通用户不需要看
概念性说明:以下 TypeScript 接口是对 Channel 系统的概念性描述,帮助理解其设计思路。实际接口可能与此不完全一致,请以 你所安装 OpenClaw 版本自带的类型定义与官方文档 为准。
dmPolicy 设置为 "pairing" 时,未知发送者给 Bot 发消息会收到一个配对码。管理员需要手动批准:dmPolicy 设置为 "open" 时,任何人都可以直接与 Bot 对话。此时需要配合 allowFrom 包含 "*" 来允许所有用户。pairing 模式,防止未授权用户滥用open 模式方便调试allowFrom 配置可以实现更细粒度的访问控制| 格式 | Telegram | Discord | Slack | 飞书 | |
|---|---|---|---|---|---|
| 粗体 | ✅ *text* | ✅ *text* | ✅ **text** | ✅ *text* | ✅ |
| 斜体 | ✅ _text_ | ✅ _text_ | ✅ *text* | ✅ _text_ | ✅ |
代码 | ✅ `code` | ✅ `code` | ✅ `code` | ✅ `code` | ✅ |
| 代码块 | ✅ | ❌ | ✅ | ✅ | ✅ |
| 链接 | ✅ | ✅ 自动识别 | ✅ | ✅ | ✅ |
| 平台 | 最大长度 | OpenClaw 处理方式 |
|---|---|---|
| Telegram | 4096 字符 | 自动分段发送 |
| 4096 字符 | 自动分段发送 | |
| Discord | 2000 字符 | 自动分段发送 |
| Slack | 40000 字符 | 通常不需要分段 |
| 飞书 | 30000 字符 | 通常不需要分段 |
注意:以下为概念性配置示例,实际配置格式请以 OpenClaw 文档为准。
// 全局媒体配置(概念性示例)
{
media: {
autoDownload: true,
storagePath: "./media",
maxFileSize: 20971520, // 20MB
supportedTypes: [
"image/jpeg",
"image/png",
"image/gif",
"audio/ogg",
"audio/mpeg",
"video/mp4",
"application/pdf",
],
},
}/setprivacy -> Disable~/.openclaw/credentials 目录后重新执行 openclaw channels login whatsapp 扫码| 下一步 | 文档 | 说明 |
|---|---|---|
| 配置技能 | 06-技能系统指南 | 让 Agent 具备更多能力 |
| 记忆系统 | 07-记忆系统指南 | 让 AI 记住用户偏好 |
| 安全配置 | 10-安全配置指南 | Webhook 安全、Token 管理 |