05-消息平台接入指南

05 消息平台接入指南 05 消息平台接入指南 Modified June 10 9.2 配置 OpenClaw ⠀ QQ Bot 作为内置 Channel，在 /.openclaw/openclaw.json 的 channels 中添加对应配置即可。具体配置字段以 OpenClaw 官方文档为准。 ⠀ 9.3 支持的功能 ⠀ • 多账号配置 • 斜杠命令（Slash Commands） • 提醒功能 • 媒体消息（图片、文件等） 10. 其他支持的平台 ⠀ OpenClaw 还支持以下平台，具体配置请参考各平台对应的官方文档： ⠀ ⠀ 这些平台的配置方式与 Telegram、Discord 等类似，在 /.openclaw/openclaw.json 的 channels 中添加对应平台的配置即可。 ⠀ v2026.5.22 之后，部分平台的配置细节需要额外记录： ⠀ 11. 自定义 Channel 开发 ⠀ ⏭️ 小白可跳过 — 这部分面向开发者，普通用户不需要看 ⠀ 概念性说明：以下 TypeScript 接口是对 Channel 系统的概念性描述，帮助理解其设计思路。实际接口可能与此不完全一致，请以 你所安装 OpenClaw 版本自带的类型定义与官方文档 为准。 ⠀ 如果 OpenClaw 不支持你需要的平台，可以开发自定义 Channel。 ⠀ 11.1 Channel 接口（概念性） ⠀ Code block Plain Text interface Channel { name: string; platform: string; connect(): Promise<void ; disconnect(): Promise<void ; onMessage(handler: (message: IncomingMessage) = void): void; sendMessage(to: string, message: OutgoingMessage): Promise<void ; } ⠀ 11.2 消息格式（概念性） ⠀ Code block Plain Text interface IncomingMessage { id: string; from: { id: string; name: string; platform: string; }; content: { type: 'text' | 'image' | 'audio' | 'video' | 'file'; text?: string; mediaUrl?: string; mimeType?: string; }; timestamp: number; metadata: Record<string, any ; } 12. DM 安全策略（Pairing） ⠀ OpenClaw 提供 DM Pairing 机制来控制谁可以与 Bot 私聊。 ⠀ 12.1 Pairing 模式 ⠀ 当 dmPolicy 设置为 "pairing" 时，未知发送者给 Bot 发消息会收到一个配对码。管理员需要手动批准： ⠀ Code block Plain Text openclaw pairing approve <channel <code ⠀ 12.2 Open 模式 ⠀ 当 dmPolicy 设置为 "open" 时，任何人都可以直接与 Bot 对话。此时需要配合 allowFrom 包含 " " 来允许所有用户。 ⠀ 12.3 使用建议 ⠀ • 生产环境建议使用 pairing 模式，防止未授权用户滥用 • 测试环境可以使用 open 模式方便调试 • 配合各平台的 allowFrom 配置可以实现更细粒度的访问控制 13. 消息格式适配 ⠀ 不同平台的消息格式差异很大，OpenClaw 会自动处理格式转换。 ⠀ 13.1 Markdown 支持对比 ⠀ 格式 Telegram WhatsApp Discord Slack 飞书 粗体 ✅ text ✅ text ✅ text ✅ text ✅ 斜体 ✅ text ✅ text ✅ text ✅ text ✅ 代码 ✅ code ✅ code ✅ code ✅ code ✅ 代码块 ✅ ❌ ✅ ✅ ✅ 链接 ✅ ✅ 自动识别 ✅ ✅ ✅ ⠀ 13.2 长消息处理 ⠀ 不同平台有不同的消息长度限制： ⠀ 平台 最大长度 OpenClaw 处理方式 Telegram 4096 字符 自动分段发送 WhatsApp 4096 字符 自动分段发送 Discord 2000 字符 自动分段发送 Slack 40000 字符 通常不需要分段 飞书 30000 字符 通常不需要分段 ⠀ 13.3 媒体文件处理 ⠀ 注意：以下为概念性配置示例，实际配置格式请以 OpenClaw 文档为准。 ⠀ Code block Plain Text // 全局媒体配置（概念性示例） { media: { autoDownload: true, storagePath: "./media", maxFileSize: 20971520, // 20MB supportedTypes: [ "image/jpeg", "image/png", "image/gif", "audio/ogg", "audio/mpeg", "video/mp4", "application/pdf", ], }, } 14. 常见问题排查 ⠀ 14.1 通用问题 ⠀ Channel 连接有问题？ Code block Plain Text 查看频道状态 openclaw channels status 查看频道日志 openclaw channels logs <channel ⠀ 消息延迟很高？ • Webhook 模式：检查服务器网络延迟 • 检查 AI 模型响应时间 ⠀ 14.2 Webhook 通用问题 ⠀ Webhook 验证失败？ 9.2 配置 OpenClaw ⠀ QQ Bot 作为内置 Channel，在 /.openclaw/openclaw.json 的 channels 中添加对应配置即可。具体配置字段以 OpenClaw 官方文档为准。 ⠀ 9.3 支持的功能 ⠀ • 多账号配置 • 斜杠命令（Slash Commands） • 提醒功能 • 媒体消息（图片、文件等） 10. 其他支持的平台 ⠀ OpenClaw 还支持以下平台，具体配置请参考各平台对应的官方文档： ⠀ ⠀ 这些平台的配置方式与 Telegram、Discord 等类似，在 /.openclaw/openclaw.json 的 channels 中添加对应平台的配置即可。 ⠀ v2026.5.22 之后，部分平台的配置细节需要额外记录： ⠀ 11. 自定义 Channel 开发 ⠀ ⏭️ 小白可跳过 — 这部分面向开发者，普通用户不需要看 ⏭️ 小白可跳过 — 这部分面向开发者，普通用户不需要看 ⠀ 概念性说明：以下 TypeScript 接口是对 Channel 系统的概念性描述，帮助理解其设计思路。实际接口可能与此不完全一致，请以 你所安装 OpenClaw 版本自带的类型定义与官方文档 为准。 概念性说明：以下 TypeScript 接口是对 Channel 系统的概念性描述，帮助理解其设计思路。实际接口可能与此不完全一致，请以 你所安装 OpenClaw 版本自带的类型定义与官方文档 为准。 ⠀ 如果 OpenClaw 不支持你需要的平台，可以开发自定义 Channel。 ⠀ 11.1 Channel 接口（概念性） ⠀ ⠀ 11.2 消息格式（概念性） ⠀ 12. DM 安全策略（Pairing） ⠀ OpenClaw 提供 DM Pairing 机制来控制谁可以与 Bot 私聊。 ⠀ 12.1 Pairing 模式 ⠀ 当 dmPolicy 设置为 "pairing" 时，未知发送者给 Bot 发消息会收到一个配对码。管理员需要手动批准： ⠀ ⠀ 12.2 Open 模式 ⠀ 当 dmPolicy 设置为 "open" 时，任何人都可以直接与 Bot 对话。此时需要配合 allowFrom 包含 " " 来允许所有用户。 ⠀ 12.3 使用建议 ⠀ • 生产环境建议使用 pairing 模式，防止未授权用户滥用 • 测试环境可以使用 open 模式方便调试 • 配合各平台的 allowFrom 配置可以实现更细粒度的访问控制 13. 消息格式适配 ⠀ 不同平台的消息格式差异很大，OpenClaw 会自动处理格式转换。 ⠀ 13.1 Markdown 支持对比 ⠀ 格式 Telegram WhatsApp Discord Slack 飞书 粗体 ✅ text ✅ text ✅ text ✅ text ✅ 斜体 ✅ text ✅ text ✅ text ✅ text ✅ 代码 ✅ code ✅ code ✅ code ✅ code ✅ 代码块 ✅ ❌ ✅ ✅ ✅ 链接 ✅ ✅ 自动识别 ✅ ✅ ✅ 格式 格式 Telegram Telegram WhatsApp WhatsApp Discord Discord Slack Slack 飞书 飞书 粗体 粗体 ✅ text ✅ text ✅ text ✅ text ✅ text ✅ text ✅ text ✅ text ✅ ✅ 斜体 斜体 ✅ text ✅ text ✅ text ✅ text ✅ text ✅ text ✅ text ✅ text ✅ ✅ 代码 代码 ✅ code ✅ code ✅ code ✅ code ✅ code ✅ code ✅ code ✅ code ✅ ✅ 代码块 代码块 ✅ ✅ ❌ ❌ ✅ ✅ ✅ ✅ ✅ ✅ 链接 链接 ✅ ✅ ✅ 自动识别 ✅ 自动识别 ✅ ✅ ✅ ✅ ✅ ✅ ⠀ 13.2 长消息处理 ⠀ 不同平台有不同的消息长度限制： ⠀ 平台 最大长度 OpenClaw 处理方式 Telegram 4096 字符 自动分段发送 WhatsApp 4096 字符 自动分段发送 Discord 2000 字符 自动分段发送 Slack 40000 字符 通常不需要分段 飞书 30000 字符 通常不需要分段 平台 平台 最大长度 最大长度 OpenClaw 处理方式 OpenClaw 处理方式 Telegram Telegram 4096 字符 4096 字符 自动分段发送 自动分段发送 WhatsApp WhatsApp 4096 字符 4096 字符 自动分段发送 自动分段发送 Discord Discord 2000 字符 2000 字符 自动分段发送 自动分段发送 Slack Slack 40000 字符 40000 字符 通常不需要分段 通常不需要分段 飞书 飞书 30000 字符 30000 字符 通常不需要分段 通常不需要分段 ⠀ 13.3 媒体文件处理 ⠀ 注意：以下为概念性配置示例，实际配置格式请以 OpenClaw 文档为准。 注意：以下为概念性配置示例，实际配置格式请以 OpenClaw 文档为准。 ⠀ 14. 常见问题排查 ⠀ 14.1 通用问题 ⠀ Channel 连接有问题？ ⠀ 消息延迟很高？ • Webhook 模式：检查服务器网络延迟 • 检查 AI 模型响应时间 ⠀ 14.2 Webhook 通用问题 ⠀ Webhook 验证失败？ • 确认 URL 是 HTTPS（大多数平台要求） • 确认 SSL 证书有效（不能是自签名证书，除非平台允许） • 确认 URL 可以从公网访问 ⠀ 本地开发怎么测试 Webhook？ ⠀ 使用 ngrok 或 cloudflared 创建临时隧道： ⠀ ⠀ 14.3 平台特定问题 ⠀ Telegram Bot 在群组中不回复？ • 关闭 Privacy Mode：在 BotFather 中 /setprivacy Disable • 或者在群组配置中启用 @提及 才回复的选项 ⠀ WhatsApp 连接断开？ • 删除 /.openclaw/credentials 目录后重新执行 openclaw channels login whatsapp 扫码 • 确保手机 WhatsApp 保持在线 ⠀ Discord Bot 没有权限？ • 重新生成邀请链接，确保包含所需权限 • 在服务器设置中检查 Bot 角色权限 ⠀ Slack Bot 收不到消息？ • 确认 Bot 已被邀请到频道 • 确认 Event Subscriptions 中的 Request URL 验证通过 • 检查 Bot Token Scopes 是否完整 下一步 ⠀ 下一步 文档 说明 配置技能 06 技能系统指南 让 Agent 具备更多能力 记忆系统 07 记忆系统指南 让 AI 记住用户偏好 安全配置 10 安全配置指南 Webhook 安全、Token 管理 下一步 下一步 文档 文档 说明 说明 配置技能 配置技能 06 技能系统指南 06 技能系统指南 让 Agent 具备更多能力 让 Agent 具备更多能力 记忆系统 记忆系统 07 记忆系统指南 07 记忆系统指南 让 AI 记住用户偏好 让 AI 记住用户偏好 安全配置 安全配置 10 安全配置指南 10 安全配置指南 Webhook 安全、Token 管理 Webhook 安全、Token 管理 课程信息 ⠀ • 作者：老金 • GitHub：https://github.com/KimYx0207 • 公众号：老金带你玩AI • X（Twitter）：老金带你玩AI • 个人博客：https://aiking.dev • 难度等级：🟡 进阶 • 阅读时间：20 分钟 • 前置知识：已完成快速开始（03 快速开始指南） ⠀ 本篇你将学会： 把 AI 助手接到 WhatsApp、Telegram、Discord 等消息平台，在手机上随时跟 AI 聊天 ⠀ 小白速通： 只看你要用的那个平台的章节就行，不需要全部看完。最简单的是 Telegram（只需要一个 Bot Token） ⠀ 概述 ⠀ OpenClaw 的核心卖点之一：一个 Gateway 连接所有消息平台。你在 WhatsApp 上给 AI 发消息，它能帮你在 Telegram 上回复别人。不管你的用户分散在哪些平台，OpenClaw 都能把它们统一到一个入口。 ⠀ 这篇指南会带你从零开始，把各个消息平台接入 OpenClaw。从概念理解到实际配置，从主流平台到小众渠道，从基础接入到高级玩法，全部覆盖。 1. Channel（消息平台）概念详解 ⠀ 1.1 什么是 Channel ⠀ 在 OpenClaw 里，Channel 就是"消息平台"的抽象。每个 Channel 代表一个消息来源和目的地： ⠀ • 一个 WhatsApp 账号 = 一个 Channel • 一个 Telegram Bot = 一个 Channel • 一个 Discord Bot = 一个 Channel • 一个 Slack App = 一个 Channel • 一个飞书应用 = 一个 Channel（通过 extension） • 一个 Signal 账号 = 一个 Channel • 一个 Web Chat 组件 = 一个 Channel ⠀ Channel 是 OpenClaw 消息系统的基本单元。所有消息都通过 Channel 进出。你可以把它理解成一个"双向管道"——外部平台的消息从这里流入 OpenClaw，OpenClaw 的回复也从这里流出到对应平台。 ⠀ 1.2 Channel 的生命周期 ⠀ ⠀ Channel 的管理主要通过配置文件 /.openclaw/openclaw.json（JSON5 格式）和 CLI 命令完成。可以用 openclaw channels status 查看各频道的当前状态。 ⠀ 1.3 Channel 管理命令 ⠀ ⠀ 1.4 支持的平台一览 ⠀ 平台 类型 双向消息 群组支持 接入难度 Telegram grammY ✅ ✅ ⭐ 简单 WhatsApp 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 Telegram grammY grammY ✅ ✅ ✅ ✅ ⭐ 简单 ⭐ 简单 WhatsApp WhatsApp Baileys（非官方） Baileys（非官方） ✅ ✅ ✅ ✅ ⭐ 简单（扫码） ⭐ 简单（扫码） Discord Discord @buape/carbon @buape/carbon ✅ ✅ ✅ ✅ ⭐⭐ 中等 ⭐⭐ 中等 Slack Slack @slack/bolt @slack/bolt ✅ ✅ ✅ ✅ ⭐⭐ 中等 ⭐⭐ 中等 Signal Signal signal cli signal cli ✅ ✅ ✅ ✅ ⭐⭐ 中等 ⭐⭐ 中等 飞书 飞书 Extension（@larksuiteoapi/node sdk） Extension（@larksuiteoapi/node sdk） ✅ ✅ ✅ ✅ ⭐⭐ 中等 ⭐⭐ 中等 Microsoft Teams Microsoft Teams 内置 内置 ✅ ✅ ✅ ✅ ⭐⭐ 中等 ⭐⭐ 中等 Google Chat Google Chat 内置 内置 ✅ ✅ ✅ ✅ ⭐⭐ 中等 ⭐⭐ 中等 Google Meet Google Meet 捆绑参与者插件（v2026.4.24+） 捆绑参与者插件（v2026.4.24+） ✅（语音） ✅（语音） ✅ ✅ ⭐⭐ 中等 ⭐⭐ 中等 QQ Bot QQ Bot 内置（v2026.3.31+） 内置（v2026.3.31+） ✅ ✅ ✅ ✅ ⭐⭐ 中等 ⭐⭐ 中等 LINE LINE @line/bot sdk @line/bot sdk ✅ ✅ ✅ ✅ ⭐⭐ 中等 ⭐⭐ 中等 Matrix Matrix 内置 内置 ✅ ✅ ✅ ✅ ⭐⭐ 中等 ⭐⭐ 中等 BlueBubbles BlueBubbles iMessage（推荐） iMessage（推荐） ✅ ✅ ✅ ✅ ⭐⭐ 中等 ⭐⭐ 中等 iMessage iMessage Legacy（macOS only） Legacy（macOS only） ✅ ✅ ❌ ❌ ⭐⭐⭐ 较难 ⭐⭐⭐ 较难 Zalo / Zalo Personal Zalo / Zalo Personal 内置 内置 ✅ ✅ ✅ ✅ ⭐⭐ 中等 ⭐⭐ 中等 Web Chat Web Chat Gateway WebSocket Gateway WebSocket ✅ ✅ ❌ ❌ ⭐ 简单 ⭐ 简单 2. Telegram 接入 ⠀ v2026.5.22 通道口径：官方 Channels 页面列出的平台已不止 Telegram / WhatsApp / Discord / Slack / 飞书。当前应按 WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、IRC、Microsoft Teams、Matrix、飞书、LINE、Mattermost、Nextcloud Talk、Nostr、Synology Chat、Tlon、Twitch、Zalo、Zalo Personal、WeChat、QQ、WebChat、macOS、iOS/Android 等通道理解；具体可用性以你安装的插件和官方文档为准。 v2026.5.22 通道口径：官方 Channels 页面列出的平台已不止 Telegram / WhatsApp / Discord / Slack / 飞书。当前应按 WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、IRC、Microsoft Teams、Matrix、飞书、LINE、Mattermost、Nextcloud Talk、Nostr、Synology Chat、Tlon、Twitch、Zalo、Zalo Personal、WeChat、QQ、WebChat、macOS、iOS/Android 等通道理解；具体可用性以你安装的插件和官方文档为准。 ⠀ v2026.5.27 新增注意：Telegram 文档补充了 wildcard topic defaults；Slack / Telegram ack reactions、Feishu dynamic agents、Discord voice follow、Meeting Notes 外部插件也都在这一轮更新中出现。v2026.5.26 / v2026.5.27 又补强了 Telegram durable outbound delivery、iMessage 附件 roots / thumb approval reactions、WhatsApp group / media 行为、Signal reaction approvals、Discord voice playback / model picker、Matrix mention inert delivery、Google Chat DM thread suppression 等通道细节。下面各平台章节会按“先接入、再确认新版行为”的顺序讲。 v2026.5.27 新增注意：Telegram 文档补充了 wildcard topic defaults；Slack / Telegram ack reactions、Feishu dynamic agents、Discord voice follow、Meeting Notes 外部插件也都在这一轮更新中出现。v2026.5.26 / v2026.5.27 又补强了 Telegram durable outbound delivery、iMessage 附件 roots / thumb approval reactions、WhatsApp group / media 行为、Signal reaction approvals、Discord voice playback / model picker、Matrix mention inert delivery、Google Chat DM thread suppression 等通道细节。下面各平台章节会按“先接入、再确认新版行为”的顺序讲。 ⠀ 📋 开始之前你需要： 一个 Telegram 账号、通过 @BotFather 创建的 Bot Token 📋 开始之前你需要： 一个 Telegram 账号、通过 @BotFather 创建的 Bot Token ⠀ Telegram 是最容易接入的平台，5 分钟就能搞定。 ⠀ 2.1 创建 Telegram Bot ⠀ 1. 在 Telegram 中搜索 @BotFather 2. 发送 /newbot 3. 按提示输入 Bot 名称和用户名 4. 获得 Bot Token（机器人的身份凭证，类似于登录密码）（格式：123456789:ABCdefGHIjklMNOpqrsTUVwxyz） ⠀ ⠀ 2.2 配置 OpenClaw ⠀ 在 /.openclaw/openclaw.json（JSON5 格式）中添加 Telegram 配置： ⠀ ⠀ 也可以通过环境变量设置 Bot Token： ⠀ ⠀ 2.3 Webhook vs Polling ⠀ Webhook（消息推送机制，平台主动把新消息发给你的服务器）和 Polling（你的服务器主动去平台拉取新消息）是两种接收消息的方式： ⠀ 特性 Webhook Polling 实时性 即时推送 有延迟（取决于轮询间隔） 资源消耗 低（被动接收） 高（持续请求） 网络要求 需要公网 HTTPS 地址 不需要公网地址 适用场景 生产环境 开发/测试环境 特性 特性 Webhook Webhook Polling Polling 实时性 实时性 即时推送 即时推送 有延迟（取决于轮询间隔） 有延迟（取决于轮询间隔） 资源消耗 资源消耗 低（被动接收） 低（被动接收） 高（持续请求） 高（持续请求） 网络要求 网络要求 需要公网 HTTPS 地址 需要公网 HTTPS 地址 不需要公网地址 不需要公网地址 适用场景 适用场景 生产环境 生产环境 开发/测试环境 开发/测试环境 ⠀ 2.4 高级配置 ⠀ ⠀ v2026.5.22 起，Telegram 多 topic / group 场景要额外确认默认 topic 行为。团队群里建议记录： ⠀ • 哪些 topic 默认允许触发 Agent。 • 哪些 topic 只允许人工 ack。 • ack reaction 是否会被当作状态反馈。 • 群组 ID、topic ID 和权限 owner 存在哪里。 ⠀ 2.5 常见问题 ⠀ Bot 收不到消息？ • 检查 Token 是否正确 • Webhook 模式：确认 HTTPS 证书有效，URL 可访问 • Polling 模式：确认没有其他程序在使用同一个 Token • 群组中：确认 Bot 已被添加到群组，且 Privacy Mode 已关闭（/setprivacy → Disable） 3. WhatsApp 接入 ⠀ 📋 开始之前你需要： 一部安装了 WhatsApp 的手机、手机和电脑在同一网络环境下 📋 开始之前你需要： 一部安装了 WhatsApp 的手机、手机和电脑在同一网络环境下 ⠀ OpenClaw 使用 Baileys（非官方的 WhatsApp 连接库，通过扫码登录）（包名：@whiskeysockets/baileys）接入 WhatsApp，通过扫码链接设备，无需 Meta Cloud API。 ⠀ 3.1 链接 WhatsApp 设备 ⠀ 接入非常简单，只需一步扫码： ⠀ ⠀ 执行后终端会显示一个二维码，用手机 WhatsApp 扫码即可完成链接（类似 WhatsApp Web 的登录方式）。 ⠀ 凭证会自动存储在 /.openclaw/credentials 目录中。 ⠀ 3.2 配置 OpenClaw ⠀ 在 /.openclaw/openclaw.json 中配置 WhatsApp： ⠀ ⠀ 3.3 DM 安全策略 ⠀ WhatsApp 支持 DM Pairing 安全机制（详见第 12 节），可以防止未知用户直接与 Bot 对话。 ⠀ 3.4 常见问题 ⠀ 扫码后连接不上？ • 确保手机 WhatsApp 版本是最新的 • 确保手机和运行 OpenClaw 的设备在同一网络环境下 • 如果凭证过期，删除 /.openclaw/credentials 目录后重新扫码 • v2026.5.22 后，如果遇到 QR 登录 408 / 超时恢复，先不要反复删配置；等当前登录流程退出，再重新执行 openclaw channels login whatsapp。仍失败时再清理对应 WhatsApp credential，而不是清空所有平台凭证。 ⠀ 收不到某些人的消息？ • 检查 allowFrom 配置是否包含了对方的号码 • 如果需要接收所有人的消息，设置 allowFrom: [" "] ⠀ 注意：Baileys 是非官方库，WhatsApp 可能会对自动化使用进行限制。建议仅用于个人或小规模场景。 注意：Baileys 是非官方库，WhatsApp 可能会对自动化使用进行限制。建议仅用于个人或小规模场景。 4. Discord 接入 ⠀ 📋 开始之前你需要： 一个 Discord 账号、一个你有管理权限的 Discord 服务器 📋 开始之前你需要： 一个 Discord 账号、一个你有管理权限的 Discord 服务器 ⠀ v2026.5.22 语音更新：Discord voice 会话可以跟随配置的 Discord 用户进入语音频道，并保留 DAVE recovery；realtime voice session 默认会带有限的 IDENTITY.md、USER.md、SOUL.md profile context，可通过 voice.realtime.bootstrapContextFiles: [] 关闭。Meeting Notes 外部插件也首先支持 Discord voice 作为 live source。 v2026.5.22 语音更新：Discord voice 会话可以跟随配置的 Discord 用户进入语音频道，并保留 DAVE recovery；realtime voice session 默认会带有限的 IDENTITY.md、USER.md、SOUL.md profile context，可通过 voice.realtime.bootstrapContextFiles: [] 关闭。Meeting Notes 外部插件也首先支持 Discord voice 作为 live source。 ⠀ 4.1 创建 Discord Application ⠀ 1. 访问 Discord Developer Portal Discord Developer Portal 2. 点击 "New Application"，输入名称 3. 进入 Bot 页面，点击 "Add Bot" 4. 复制 Bot Token 5. 开启 "Message Content Intent"（重要！） ⠀ 4.2 邀请 Bot 到服务器 ⠀ 生成邀请链接： ⠀ ⠀ 权限说明： • Send Messages：发送消息 • Read Message History：读取历史消息 • Use Slash Commands：使用斜杠命令 • Attach Files：发送文件 • Embed Links：发送嵌入消息 ⠀ 4.3 配置 OpenClaw ⠀ 在 /.openclaw/openclaw.json 中配置 Discord： ⠀ ⠀ 4.4 Slash Commands ⠀ OpenClaw 会在连接时自动注册 Slash Commands（需要 commands.native: true）。 ⠀ 4.5 常见问题 ⠀ Bot 在线但不回复？ • 确认 "Message Content Intent" 已开启 • 确认 Bot 有对应频道的读写权限 • 在群组配置中，确认是否需要 @bot 才触发回复 ⠀ 4.6 Meeting Notes 外部插件 ⠀ v2026.5.22 开始，Meeting Notes 外部插件首先支持 Discord voice 作为 live source。它适合会议纪要、访谈记录和语音复盘，不等同于普通 Discord 文本 Bot。 ⠀ 使用前先确认三件事： ⠀ 1. Discord voice follow 已按官方文档配置。 2. live source 所在频道有明确授权，避免无意记录私人语音。 3. 纪要输出是只读生成，提交到文档、PR 或消息平台前仍需要人工确认。 5. Slack 接入 ⠀ 📋 开始之前你需要： 一个 Slack 工作区的管理员权限、能访问 Slack API 的浏览器 Slack API 📋 开始之前你需要： 一个 Slack 工作区的管理员权限、能访问 Slack API 的浏览器 Slack API ⠀ v2026.5.22 状态反馈：Slack ack reaction 相关说明已补进官方通道文档。团队接入时要约定哪些 reaction 表示“已处理 / 需要人工 / 拒绝”，避免把普通表情误当作流程状态。 v2026.5.22 状态反馈：Slack ack reaction 相关说明已补进官方通道文档。团队接入时要约定哪些 reaction 表示“已处理 / 需要人工 / 拒绝”，避免把普通表情误当作流程状态。 ⠀ 5.1 创建 Slack App ⠀ 1. 访问 Slack API Slack API 2. 点击 "Create New App" → "From scratch" 3. 输入 App 名称，选择 Workspace ⠀ 5.2 配置权限 ⠀ 在 "OAuth & Permissions" 中添加以下 Bot Token Scopes： ⠀ • chat:write 发送消息 • channels:history 读取公共频道消息 • groups:history 读取私有频道消息 • im:history 读取私聊消息 • app mentions:read 读取 @提及 • files:read 读取文件 • files:write 上传文件 ⠀ 5.3 配置 Event Subscriptions ⠀ 1. 在 "Event Subscriptions" 中开启 Events 2. 设置 Request URL：https://your domain.com/webhook/slack 3. 订阅以下 Bot Events： ◦ message.channels 公共频道消息 ◦ message.groups 私有频道消息 ◦ message.im 私聊消息 ◦ app mention @提及 ◦ message.channels 公共频道消息 ◦ message.groups 私有频道消息 ◦ message.im 私聊消息 ◦ app mention @提及 ⠀ 5.4 配置 OpenClaw ⠀ 在 /.openclaw/openclaw.json 中配置 Slack： ⠀ ⠀ 也可以通过环境变量设置： ⠀ ⠀ 5.5 Socket Mode vs Events API ⠀ 特性 Socket Mode Events API 网络要求 不需要公网地址 需要公网 HTTPS 实时性 WebSocket 实时 HTTP 推送 适用场景 开发/内部工具 生产环境 配置复杂度 简单 需要配置 Webhook 特性 特性 Socket Mode Socket Mode Events API Events API 网络要求 网络要求 不需要公网地址 不需要公网地址 需要公网 HTTPS 需要公网 HTTPS 实时性 实时性 WebSocket 实时 WebSocket 实时 HTTP 推送 HTTP 推送 适用场景 适用场景 开发/内部工具 开发/内部工具 生产环境 生产环境 配置复杂度 配置复杂度 简单 简单 需要配置 Webhook 需要配置 W