官方网站：http://openclaw.ai/ · 本站基于官网提供更快更易部署的中文教程与 GitHub 快装方案

Star FastOpenClaw
FastOpenClaw 快速一键安装OpenClaw官方教程百科

飞书、QQ、Telegram 三合一：OpenClaw 多平台机器人配置完全教程

2026-03-02

#OpenClaw#飞书Bot#QQ机器人#Telegram Bot#多平台#教程

你在公司用飞书，和朋友用 QQ，个人事务用 Telegram。

三个平台，三种习惯，但你只有一个 AI 助手。

好消息是：OpenClaw 支持同时接入 10+ 个聊天平台。 你不需要为每个平台单独配一个 AI Bot——一个 OpenClaw 实例，同时服务所有渠道。

这篇文章教你把飞书、QQ、Telegram 三个最常用的平台全部接通。

前提条件

在开始之前，确保你已经：

  • 安装了 OpenClaw（参考我们的从零部署教程）
  • OpenClaw Gateway 正在运行（openclaw status 显示 running）
  • 配置了 AI 模型和 API Key

如果还没装，一行命令搞定：

npm install -g openclaw@latest && openclaw onboard --install-daemon

第一站：Telegram Bot（最简单，5 分钟）

Telegram 是 OpenClaw 支持最完善的渠道，也是配置最简单的。

步骤 1：创建 Bot

  1. 打开 Telegram，搜索 @BotFather
  2. 发送 /newbot
  3. 按提示输入 Bot 名字（如 我的AI助手）和用户名（如 myai_claw_bot）
  4. 复制 Bot Token（格式：123456789:ABCdefGhIjKlMnOpQrStUvWxYz）

步骤 2：获取你的用户 ID

给 @userinfobot 发任意消息，它会回复你的数字 ID（如 7235080851）。

步骤 3：配置 OpenClaw

# 方法一：命令行设置（推荐）
openclaw config set channels.telegram.botToken "你的Bot Token"
openclaw config set channels.telegram.allowedUsers '["你的用户ID"]'

# 方法二：直接编辑配置文件
nano ~/.openclaw/openclaw.json

配置文件中 Telegram 段应该长这样：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456789:ABCdefGhIjKlMnOpQrStUvWxYz",
      "dmPolicy": "allowlist",
      "allowedUsers": ["7235080851"],
      "streamMode": "partial",
      "dmHistoryLimit": 20
    }
  }
}

步骤 4：重启 Gateway 并测试

openclaw gateway restart

给你的 Bot 发消息：“你好，请做个自我介绍。”

关键配置说明

配置项说明推荐值
dmPolicy谁能私聊 Botallowlist（安全）
streamMode回复方式partial（打字机效果）
dmHistoryLimit上下文消息数20（平衡质量和成本）

群组使用

如果你想在群里用 Bot：

  1. 在 BotFather 发送 /setprivacy，选择你的 Bot，选 Disable
  2. 把 Bot 拉进群
  3. 在群里 @你的Bot 发消息
{
  "channels": {
    "telegram": {
      "groupPolicy": "allowlist",
      "allowedGroups": ["-1001234567890"],
      "groupMention": true
    }
  }
}

groupMention: true 表示在群里必须 @Bot 才会回复，避免 Bot 对每条消息都响应。

高级：主动推送通知

OpenClaw 不只是被动回复——它可以主动给你发消息：

# 在脚本或 Cron 任务中
openclaw send --channel telegram --user 你的ID "⚠️ 服务器异常告警：aieii.com 返回 503"

配合 Cron 定时任务，你可以实现：

  • 每天早上推送天气
  • 服务器异常自动告警
  • 定时推送工作日报

第二站：飞书 / Lark Bot（10 分钟）

飞书（国内版）和 Lark（国际版）的配置流程完全一致。

步骤 1：创建飞书应用

  1. 访问 飞书开放平台
  2. 点击「创建企业自建应用」
  3. 填写应用名称和描述
  4. 在「凭证与基础信息」页面，记下：
    • App ID（如 cli_a5xxxxxxxxxx）
    • App Secret（如 dxxxxxxxxxxxxxxxxxxxxxxxx）

步骤 2：配置权限

在飞书开放平台的「权限管理」中，开启以下权限：

权限说明
im:message:receive接收消息
im:message:send发送消息
im:chat:readonly读取群信息
im:resource发送文件/图片

步骤 3：启用机器人

在「应用功能」→「机器人」中，开启机器人功能。

步骤 4：配置 OpenClaw

openclaw config set channels.feishu.appId "cli_a5xxxxxxxxxx"
openclaw config set channels.feishu.appSecret "dxxxxxxxxxxxxxxxxxxxxxxxx"
openclaw config set channels.feishu.botName "我的AI助手"

或直接编辑配置文件：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_a5xxxxxxxxxx",
      "appSecret": "dxxxxxxxxxxxxxxxxxxxxxxxx",
      "botName": "我的AI助手",
      "connectionMode": "websocket",
      "dmPolicy": "pairing",
      "groupPolicy": "open",
      "groupMention": true,
      "streaming": true
    }
  }
}

步骤 5：选择连接模式

模式说明推荐场景
websocket长连接，无需公网 IP个人/小团队（推荐）
webhook飞书推送到你的服务器有公网 IP 的服务器

WebSocket 模式不需要公网 IP——你的 Mac mini 在家里的局域网就能用。

步骤 6：发布应用

回到飞书开放平台，点击「版本管理与发布」→「创建版本」→「申请发布」。

企业内部应用通常秒过审核。

步骤 7：重启 Gateway 并测试

openclaw gateway restart

在飞书中搜索你的 Bot 名字，发消息测试。

Lark（国际版）的额外配置

如果你用的是 Lark 而不是飞书，添加一行配置：

{
  "channels": {
    "feishu": {
      "domain": "lark"
    }
  }
}

飞书高级功能

流式回复（打字机效果）：

{
  "streaming": true
}

开启后，Bot 会通过飞书的交互卡片实时更新回复内容，用户能看到 AI 一段一段地"打字"。

多 Bot 实例：

如果你需要为不同团队配置不同的 Bot，支持 accounts 数组：

{
  "channels": {
    "feishu": {
      "accounts": [
        {
          "appId": "bot1_id",
          "appSecret": "bot1_secret",
          "botName": "技术部助手"
        },
        {
          "appId": "bot2_id",
          "appSecret": "bot2_secret",
          "botName": "运营部助手"
        }
      ]
    }
  }
}

第三站：QQ 机器人（15 分钟）

QQ 机器人的接入稍微复杂一些，因为需要一个中间层来桥接 QQ 协议。目前最成熟的方案是 NapCat（OneBot v11 协议）。

架构

QQ App ←→ NapCat (OneBot v11) ←WebSocket→ OpenClaw QQ 插件

步骤 1：安装 NapCat

NapCat 是一个 QQ 机器人框架，将 QQ 的消息转换为标准 OneBot v11 协议。

# 方法一：Docker（推荐）
docker run -d --name napcat \
  -p 3001:3001 \
  -e ACCOUNT=你的QQ号 \
  mlikiowa/napcat-docker:latest

# 方法二：直接安装
# 详见 https://github.com/NapNeko/NapCatQQ

启动后用手机 QQ 扫码登录。

步骤 2：配置 NapCat WebSocket

确保 NapCat 的 WebSocket 服务开启：

{
  "ws": {
    "enable": true,
    "host": "127.0.0.1",
    "port": 3001
  }
}

步骤 3：安装 OpenClaw QQ 插件

# 方法一：通过 ClawHub 安装
openclaw skill install openclaw-qq-plugin

# 方法二：npm 安装
npm install -g @creatoraris/openclaw-qq-plugin

步骤 4：配置 OpenClaw

编辑 ~/.openclaw/openclaw.json：

{
  "plugins": {
    "entries": {
      "openclaw-qq-plugin": {
        "napcatWs": "ws://127.0.0.1:3001",
        "napcatToken": "",
        "botQQ": "你的BotQQ号",
        "allowedUsers": ["好友QQ号1", "好友QQ号2"],
        "allowedGroups": ["群号1", "群号2"],
        "groupMention": true,
        "replyQuote": true
      }
    }
  }
}

步骤 5：重启并测试

openclaw gateway restart

给 Bot QQ 号发消息测试。在群里 @Bot 也应该能收到回复。

配置说明

配置项说明
napcatWsNapCat WebSocket 地址
botQQBot 使用的 QQ 号
allowedUsers允许私聊的 QQ 号列表
allowedGroups允许响应的群号列表
groupMention群里需要 @Bot 才回复
replyQuote回复时引用原消息

QQ 机器人的特殊注意事项

  1. 登录安全：QQ 可能会检测异常登录，建议用常用设备的 IP
  2. 消息限频：发送过快可能触发风控，OpenClaw 会自动控制发送频率
  3. 图片和文件：支持发送图片和文件，需要 NapCat 支持 send_image 接口
  4. 掉线重连：NapCat Docker 版本支持自动重连

三合一：同时运行三个渠道

最终的配置文件结构：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "xxx",
      "dmPolicy": "allowlist",
      "allowedUsers": ["7235080851"],
      "streamMode": "partial"
    },
    "feishu": {
      "enabled": true,
      "appId": "cli_a5xxx",
      "appSecret": "dxxx",
      "botName": "AI助手",
      "connectionMode": "websocket",
      "streaming": true
    }
  },
  "plugins": {
    "entries": {
      "openclaw-qq-plugin": {
        "napcatWs": "ws://127.0.0.1:3001",
        "botQQ": "123456789",
        "allowedUsers": ["好友QQ号"]
      }
    }
  }
}

重启 Gateway：

openclaw gateway restart

现在你可以从任何一个平台和同一个 AI 助手对话。消息处理逻辑完全共享——在 Telegram 上让它记住的东西，在飞书上问也能想起来（如果使用了记忆插件）。

捷径：让 Claude Code 帮你配置

如果你觉得手动编辑 JSON 太麻烦，打开 Claude Code 或 Codex CLI：

我要配置 OpenClaw 同时接入 Telegram、飞书和 QQ。
Telegram Bot Token 是 xxx
飞书 App ID 是 xxx，App Secret 是 xxx
NapCat 运行在 ws://127.0.0.1:3001，Bot QQ 号是 xxx

请直接编辑 ~/.openclaw/openclaw.json 配置好所有渠道，
然后重启 gateway。

AI 会自动帮你完成所有配置——读取现有配置、合并新渠道、处理格式、重启服务。你只需要提供各个平台的凭证。

安全最佳实践

多渠道接入意味着攻击面更大。请务必：

措施说明
使用 allowlist 策略只允许指定用户/群组使用 Bot
不要用 open 策略除非你确定只有信任的人能联系到 Bot
定期更换 TokenTelegram Bot Token 可通过 BotFather /revoke 重置
启用 exec 审批approvals.exec.enabled: true 防止 AI 执行危险命令
监控日志tail -f ~/.openclaw/logs/gateway.err.log 观察异常

常见问题

Q：Bot 在 Telegram 回复但飞书不回复？

检查飞书应用是否已发布。开发中的应用只有管理员能用。

Q：QQ 机器人频繁掉线？

NapCat 登录态可能过期。建议用 Docker 版本并配置自动重连。

Q：多个渠道收到的消息会冲突吗？

不会。每个渠道有独立的会话上下文。但如果使用了 LanceDB 记忆插件，长期记忆是跨渠道共享的。

Q：能不能在飞书发指令，结果推送到 Telegram？

可以。在 Cron 任务或 Skill 中指定推送渠道：

openclaw send --channel telegram --user 用户ID "来自飞书的通知：xxx"

写在最后

一个 AI 助手，三个入口。

在公司用飞书问它项目进度，回家路上用 Telegram 让它查资料，躺在床上用 QQ 让它帮你写代码——你的 AI 助手不应该被困在一个 App 里。

还没安装 OpenClaw？从这里开始：从零部署教程

想了解更多自动化玩法？看这里：进阶自动化实战