第四章：聊天平台集成

把 AI 助手接入你最常用的聊天工具。

本章概览

在这一章中，你将学习：

如何将 OpenClaw 接入飞书（国内办公常用）
如何将 OpenClaw 接入微信（可选）
如何将 OpenClaw 接入 Telegram（最简单的入门方式）
WhatsApp、Slack、Discord 的接入概览
如何同时运行多个平台
安全最佳实践

推荐顺序

如果你是国内用户，建议按这个顺序尝试：

飞书 -- 国内办公场景最常用
微信 -- 如果你需要的话（需要额外配置）
Telegram -- 如果你有梯子，最简单
WhatsApp -- 需要更多配置步骤

4.1 飞书集成

飞书（Feishu / Lark）是国内最常用的办公聊天工具之一，接入 OpenClaw 后可以在飞书里直接和 AI 助手对话。

第一步：创建飞书应用

访问 open.feishu.cn/app-side，创建企业自建应用
填写应用名称、描述
在「凭证与基础信息」中获取 App ID 和 App Secret

第二步：配置权限

在飞书开放平台的应用管理中，添加以下权限：

im:message（发送消息）
im:message.receive_v1（接收消息）

第三步：安装并配置

bash

openclaw channels login

执行后会进入引导流程，按提示完成飞书的配置：

🐾 Channels Setup

? Select platform:
  ❯ Feishu
    WeChat
    Telegram
    WhatsApp
    ...

? Enter App ID:
  cli_xxxxxxxxxxxxxx

? Enter App Secret:
  ****************

✅ Feishu connected successfully!

群组中触发机器人

飞书群组中，机器人默认只在被 @ 时才回复。群主可以通过斜杠命令切换：

/activation always    # 所有消息都触发（慎用）
/activation mention   # 仅 @ 时触发（默认）

4.2 微信集成

微信的接入相对复杂，因为微信官方 API 限制较多。

微信接入的限制

微信官方对个人账号的 API 支持非常有限，目前主要有以下方式：

企业微信 -- 通过企业微信 API 接入，体验最完整
个人微信 -- 通过第三方方案（不稳定，有封号风险）
推荐使用飞书替代 -- 如果是办公场景，飞书体验更好

企业微信接入（推荐）

访问 work.weixin.qq.com，创建企业
在「应用管理」中创建应用，获取 AgentId、CorpId、Secret
配置企业可信 IP

bash

openclaw channels login
# 选择 WeChat，按提示填写企业微信配置

个人微信

风险提示

个人微信通过第三方方案接入，存在账号被封禁的风险。建议仅用于个人体验，生产环境请使用企业微信或其他平台。

个人微信接入通常需要配合第三方服务使用，具体方案请参考官方文档。

4.3 Telegram 集成（入门首选）

Telegram 是接入 OpenClaw 最简单的平台，因为 Telegram 的 Bot API 非常开放友好。

为什么从 Telegram 开始？

创建 Bot 最简单 -- 直接和 @BotFather 聊天就行
不需要企业账号 -- 个人账号就能用
不需要审核 -- 即时生效
免费 -- Telegram Bot API 完全免费

第一步：创建 Telegram Bot

打开 Telegram，搜索 @BotFather（这是 Telegram 官方的 Bot 管理机器人）
发送 /newbot 命令
BotFather 会问你两个问题：

BotFather: Alright, a new bot. How are we going to call it?
           Please choose a name for your bot.

你: My OpenClaw Assistant

BotFather: Good. Now let's choose a username for your bot.
           It must end in 'bot'. Like this, for example:
           TetrisBot or tetris_bot.

你: my_openclaw_bot

BotFather 会返回你的 Bot Token：

BotFather: Done! Congratulations on your new bot.
           You will find it at t.me/my_openclaw_bot.
           Use this token to access the HTTP API:
           123456789:ABCdefGHIjklMNOpqrsTUVwxyz

保管好 Bot Token

Bot Token 就像你的 Bot 的密码，谁有了这个 Token 就能控制你的 Bot。如果泄露了，立刻在 BotFather 中使用 /revoke 重新生成。

第二步：配置 OpenClaw

bash

openclaw channels login
# 选择 Telegram

或手动编辑配置文件：

json

// ~/.openclaw/channels/telegram.json
{
  "platform": "telegram",
  "bot_token": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
  "allowed_users": ["87654321"]
}

第三步：获取你的 Telegram User ID

使用 @userinfobot：

在 Telegram 中搜索 @userinfobot
发送任意消息
它会回复你的 User ID

第四步：测试

在 Telegram 中搜索你创建的 Bot（比如 @my_openclaw_bot）
点击 "Start" 开始对话
发送一条消息，比如 "你好"
等待回复

第一次回复可能比较慢

第一条消息可能需要 5-10 秒才能收到回复。后续消息通常在 2-5 秒内回复。

4.4 WhatsApp 集成

WhatsApp 的集成相对复杂，因为它需要通过 WhatsApp Business API。

前置要求

一个 Meta（Facebook）开发者账号
一个 WhatsApp Business 账号
一个用于接收 Webhook 的公网 URL

个人使用 vs 企业使用

WhatsApp Business API 主要面向企业用户，但个人也可以使用开发者测试号码。如果你只是想体验，可以先用 Telegram，效果是一样的。

第一步：创建 Meta 应用

访问 developers.facebook.com
登录或创建账号
进入 "My Apps"
点击 "Create App"，选择 "Business" 类型

第二步：添加 WhatsApp 产品

在应用面板中，点击 "Add Product"
找到 "WhatsApp" 并点击 "Set up"
获取 Phone Number ID 和 Access Token

第三步：配置 Webhook

WhatsApp 使用 Webhook 推送消息。你需要一个公网可访问的 URL。

本地开发可以使用 ngrok：

bash

npm install -g ngrok
ngrok http 18789

第四步：配置 OpenClaw

bash

openclaw channels login
# 选择 WhatsApp，按提示配置

4.5 Slack 集成

Slack 适合团队使用场景 -- 在工作群组中加入 AI 助手。

创建 Slack App

访问 api.slack.com/apps
点击 "Create New App" → "From scratch"
填写 App Name 和选择 Workspace

配置权限（OAuth Scopes）

chat:write          - 发送消息
app_mentions:read  - 读取 @提及
channels:history   - 读取频道消息历史
im:history         - 读取私聊消息历史

安装到 Workspace

获取 Bot User OAuth Token（以 xoxb- 开头），然后：

bash

openclaw channels login
# 选择 Slack，按提示配置

使用方式

# 在频道中 @提及
@openclaw 帮我总结一下今天频道里的讨论要点

# 或者直接私聊
帮我写一个会议邀请邮件

4.6 同时运行多个平台

OpenClaw 的一大优势是可以同时连接多个平台。配置好各个平台后，它们会自动并行运行。

查看已连接的平台

bash

openclaw channels list

启用/禁用平台

bash

# 禁用某个平台（不删除配置）
openclaw channels disable telegram

# 重新启用
openclaw channels enable telegram

# 完全移除
openclaw channels remove telegram

4.7 安全最佳实践

将 AI 助手接入聊天平台后，安全是必须认真对待的问题。

实践一：开启白名单

最重要的安全措施：只允许指定的用户/号码使用你的 AI 助手。

json

{
  "channels": {
    "feishu": {
      "allowFrom": ["zhangsan"]
    },
    "telegram": {
      "allowFrom": ["87654321"]
    },
    "whatsapp": {
      "allowFrom": ["+8613800138000"]
    }
  }
}

不设白名单的后果

如果你的 Bot 没有设置白名单，任何人找到你的 Bot 都可以和它对话。这意味着：

别人可以消耗你的 API 额度
别人可能看到你的 Skills 列表
如果启用了高权限 Skills，可能造成安全风险

实践二：限制 Skills 权限

不是所有 Skills 都需要在所有渠道上启用：

json

{
  "channels": {
    "feishu": {
      "allowed_skills": ["web_browse", "memo", "calendar"],
      "blocked_skills": ["shell"]
    }
  }
}

实践三：设置速率限制

防止 API 额度被意外消耗完：

json

{
  "security": {
    "rate_limit": {
      "messages_per_minute": 20,
      "messages_per_hour": 200,
      "messages_per_day": 1000
    }
  }
}

4.8 使用 ngrok 进行本地开发

如果在本地运行 OpenClaw，但需要接收 Webhook 回调，可以使用 ngrok。

bash

# 安装
npm install -g ngrok

# 启动隧道
ngrok http 18789

把 ngrok 给你的 URL 作为 Webhook 基础 URL。

ngrok 免费版限制

免费版 ngrok 每次启动会生成不同的 URL，每次重启都需要更新 Webhook 配置。

本章小结

平台	难度	推荐场景
飞书	中等	国内办公首选
微信（企业）	中等	企业微信用户
Telegram	简单	个人使用、快速体验
WhatsApp	复杂	企业用户
Slack	中等	团队协作

关键命令：

openclaw channels login -- 配对/登录渠道
openclaw channels list -- 查看已连接的平台
openclaw channels enable/disable/remove -- 管理渠道
/activation always/mention -- 群组触发模式切换

安全三原则：白名单、Skills 限制、速率限制。

下一步

平台接好了，接下来让我们看看 AI 助手能做些什么 -- 第五章：Skills 与 Tools。

第四章：聊天平台集成 ​

本章概览 ​

4.1 飞书集成 ​

第一步：创建飞书应用 ​

第二步：配置权限 ​

第三步：安装并配置 ​

群组中触发机器人 ​

4.2 微信集成 ​

企业微信接入（推荐） ​

个人微信 ​

4.3 Telegram 集成（入门首选） ​

为什么从 Telegram 开始？ ​

第一步：创建 Telegram Bot ​

第二步：配置 OpenClaw ​

第三步：获取你的 Telegram User ID ​

第四步：测试 ​

4.4 WhatsApp 集成 ​

前置要求 ​

第一步：创建 Meta 应用 ​

第二步：添加 WhatsApp 产品 ​

第三步：配置 Webhook ​

第四步：配置 OpenClaw ​

4.5 Slack 集成 ​

创建 Slack App ​

配置权限（OAuth Scopes） ​

安装到 Workspace ​

使用方式 ​

4.6 同时运行多个平台 ​

查看已连接的平台 ​

启用/禁用平台 ​

4.7 安全最佳实践 ​

实践一：开启白名单 ​

实践二：限制 Skills 权限 ​

实践三：设置速率限制 ​

4.8 使用 ngrok 进行本地开发 ​

本章小结 ​

第四章：聊天平台集成

本章概览

4.1 飞书集成

第一步：创建飞书应用

第二步：配置权限

第三步：安装并配置

群组中触发机器人

4.2 微信集成

企业微信接入（推荐）

个人微信

4.3 Telegram 集成（入门首选）

为什么从 Telegram 开始？

第一步：创建 Telegram Bot

第二步：配置 OpenClaw

第三步：获取你的 Telegram User ID

第四步：测试

4.4 WhatsApp 集成

前置要求

第一步：创建 Meta 应用

第二步：添加 WhatsApp 产品

第三步：配置 Webhook

第四步：配置 OpenClaw

4.5 Slack 集成

创建 Slack App

配置权限（OAuth Scopes）

安装到 Workspace

使用方式

4.6 同时运行多个平台

查看已连接的平台

启用/禁用平台

4.7 安全最佳实践

实践一：开启白名单

实践二：限制 Skills 权限

实践三：设置速率限制

4.8 使用 ngrok 进行本地开发

本章小结