11. 连接聊天渠道（下）：飞书与国内平台

本节目标：掌握国内渠道接入的通用要点，看清飞书怎么接；理解企业微信、钉钉、QQ 同属”建应用拿凭证”思路；并学会用 Channel docking（渠道对接）做会话呼叫转移。企业微信、钉钉属非官方一等渠道、本教程不展开，QQ 走官方插件。

国内渠道长什么样

上一章讲了 Telegram、Discord。国内用户更常用的是飞书；企业微信、钉钉属非官方一等渠道、需自行接入，QQ 则有官方插件支持。本章以飞书为例把国内渠道的接入套路讲透。

它们的接入思路，和海外渠道本质一样：去对应平台的开发者后台，建一个应用，拿到凭证，填进 OpenClaw 配置，再做配对/授权。

差异主要在两处：凭证形式（有的用 App ID + Secret，有的用 token），以及授权方式（有的走 OAuth 登录，有的填密钥）。

Note

本章以飞书为例把流程讲透。QQ 也走官方插件，接入思路相近（去开放平台建应用、拿凭证），但不在本章展开；企业微信、钉钉属非官方一等渠道，官方未内置，需自行接入，本教程不展开，需要时以官方文档为准。

例子：飞书

飞书的接入比填 token 更”现代化”，走的是 OAuth 登录。

最简方式：一条命令登录。 OpenClaw 提供了交互式登录：

openclaw channels login --channel feishu

命令会引导你走完授权，自动把凭证写好后保存。新手首选这条。

需要的权限。 飞书应用要能收发消息，得在后台开这些权限：

im:message：接收和读取消息。
im:message:send_as_bot：以机器人身份发消息。
contact:user.base:readonly：读取通讯录用户基础信息（用于识别是谁在说话）。

权限开少了，机器人要么收不到、要么发不出。这是飞书接不通的头号原因。

配置形态。 登录成功后，配置里大致长这样：

{
  "channels": {
    "feishu": {
      "appId": "${FEISHU_APP_ID}",
      "appSecret": "${FEISHU_APP_SECRET}",
      "dmPolicy": "pairing",
      "requireMention": true
    }
  }
}

几个要点：

dmPolicy: "pairing"：私聊先配对，防陌生人。
requireMention: true：群里要 @ 才响应。
飞书默认用 WebSocket 长连接收消息，一般不用自己搭回调服务器。

Tip

飞书支持”动态创建智能体”（dynamicAgentCreation）。简单说，群里 @ 一下就可能临时拉起一个专属助手。多群协作时很好用，但也要配好权限边界。

企业微信、钉钉、QQ 的说明

先把渠道身份说清楚，免得误导：

企业微信：OpenClaw 官方文档并未把它列为内置一等渠道，属于非官方一等渠道，需自行接入，本教程不展开；想接请以官方文档为准。
钉钉：同上，官方未内置，属非官方一等渠道，需自行接入，本教程不展开。
QQ：官方提供 qqbot 插件（@openclaw/qqbot），属于官方支持的渠道，但需先安装插件；接入同样走「建应用拿凭证」思路（去官方开放平台创建机器人，拿 App ID / App Secret）。

Warning

这些平台都要求应用有对应权限才能收发消息。后台漏开权限，是前 90% 接不通问题的根源。先核对权限，再怀疑网络。

一个实用机制：Channel docking（渠道对接）

有时候你想把对话”挪个地方”。比如正在 Telegram 跟助手聊，想换到 Discord 继续，又不想丢上下文。

OpenClaw 有个 Channel docking（渠道对接，也叫呼叫转移） 机制。它把当前会话的回复路由切到另一个渠道，会话上下文不变，历史、记忆都还在。

前提是先把两边账号”认成同一个人”。在配置里加 session.identityLinks：

{
  "session": {
    "identityLinks": {
      "alice": ["telegram:123", "discord:456"]
    }
  }
}

键值带渠道前缀（如 telegram:123），把来源和目标 peer 放进同一个组即可。

每个已加载、且支持原生命令的渠道插件会生成一个 /dock- 命令，例如 /dock-discord、/dock-telegram（Telegram 里也写作 /dock_discord）。

Note

docking 只能从私聊发起，群里不能用。它和”重新开一个会话”不同：dock 是换出口、不换大脑记忆；重新开才是真的新对话。带上下文换平台时，用 dock。

通用排查清单

国内渠道连不上，按这个顺序查：

openclaw channels status
openclaw channels logs --channel all
openclaw gateway status --deep

常见病灶：

权限没开全：回到平台后台逐项核对。
凭证错或过期：重新登录或轮换 Secret。
网络不通：服务器在国内访问海外渠道、或反过来，都可能卡。
卡在配对：执行 openclaw pairing list <渠道> 看待批请求。
登录过期：部分网页版渠道会过期，重新 channels login。

Tip

国内网络环境下，海外渠道（Telegram、Discord）常需要机器本身能访问对应服务。这不是 OpenClaw 的错，是网络层的事。先确认机器能连上，再来怪配置。

小结

国内渠道里，飞书用 OAuth 一键登录最省心。企业微信、钉钉属非官方一等渠道、需自行接入，本教程不展开；QQ 走官方插件。记住 Channel docking（渠道对接），关键时刻能带着上下文换平台接着聊。