OpenClaw 完全指南（四）：配置通道（飞书）

四、配置通道（飞书）

通道是指通过什么方式来跟 OpenClaw 对话，可以接入 QQ，企业微信，飞书，钉钉等工具。通过接入的工具跟 OpenClaw 进行对话，相当于远程控制器。

创建飞书应用

登录飞书开放平台：https://open.feishu.cn/app，点击创建企业自建应用。

填写应用名称（如 “OpenClaw助手”）、应用描述，点击创建按钮。

添加机器人

进入应用管理页面，左侧导航栏中找到添加应用能力，在列表中选择机器人，点击添加。

OpenClaw 配置飞书

如果是云服务器部署的OpenClaw，只需要在图形化界面配置即可。本地部署则需要通过执行命令配置。

云服务器

云服务器部署的 OpenClaw，只需要在云服务器应用管理中添加飞书应用的 APP_ID 和 APP_SECRET 即可。

以腾讯云服务器为例，通道设置选择飞书，输入App ID和 App Secret，点击添加并应用。

本地部署

启用飞书插件

如果已经存在飞书插件，则只需要启用即可。先查看插件列表：

OpenClaw plugins list

如果没有 feishu 插件，则执行以下命令先安装飞书插件。上图所示已经安装了飞书插件，所以不需要再安装。

OpenClaw plugins install @OpenClaw/feishu

执行以下命令启用飞书插件

OpenClaw plugins enable feishu

启用插件后，再执行 OpenClaw plugins list 检查飞书状态是否变为 loaded。

添加通道

执行以下命令，开始配置飞书应用

OpenClaw channels add

选择 yes，点击回车，开始配置

选中飞书这个选项，点击回车

输入飞书应用App ID和App Secret，选择飞书域名为 feishu.cn，即国内版飞书。

群聊策略，选择 Open，机器人只有被@时进行回复。

最后选择 Finished，点击回车

配置私聊策略，选yes

私聊策略默认 pairing，表示不允许任何陌生人直接私聊你的机器人。如果一个陌生用户发来消息，机器人不会直接回复，而是会要求用户通过一个临时的“配对码”来完成身份验证，只有验证通过后才能正式使用。

• pairing：陌生用户需要通过配对码授权后才能使用。
• open：开放模式，允许所有用户直接私聊机器人。
• allowlist：白名单模式，只有在配置文件中预定义的“允许列表”里的用户才能私聊机器人，其他用户的消息会被直接忽略或拒绝。
• disabled：禁用模式，完全关闭机器人的私聊功能，无法在任何私聊中使用。

将配置好的通道账号绑定到现有的 AI 代理上，当用户通过这个飞书机器人发消息时，才能找到对应的 AI 来回复。

让飞书机器人与你默认的 main AI 代理绑定

启动 gateway

执行以下命令启动服务

OpenClaw gateway

事件配置

在飞书应用管理页，左侧导航栏找到 “事件与回调” ，在“事件配置”页签中选择 “长连接接收事件”，点击保存。

添加事件 im.message.receive_v1，表示"收到消息时通知我"。

回调配置

在回调配置中，订阅方式选择 “使用长连接接收回调”，点击保存，无需填写其他地址，配置自动生效。

权限配置

在飞书应用管理页，左侧导航栏找到权限管理。点击页面中的批量导入权限按钮，弹出权限导入窗口。

批量导入权限，使用下面的代码直接覆盖

复制以下代码，替换前面弹窗中原有的JSON内容，点击下一步，确认新增权限，继续申请开通

{

创建版本并发布

在飞书应用管理页，左侧导航栏找到 “版本管理与发布” ，点击进入页面。点击右上角的创建版本。

填写应用版本号（比如1.0.0，可以自行定义版本号）和更新说明，点击保存并确认发布。

与飞书机器人对话

完成前面的步骤之后，就可以与飞书机器人进行聊天，或者将飞书机器人添加进群聊。

以电脑版飞书为例（手机端飞书的操作类似），点击搜索框，输入应用名称，点击对应的应用。

发送消息后，如果出现权限提示，按照提示复制最后一行到终端执行即可

在终端中粘贴上一步中复制的命令行，点击回车执行命令，命令完成执行后会提示配对成功。

如果是云服务器部署的话，按照下面的图片进入终端，扫码登录后执行命令即可

接下来继续尝试与该机器人进行对话，能正常收到AI的回复。