prev:
  text: '第3章 初始配置向导'
  link: '/cn/adopt/chapter3'
next:
  text: '第5章 模型管理'
  link: '/cn/adopt/chapter5'​

第四章 聊天平台接入

接完这章，你就能在手机上跟龙虾对话了。

AutoClaw 用户：飞书扫码即完成接入，可跳过本章。

0. 支持哪些聊天平台？

OpenClaw 支持几乎所有主流聊天软件，文字消息全渠道可用。

本章以飞书为例——国内办公场景首选，深度集成文档、日历、多维表格，Telegram 配置更简单但国内需代理。

1. 前置准备

• 已完成 第二章 的安装（openclaw status 显示正常）
• 拥有飞书账号（个人账号即可，无需企业管理员权限）

2. 创建飞书应用

第一步：登录飞书开放平台

访问 飞书开放平台，使用飞书账号登录。

第二步：创建企业自建应用

点击"创建企业自建应用"，填写名称（如"OpenClaw 助理"）和描述，点击"创建"。

第三步：获取应用凭证

进入"凭证与基础信息"，复制 App ID（格式 cli_xxx）和 App Secret，妥善保存。

第四步：启用机器人能力

进入"添加应用能力" → "机器人"，点击"添加"。

必须先做这步：否则下一步导入权限时，消息相关权限无法开通。

第五步：配置权限

进入"权限管理"，点击"批量导入"，粘贴下方 JSON：

{
  "scopes": {
    "tenant": [
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:read",
      "cardkit:card:write",
      "contact:contact.base:readonly",
      "contact:user.employee_id:readonly",
      "docs:document.content:read",
      "docx:document:readonly",
      "event:ip_list",
      "im:chat",
      "im:chat.members:bot_access",
      "im:chat:read",
      "im:chat:update",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message.pins:read",
      "im:message.pins:write_only",
      "im:message.reactions:read",
      "im:message.reactions:write_only",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "base:app:copy",
      "base:app:create",
      "base:app:read",
      "base:app:update",
      "base:field:create",
      "base:field:delete",
      "base:field:read",
      "base:field:update",
      "base:record:create",
      "base:record:delete",
      "base:record:retrieve",
      "base:record:update",
      "base:table:create",
      "base:table:delete",
      "base:table:read",
      "base:table:update",
      "base:view:read",
      "base:view:write_only",
      "board:whiteboard:node:create",
      "board:whiteboard:node:read",
      "calendar:calendar.event:create",
      "calendar:calendar.event:delete",
      "calendar:calendar.event:read",
      "calendar:calendar.event:reply",
      "calendar:calendar.event:update",
      "calendar:calendar.free_busy:read",
      "calendar:calendar:read",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user.employee_id:readonly",
      "contact:user:search",
      "docs:document.comment:create",
      "docs:document.comment:read",
      "docs:document.comment:update",
      "docs:document.media:download",
      "docs:document:copy",
      "docx:document:create",
      "docx:document:readonly",
      "docx:document:write_only",
      "drive:drive.metadata:readonly",
      "drive:file:download",
      "drive:file:upload",
      "im:chat.members:read",
      "im:chat:read",
      "im:message",
      "im:message.group_msg:get_as_user",
      "im:message.p2p_msg:get_as_user",
      "im:message:readonly",
      "offline_access",
      "search:docs:read",
      "search:message",
      "space:document:delete",
      "space:document:move",
      "space:document:retrieve",
      "task:comment:read",
      "task:comment:write",
      "task:task:read",
      "task:task:write",
      "task:task:writeonly",
      "task:tasklist:read",
      "task:tasklist:write",
      "wiki:node:copy",
      "wiki:node:create",
      "wiki:node:move",
      "wiki:node:read",
      "wiki:node:retrieve",
      "wiki:space:read",
      "wiki:space:retrieve",
      "wiki:space:write_only"
    ]
  }
}
​

这一包权限涵盖消息收发、云文档、多维表格、日历、任务等完整能力。

导入后点击"申请开通"确认。企业管理员可直接通过，否则需联系管理员审核。

第六步：发布应用

进入"版本管理与发布"，点击"创建版本"，填写版本号后提交发布申请。管理员审批通过即生效（你本人是管理员可直接通过）。

3. 在 OpenClaw 中添加飞书渠道

回到终端，运行：

openclaw channels add
​

选择"Feishu/Lark"，输入 App ID 和 App Secret，其余保持默认。添加后重启网关：

openclaw gateway restart
openclaw gateway status
​

确认输出中 feishu 渠道状态为 connected。

openclaw channels add --channel feishu --token "cli_xxx:你的App Secret"
openclaw gateway restart
​

3.5 配置事件订阅

此步必须在上一步（添加渠道 + 启动网关）之后进行。飞书在保存长连接配置时会实时检测 WebSocket 连接——如果 OpenClaw 网关未运行，飞书会报"未检测到应用连接信息"错误，无法保存。

回到飞书开放平台，进入"事件与回调" → "事件配置"：

1. 选择"使用长连接接收事件"
2. 添加事件：im.message.receive_v1

4. 配对与首次对话

在飞书中找到你的机器人，发送"你好"。机器人会回复一个 8 位配对码：

在终端批准：

openclaw pairing approve feishu <配对码>
​

例如：openclaw pairing approve feishu 6KKG7C7K。也可在 Web 控制面板（openclaw dashboard）中点击批准。

配对成功后，飞书里的龙虾就能回你了。试试：

你好，请介绍一下你自己
​

5. 群聊中使用

把机器人拉进飞书群，@机器人 触发回复。

# 允许所有群聊
openclaw config set channels.feishu.groupPolicy "open"

# 设置某个群不需要@就回复
openclaw config set channels.feishu.groups.<群ID>.requireMention false
​

6. 常见问题

事件订阅保存失败？

先确认网关已运行（openclaw gateway status）。长连接模式要求网关在线才能注册。

机器人没有回复？

按顺序排查：

1. openclaw status — 网关是否运行
2. openclaw pairing list feishu — 是否已完成配对
3. openclaw logs --follow — 查看实时日志定位错误
4. openclaw gateway restart — 重启重试

权限审核不通过？

你本人是管理员的话，进入飞书管理后台 → "工作台" → "应用审核"，找到应用点击"通过"。

配置修改后不生效？

openclaw gateway restart。更多配置项见附录 G。

群聊 @了机器人没反应？

检查 groupPolicy 是否为 "disabled" 或 "allowlist"（后者需将群 ID 加入白名单）。