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}"]
    }
  }
}

📚 参考资料

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

相关推荐
广州灵眸科技有限公司15 小时前
瑞芯微(EASY EAI)RV1126B openclaw部署接入飞书
linux·网络·人工智能·算法·yolo·飞书
庞轩px19 小时前
第八篇：Spring与微服务——从SpringBoot到SpringCloud的演进
spring boot·spring·微服务·nacos·gateway·sentinel
YoungHong199221 小时前
服务器部署Hermes教程 —— 从零搭建你的私人 AI 助手
飞书·claude·云服务器·deepseek·爱马仕·hermess
a752066281 天前
AI 智能体 OpenClaw 飞书插件安装配置 全程命令行实操
人工智能·飞书·openclaw部署·ai 办公自动化
星空椰1 天前
Python 使用飞书 API 获取子部门列表接口信息
python·pandas·飞书
李高杰9961 天前
Claudecode如何接入飞书呢？
飞书
li_Jiejun1 天前
小智AI支持飞书&企业微信控制
飞书·企业微信
极客老王说Agent1 天前
实在Agent跨平台表格自动化实战：钉钉表格与飞书多维表数据无缝同步
自动化·钉钉·飞书
yuezhilangniao2 天前
中国区- OpenClaw + 飞书 + DeepSeek (千问备用) 部署全流程 (含踩坑实录)-中国区命令行篇
飞书·openclaw
爱奥尼欧2 天前
MetaBot-用飞书远程操控Claude Code
飞书·claude code
热门推荐
01GitHub 镜像站点02Codex 接入 DeepSeek API 完整配置文档03CC-Switch & Claude 基于 Linux 服务器安装使用指南04【AI】2026 年具身智能模型和世界模型总结05零基础教你claude code 接入 deepseek V406Cursor 接入 DeepSeek‑V4‑Pro 完整指南（2026 实测）07codex app每次打开重连5次Reconnecting问题解决08Windows端Codex接入第三方模型（DeekSeek，BaiLian)09要裂开了！ChatGPT要手机号验证了？注册Codex要求验证电话号码怎么办？2026年登陆Codex要手机号验证的解决办法10裂开！ChatGPT 居然开始要手机号验证，附详细解决方法