OpenClaw 多平台接入全指南：Telegram + Discord + 飞书 + WhatsApp，一个 Gateway 管所有

大灰狼来喽2026-03-26 9:21

OpenClaw 多平台接入全指南：Telegram + Discord + 飞书 + WhatsApp，一个 Gateway 管所有

📱 你的 OpenClaw 还只能在终端里用？本文带你把它接入 Telegram、Discord、飞书、WhatsApp 四大平台------在手机上就能远程控制你的 AI Agent，开车、通勤、躺在沙发上都能发指令

📑 文章目录

  1. [为什么要接入 IM 平台](#为什么要接入 IM 平台)
  2. [架构总览：一个 Gateway，多个频道](#架构总览：一个 Gateway，多个频道)
  3. 频道能力对比：选哪个先接入
  4. [实战一：接入 Telegram（最易上手）](#实战一：接入 Telegram（最易上手）)
  5. [实战二：接入 Discord（团队协作首选）](#实战二：接入 Discord（团队协作首选）)
  6. 实战三：接入飞书（国内企业首选）
  7. [实战四：接入 WhatsApp（最贴近生活）](#实战四：接入 WhatsApp（最贴近生活）)
  8. [多频道联合：同一个 Agent，多个入口](#多频道联合：同一个 Agent，多个入口)
  9. [多 Agent 路由：不同频道不同人格](#多 Agent 路由：不同频道不同人格)
  10. [语音交互：Voice Wake + TTS/STT](#语音交互：Voice Wake + TTS/STT)
  11. [安全加固：IM 平台特有的风险](#安全加固：IM 平台特有的风险)
  12. 常见问题排查

1. 为什么要接入 IM 平台

你的 OpenClaw 已经跑起来了------能读写文件、执行命令、搜索网页、连接 MCP 服务器。但它还困在终端里。

Telegram 集成把 OpenClaw 变成了一个移动 AI 自动化界面。不再需要从终端运行命令，你可以直接从 Telegram 与你的 AI Agent 交互。

复制代码 
终端用户的日常：

🖥️ 在电脑前 → 打开终端 → 输入命令 → 等结果
🚶 离开电脑 → Agent 就消失了
🚗 开车途中想查东西 → 没办法
🛋️ 躺沙发上想让 Agent 帮忙 → 得爬起来开电脑

接入 IM 平台后：

📱 随时随地 → 打开 Telegram/微信/飞书 → 发消息 → 秒回
🚗 开车 → 发语音 → Agent 自动转文字处理
🛋️ 沙发上 → 拍照发给 Agent → 帮你 OCR 或分析
🌍 出差 → 手机就是你的远程控制台

真正的魔力发生在你把 OpenClaw 从桌面显示器中解放出来的时候。通过将它连接到 Telegram 等消息应用，你把它变成一个 24/7 的个人 Jarvis，就住在你的口袋里。

2. 架构总览：一个 Gateway，多个频道

多频道是让 OpenClaw 感觉"无处不在"而不会变成一堆独立 Bot 的功能。你在服务器或家用机器上运行一个 OpenClaw 实例。你连接多个聊天平台。现在你可以从手机上的 WhatsApp、笔记本上的 Telegram、团队的 Discord 和工作中的 Slack 与同一个助手对话。同一个大脑，同一份记忆，同一个 Agent。

复制代码 
┌──────────────────────────────────────────────────────────┐
│                     你的消息平台                          │
│                                                          │
│  📱 Telegram    💬 Discord    🐦 飞书    📞 WhatsApp     │
│       │              │          │            │           │
│       └──────────────┼──────────┼────────────┘           │
│                      ▼                                    │
│              ┌──────────────┐                             │
│              │   Gateway    │  ← 一个进程，所有频道汇聚   │
│              │  (控制平面)   │                             │
│              └──────┬───────┘                             │
│                     │                                     │
│              ┌──────┴───────┐                             │
│              │  OpenClaw    │                             │
│              │   Agent      │  ← 执行引擎 + 记忆 + 工具   │
│              │  (大脑)      │                             │
│              └──────────────┘                             │
│                                                          │
│  同一份记忆、同一个工作空间、同一套 Skills               │
│  从 WhatsApp 开始的对话，可以在 Telegram 上继续           │
└──────────────────────────────────────────────────────────┘

多频道不意味着"我安装了三个 Bot"。它意味着一个长期运行的 Gateway 进程接收来自不同平台的消息，并将它们路由到同一个会话存储。所以如果你在 WhatsApp 上开始对话，后来在 Telegram 上继续，OpenClaw 可以保持线程，因为上下文是共享的。

3. 频道能力对比：选哪个先接入

OpenClaw 支持的多频道收件箱包括 WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、BlueBubbles (iMessage)、iMessage (legacy)、IRC、Microsoft Teams、Matrix、飞书、LINE、Mattermost、Nextcloud Talk、Nostr、Synology Chat、Tlon、Twitch、Zalo、Zalo Personal、WebChat、macOS、iOS/Android。

四大主流平台对比

维度 Telegram Discord 飞书 WhatsApp
难度 ⭐ 最简单 ⭐⭐ 简单 ⭐⭐⭐ 中等 ⭐⭐ 简单但不稳定
认证方式 BotFather Token Developer Portal Token App ID + App Secret QR 码扫描
需要公网 IP ❌ 长轮询即可 ❌ WebSocket 出站 ❌ WebSocket 长连接 ❌
群组支持 ✅ ✅ 服务器/频道 ✅ 群聊/话题 ✅
语音消息 ✅ ✅ ✅ ✅
流式回复 ✅ 部分模式 ✅ ✅ 互动卡片 ❌
稳定性 ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐ ⭐⭐⭐ 可能掉线
适用场景 个人助手 团队/社区 国内企业 日常生活
官方支持 核心内置 核心内置 内置+官方插件 核心内置

对大多数用户来说，Telegram 是最佳的第一个频道：你从 BotFather 获取一个 Bot Token 不到一分钟，粘贴到 OpenClaw 的配置或 Web UI 中，就可以开始聊天了。之后根据你的联系人或社区在哪里，添加 WhatsApp 或 Discord。

4. 实战一：接入 Telegram（最易上手）

Telegram 是最容易与 OpenClaw 集成的平台之一，这得益于其出色的 Bot API。本指南带你在几分钟内创建一个 AI 驱动的 Telegram Bot。

4.1 创建 Telegram Bot

在开始之前，确保你有：OpenClaw 已安装并配置、一个 Telegram 账号、你选择的 LLM API Key。Telegram Bot 通过官方的 BotFather 创建：打开 Telegram 搜索 @BotFather → 开始聊天 → 发送 /newbot → 按提示命名你的 Bot → 选择一个用户名（必须以 'bot' 结尾）。保存 BotFather 提供的 API Token。

复制代码 
步骤详解：

1. 打开 Telegram，搜索 @BotFather（确认有蓝色认证标记）
2. 发送 /newbot
3. 输入 Bot 名称，如 "My OpenClaw"
4. 输入用户名（必须以 bot 结尾），如 "my_openclaw_bot"
5. BotFather 返回类似：1234567890:ABCdefGHIjklMNOpqrsTUVwxyz
6. 复制这个 Token，妥善保管！

保管好你的 Token！任何拥有你 Bot Token 的人都可以控制你的 Bot。把它当成密码一样对待。

4.2 配置 OpenClaw

Telegram 不使用 openclaw channels login telegram；在配置/环境变量中配置 Token，然后启动 Gateway。

编辑 ~/.openclaw/openclaw.json：

jsonc 复制代码 
{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "1234567890:ABCdefGHIjklMNOpqrsTUVwxyz",
      "dmPolicy": "pairing",        // 新用户需要配对码
      "groupPolicy": "allowlist",    // 群组默认拒绝
      "streamMode": "partial"        // 部分流式输出
    }
  }
}

环境变量方式（更安全）：

bash 复制代码 
# 设置环境变量（仅适用于默认账户）
export TELEGRAM_BOT_TOKEN="1234567890:ABCdefGHIjklMNOpqrsTUVwxyz"

Token 解析顺序是账户感知的。实际上，配置值优先于环境变量回退，且 TELEGRAM_BOT_TOKEN 仅适用于默认账户。

4.3 启动并配对

bash 复制代码 
# 启动 Gateway
openclaw gateway start

# 查看频道状态
openclaw channels status
# 应显示：Telegram default: enabled, configured, running, mode:polling

打开 Telegram，找到你的 Bot，点击 Start。

Bot 回复类似 "OpenClaw: access not configured. Your Telegram user id: 5077021035. Pairing code: Z2EDQKMK"。这条消息说明 Telegram 连接正常，但用户还没有被授权。OpenClaw 使用配对安全系统来防止未授权用户控制自动化 Agent。

在终端中批准：

bash 复制代码 
# 列出待配对请求
openclaw pairing list telegram

# 批准特定配对码
openclaw pairing approve telegram Z2EDQKMK

# 或批准所有待处理的
openclaw pairing approve telegram

配对码在 1 小时后过期。

4.4 测试

复制代码 
💬 你（Telegram）：列出 ~/projects 目录下最大的 5 个文件

🤖 Agent：
  [调用 exec: du -sh ~/projects/* | sort -rh | head -5]
  
  📊 ~/projects 最大的 5 个文件/文件夹：
  1. node_modules --- 2.1 GB
  2. dataset.csv --- 890 MB
  3. backups/ --- 650 MB
  4. models/ --- 420 MB
  5. logs/ --- 180 MB

4.5 群组配置

添加 Bot 到你的群组，然后设置 channels.telegram.groups 和 groupPolicy 以匹配你的访问模型。

jsonc 复制代码 
{
  "channels": {
    "telegram": {
      "groupPolicy": "allowlist",
      "groups": {
        "*": {
          "requireMention": true     // 在群组中必须 @提及 Bot 才响应
        }
      },
      // 群组中允许与 Bot 交互的用户
      "groupAllowFrom": ["123456789", "987654321"]
    }
  }
}

安全边界（2026.2.25+）：群组发送者认证不继承 DM 配对存储的审批。配对仅限 DM。对于群组，设置 groupAllowFrom 或 per-group/per-topic 的 allowFrom。

4.6 长轮询 vs Webhook

如果你在配置中设置 method: "polling"，OpenClaw 会主动向 Telegram 服务器查询新消息。这绕过了 NAT 和防火墙，意味着即使在标准家庭 Wi-Fi 网络上也能完美工作。

模式 优点 缺点 适用场景
长轮询（默认） 无需公网 IP，NAT 友好 延迟稍高 家庭/个人
Webhook 低延迟，高吞吐 需要 HTTPS + 公网 URL VPS/服务器

5. 实战二：接入 Discord（团队协作首选）

Discord 是 OpenClaw 从"个人助手"变成团队共享工具的第一站。你可以把它放在一个频道里用于快速问答，或者让它帮助运维、发布或支持。关键是：Discord 很嘈杂。

5.1 创建 Discord 应用

你不需要"编写一个 Discord Bot"。你创建一个 Discord 应用，开启几个 Intent，邀请它到你的服务器，然后把 Bot Token 给 OpenClaw。之后 OpenClaw 通过 Discord 的官方 Bot API 连接，你的白名单决定它可以在哪里说话。

复制代码 
步骤：

1. 打开 Discord Developer Portal: https://discord.com/developers/applications
2. 点击 New Application → 命名如 "OpenClaw"
3. 进入 Bot 页面 → 点击 Add Bot → 确认
4. 复制 Token（点 Reset Token 生成）
5. 开启 Privileged Gateway Intents：
   ✅ Message Content Intent（必需）
   ✅ Server Members Intent（推荐）
6. OAuth2 → URL Generator → 勾选 bot scope
7. 权限勾选：View Channels, Send Messages, Read Message History,
   Embed Links, Attach Files, Add Reactions
8. 复制邀请链接 → 浏览器打开 → 选择你的服务器 → 授权

5.2 获取 ID

在 Discord 应用中，你需要启用开发者模式以便复制内部 ID。点击用户设置（头像旁的齿轮图标）→ 高级 → 开启开发者模式。右键点击服务器图标 → 复制服务器 ID。右键点击你自己的头像 → 复制用户 ID。把你的服务器 ID 和用户 ID 连同 Bot Token 一起保存。

5.3 配置 OpenClaw

jsonc 复制代码 
{
  "channels": {
    "discord": {
      "enabled": true,
      "botToken": "YOUR_DISCORD_BOT_TOKEN",
      "dmPolicy": "pairing",
      "groupPolicy": "allowlist",
      "guilds": {
        "YOUR_GUILD_ID": {
          "users": ["YOUR_USER_ID"],
          "channels": {
            "YOUR_CHANNEL_ID": {
              "allow": true,
              "requireMention": true     // 群组中需要 @提及
            }
          }
        }
      }
    }
  }
}
bash 复制代码 
# 重启 Gateway
openclaw gateway restart

# 验证
openclaw channels status

OpenClaw Gateway 在每个频道和每个服务器维护独立的对话上下文，所以服务器 A 中的对话不会泄露到服务器 B。Agent 在所有服务器使用相同的 SOUL.md 配置。如果你需要不同的行为，运行不同的 OpenClaw Agent，使用不同的 SOUL.md 和不同的 Bot Token。

5.4 防断连

Discord Bot 断连通常由三个原因引起：你的主机进入睡眠、Gateway 进程被低内存系统的 OOM killer 杀死、或者 Discord 的速率限制在过多 API 调用后触发。在 Mac 上，使用 caffeinate -i openclaw gateway start 来防止睡眠。

6. 实战三：接入飞书（国内企业首选）

这是飞书/Lark 开放平台团队开发和维护的官方 OpenClaw 飞书/Lark 插件。它无缝连接你的 OpenClaw Agent 到你的飞书/Lark 工作空间，使其能直接读写消息、文档、多维表格、日历、任务等。

6.1 安装状态

飞书已内置于当前 OpenClaw 发行版中，无需单独安装插件。如果你使用较旧的构建或不包含内置飞书的自定义安装，手动安装即可。

注意：OpenClaw 版本必须为 2026.2.26 或更高。使用 openclaw -v 检查。如果低于此版本，可能会遇到问题。

6.2 创建飞书应用

复制代码 
步骤：

1. 登录飞书开放平台: https://open.feishu.cn/
2. 创建企业自建应用
3. 记录 App ID 和 App Secret
4. 事件订阅 → 选择"使用长连接"（WebSocket）
   ⚠️ 不要选 Webhook 模式（需要公网 URL）
5. 添加事件: im.message.receive_v1
6. 权限管理 → 添加必要权限：
   - im:message:send_as_bot（发送消息）
   - im:message（接收消息）
   - 按需添加 docx、calendar、task 等权限
7. 版本管理与发布 → 发布应用

OpenClaw 通过飞书开放平台的长连接（WebSocket）模式连接，因此不需要公网 URL 或 Webhook 端点。只需创建一个飞书应用，输入你的 App ID 和 App Secret，你的助手就上线了。

6.3 配置 OpenClaw

jsonc 复制代码 
{
  "channels": {
    "feishu": {
      "enabled": true,
      "domain": "feishu",              // "feishu"（国内）或 "lark"（国际）
      "dmPolicy": "pairing",
      "groupPolicy": "allowlist",
      "streaming": true,               // 启用流式卡片输出
      "blockStreaming": true,           // 启用块级流式
      "accounts": {
        "main": {
          "appId": "cli_xxxxxxxxxx",
          "appSecret": "xxxxxxxxxxxxxxxx",
          "name": "My OpenClaw Bot"
        }
      }
    }
  }
}

6.4 群组配置

群组策略配置中，group ID（chat_id）格式为 oc_xxx。除了允许群组本身，所有该群组中的消息都由发送者 open_id 把关：只有列在 groups.<chat_id>.allowFrom 中的用户的消息才会被处理。

jsonc 复制代码 
{
  "channels": {
    "feishu": {
      "groupPolicy": "allowlist",
      "groupAllowFrom": ["oc_xxx"],
      "groups": {
        "oc_xxx": {
          "allowFrom": ["ou_user1", "ou_user2"],  // 飞书 open_id
          "requireMention": true
        }
      }
    }
  }
}

6.5 获取群组和用户 ID

要找到群聊 ID（oc_xxx），启动 Gateway，在群中 @提及 Bot，然后查看日志：openclaw logs --follow。

6.6 飞书专属功能

该插件提供全面的飞书/Lark 集成，包括：读取消息（群组/DM 历史、话题回复）、发送消息、回复消息、搜索消息、下载图片/文件。管理日历和事件（创建/查询/更新/删除/搜索）、管理参会者、检查空闲/忙碌状态。📱 互动卡片：实时状态更新（思考中/生成中/完成），加上敏感操作的确认按钮。🌊 流式回复：在消息卡片中直接实时流式输出文本。

6.7 安全警告

该插件集成了 OpenClaw AI 自动化能力，带有模型幻觉、不可预测执行和 Prompt 注入等固有风险。在你授权飞书/Lark 权限后，OpenClaw 将以你的用户身份在授权范围内行动，这可能导致敏感数据泄露或未授权操作等高风险后果。请谨慎使用。

我们建议将连接到 OpenClaw 的飞书/Lark Bot 用作私人对话助手。不要将其添加到群聊中或允许其他用户与其交互，以避免权限滥用或数据泄露。

7. 实战四：接入 WhatsApp（最贴近生活）

人们还是选择 WhatsApp。原因很明显：WhatsApp 已经每天在你手机上打开几十次了。你的 AI Agent 生活在你已经在的地方，零行为改变。

7.1 WhatsApp 的特殊性

OpenClaw 的 WhatsApp 集成基于 WhatsApp Web 协议。实际上，这意味着它使用 Baileys------一个讲 WhatsApp Web WebSocket 协议的 TypeScript 库。

这意味着：

  • ✅ 免费，不需要 WhatsApp Business API
  • ⚠️ 不是 Meta 官方自动化 API
  • ⚠️ 连接稳定性不如 Telegram/Discord

7.2 配置

bash 复制代码 
# 使用交互式登录扫描 QR 码
openclaw channels login whatsapp

在终端中会出现一个 QR 码。打开手机上的 WhatsApp → 设置 → 关联设备 → 扫描 QR 码。

jsonc 复制代码 
{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "allowFrom": ["+8613800138000"],     // 你的手机号（E.164 格式）
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

7.3 WhatsApp 掉线处理

你的手机的 WhatsApp 应用隔夜更新了------有时 WhatsApp 更新会改变会话行为，足以导致关联设备断开。打开手机上的 WhatsApp，检查关联设备，重新扫描 QR 码。

bash 复制代码 
# 重新登录
openclaw channels login whatsapp

# 检查状态
openclaw channels status

8. 多频道联合：同一个 Agent，多个入口

配好多个频道后，你的配置大致如下：

jsonc 复制代码 
{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "${TELEGRAM_BOT_TOKEN}",
      "dmPolicy": "pairing"
    },
    "discord": {
      "enabled": true,
      "botToken": "${DISCORD_BOT_TOKEN}",
      "dmPolicy": "pairing",
      "groupPolicy": "allowlist"
    },
    "feishu": {
      "enabled": true,
      "accounts": {
        "main": {
          "appId": "${FEISHU_APP_ID}",
          "appSecret": "${FEISHU_APP_SECRET}"
        }
      }
    },
    "whatsapp": {
      "enabled": true,
      "allowFrom": ["+8613800138000"]
    }
  }
}
bash 复制代码 
# 一键查看所有频道状态
openclaw channels status
# Telegram default: ✅ running (polling)
# Discord default:  ✅ running (ws)
# Feishu main:      ✅ running (ws)
# WhatsApp default: ✅ running (linked)

跨频道身份映射

重要的部分是跨平台的身份映射。你的 WhatsApp 号码、Telegram 用户 ID 和 Discord 用户 ID 是不同的标识符。如果你想要所有频道中的"一个你"，你配置绑定让 OpenClaw 知道它们代表同一个人。如果你跳过这一步，你仍然得到多频道。你只是得到多个身份。

9. 多 Agent 路由：不同频道不同人格

不同的人格（每个 Agent 的工作空间文件如 AGENTS.md 和 SOUL.md）。独立的认证和会话（除非显式启用，否则没有串扰）。这让多人共享一个 Gateway 服务器，同时保持各自的 AI "大脑"和数据隔离。

jsonc 复制代码 
{
  "agents": {
    "list": [
      {
        "id": "personal",
        "workspace": "~/.openclaw/workspace-personal"
      },
      {
        "id": "work",
        "workspace": "~/.openclaw/workspace-work"
      }
    ]
  },
  "bindings": [
    {
      "agentId": "personal",
      "match": { "channel": "telegram" }
    },
    {
      "agentId": "work",
      "match": { "channel": "feishu" }
    },
    {
      "agentId": "personal",
      "match": { "channel": "whatsapp" }
    }
  ]
}

认证档案是每 Agent 独立的。每个 Agent 从自己的路径读取：~/.openclaw/agents/<agentId>/agent/auth-profiles.json。Main Agent 的凭证不会自动共享。永远不要跨 Agent 复用 agentDir（会导致认证/会话冲突）。

10. 语音交互：Voice Wake + TTS/STT

Voice Wake + Talk Mode------macOS/iOS 上的唤醒词和 Android 上的连续语音（ElevenLabs + 系统 TTS 回退）。

10.1 语音消息（所有平台通用）

你发送一条语音备忘或音频文件。OpenClaw 转录它。然后它把转录文本当作消息体处理。这就是"语音命令"的来源，因为转录可以包含斜杠命令，表现得就像你打字输入的一样。

10.2 TTS 配置（Agent 回复语音）

jsonc 复制代码 
{
  "messages": {
    "tts": {
      "auto": "inbound",           // 只有当用户发语音时才语音回复
      "provider": "openai",
      "openai": {
        "model": "gpt-4o-mini-tts"
      },
      "maxTextLength": 4000,
      "timeoutMs": 30000
    }
  }
}

最安全的默认值是 auto: "inbound"，这样 OpenClaw 只有在用户先说话时才语音回复。这避免了嘈杂的聊天、意外的音频和不必要的成本，同时仍然让语音感觉自然。

10.3 实时对话模式（Talk Mode）

OpenClaw 的方式是配对一个处理麦克风循环的 node 设备，然后 Gateway 处理模型调用和工具。在你想要稳定性的地方运行 Gateway，在有麦克风和扬声器的设备上配对一个 node，在 node 上启用 Voice Wake 或 Talk Mode 使其能听和说。

iOS node：Canvas、Voice Wake、Talk Mode、相机、屏幕录制、Bonjour + 设备配对。Android node：连接标签（设置码/手动）、聊天会话、语音标签、Canvas、相机/屏幕录制和 Android 设备命令（通知/位置/短信/照片/联系人/日历/运动/应用更新）。

11. 安全加固：IM 平台特有的风险

如果你读过我之前的安全加固完全指南，你已经知道了基本原则。IM 平台引入了额外的攻击面。

11.1 必须做的安全配置

jsonc 复制代码 
{
  "channels": {
    // ❌ 绝对不要这样做
    // "telegram": { "dmPolicy": "open" }
    // → 任何知道你 Bot 用户名的人都能控制你的 Agent！

    // ✅ 正确做法
    "telegram": {
      "dmPolicy": "pairing",
      "groupPolicy": "allowlist"
    },
    "discord": {
      "dmPolicy": "pairing",
      "groupPolicy": "allowlist",
      "guilds": {
        "YOUR_GUILD_ID": {
          "channels": {
            "YOUR_CHANNEL_ID": {
              "allow": true,
              "requireMention": true
            }
          }
        }
      }
    }
  },
  // 会话隔离：每个用户独立上下文
  "session": {
    "dmScope": "per-channel-peer"
  }
}

11.2 群组特有风险

群聊让攻击面大幅增加。任何成员或新加入者都可以发送精心构造的 Prompt 注入。

复制代码 
群组安全黄金法则：

1. ✅ requireMention: true  --- 减少噪声和注入面
2. ✅ groupAllowFrom       --- 只允许信任的人交互
3. ✅ exec deny 或 allowlist --- 群组中绝不开放 full exec
4. ✅ sandbox               --- 群组会话始终在沙箱中运行

11.3 WhatsApp 隐私提醒

虽然 Telegram 在你手机和它服务器之间使用加密，消息在 Telegram 端会被短暂解密，然后才被你的 Bot 获取。不要通过聊天界面发送高度敏感的密码或信用卡信息。

12. 常见问题排查

问题 1：Telegram Bot 不响应

最常见的错误是从 BotFather 复制了错误的 Token。

bash 复制代码 
# 检查 Gateway 状态
openclaw gateway status

# 检查 Telegram 频道状态
openclaw channels status

# 查看实时日志
openclaw logs --follow

错误的配置位置：Telegram 是内置 CHANNEL，不是插件------把它配置在 plugins.entries.telegram 而不是 channels.telegram 下会导致 'plugin not found' 错误。

问题 2：Discord "You are not authorized"

这个 'not authorized' 消息来自 OpenClaw，不是 Discord。

频道/Guild 未白名单：默认情况下，groupPolicy: "allowlist" 阻止所有未显式配置的 guild/频道。

问题 3：飞书 Bot 无法发送消息

Bot 报告 "insufficient permissions" 尝试读取文档或发送消息时------登录飞书/Lark 开发者控制台，确保你的应用已被授予必要的 API 权限。例如，读取文档需要 docx:document:readonly 范围，发送消息需要 im:message:send_as_bot 权限。

问题 4：WhatsApp 掉线

bash 复制代码 
# 重新扫码
openclaw channels login whatsapp

# 确认没有其他 WhatsApp Web 会话在竞争
# 手机上：设置 → 关联设备 → 检查

问题 5：旧版本 Gateway 进程残留

升级后，旧的 Gateway 进程可能和新的一起运行，导致重复消息。检查并终止旧进程。

bash 复制代码 
# 检查是否有旧进程
ps aux | grep -E '(clawdbot|moltbot|openclaw).*gateway'

# 停止旧实例
clawdbot gateway stop 2>/dev/null
moltbot gateway stop 2>/dev/null

# 只保留 OpenClaw
openclaw gateway restart

问题 6：飞书国际版（Lark）配置

如果你的租户在 Lark（国际版），设置 domain 为 "lark"（或完整域名字符串）。你可以在 channels.feishu.domain 或每个账户级别（channels.feishu.accounts.<id>.domain）设置。

📋 速查卡

bash 复制代码 
# ===== Telegram =====
# 1. @BotFather → /newbot → 复制 Token
# 2. 配置 channels.telegram.botToken
# 3. openclaw gateway start
# 4. 手机 Telegram 找 Bot → Start → 配对

# ===== Discord =====
# 1. Developer Portal → New Application → Bot → 复制 Token
# 2. 开启 Message Content Intent + Server Members Intent
# 3. 生成邀请链接（bot scope + 权限）→ 邀请到服务器
# 4. 配置 channels.discord.botToken + guilds
# 5. openclaw gateway restart

# ===== 飞书 =====
# 1. 飞书开放平台 → 创建自建应用 → 记录 App ID + Secret
# 2. 事件订阅 → 长连接 → im.message.receive_v1
# 3. 权限管理 → im:message:send_as_bot 等
# 4. 发布应用
# 5. 配置 channels.feishu.accounts.main
# 6. openclaw gateway restart

# ===== WhatsApp =====
# 1. openclaw channels login whatsapp
# 2. 手机扫 QR 码
# 3. 配置 channels.whatsapp.allowFrom

# ===== 通用命令 =====
openclaw channels status              # 查看所有频道状态
openclaw channels status --probe      # 探测连通性
openclaw gateway restart              # 重启 Gateway
openclaw logs --follow                # 实时日志
openclaw doctor                       # 全局健康检查
openclaw pairing list telegram        # 查看待配对
openclaw pairing approve telegram     # 批准配对
jsonc 复制代码 
// 最小四频道配置模板
{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "${TELEGRAM_BOT_TOKEN}",
      "dmPolicy": "pairing"
    },
    "discord": {
      "enabled": true,
      "botToken": "${DISCORD_BOT_TOKEN}",
      "dmPolicy": "pairing",
      "groupPolicy": "allowlist"
    },
    "feishu": {
      "enabled": true,
      "accounts": {
        "main": {
          "appId": "${FEISHU_APP_ID}",
          "appSecret": "${FEISHU_APP_SECRET}"
        }
      }
    },
    "whatsapp": {
      "enabled": true,
      "allowFrom": ["${YOUR_PHONE_E164}"]
    }
  }
}

📚 参考资料

如果觉得有帮助，欢迎 点赞 👍 收藏 ⭐ 关注 🔔，有问题评论区见！

相关推荐
七夜zippoe4 小时前
OpenClaw 接入飞书：完整配置指南
人工智能·microsoft·飞书·配置·openclaw
IT WorryFree4 小时前
Zabbix 飞书机器人告警配置
机器人·飞书·zabbix
军哥全栈AI4 小时前
OpenClaw配置 GLM-4.7 Flash+DuckDuckGo 实现飞书机器人联网问答
飞书·openclaw
没有bug.的程序员21 小时前
S 级 SaaS 平台的物理雪崩：Spring Cloud Gateway 多租户动态路由与 UserID 极限分片
java·gateway·springboot·saas·springcloud·多租户、·userid
GY—Monkey1 天前
ubuntu （V100）中 部署openclaw，并链接飞书
linux·ubuntu·飞书
code_pgf1 天前
Jetson Orin NX 16G设备上配置AI服务自动启动的方案，包括Ollama、llama-server和OpenClaw Gateway三个组件
数据库·人工智能·安全·gateway·边缘计算·llama
码点1 天前
openclaw skill 技能
飞书
web3.08889991 天前
OpenClaw + 飞书打造 AI 电商选品系统，无缝对接三方数据服务商
人工智能·飞书
tumeng07111 天前
当遇到 502 错误（Bad Gateway）怎么办
gateway
热门推荐
01GitHub 镜像站点02Qwen3.5 开源全解析：从 0.8B 到 397B，代际升级 + 全场景选型指南03围棋-html版本04班级宠物园部署指南05小黑课堂计算机二级WPSoffice题库软件下载安装教程（2026年3月最新版）06OpenClaw 使用和管理 MCP 完全指南07UV安装并设置国内源08“wsl --install -d Ubuntu-22.04”下载慢，中国地区离线安装 Ubuntu 22.04 WSL方法（亲测2025年5月6日）09机器学习深度学习二——GAN网络10OpenClaw Control UI安全上下文访问配置