OpenClaw Channel 对接飞书：从零到一实现企业级 AI 助理

OpenClaw Channel 对接飞书：从零到一实现企业级 AI 助理

摘要：本文详细介绍如何使用 OpenClaw 框架快速搭建飞书（Feishu）机器人通道，实现企业内部的 AI 助理部署。通过配置飞书开放平台应用和 OpenClaw 的 channel 系统，你可以轻松拥有一个支持群聊、私聊、消息路由的智能助理。

一、OpenClaw 是什么？

OpenClaw 是一个多通道 AI 助理框架，支持将大语言模型能力快速对接到各种通讯平台。它的核心优势包括：

• 多通道网关：一套代码，对接多个平台（飞书、Telegram、WhatsApp 等）
• 插件化架构：通过扩展机制灵活添加新功能
• 本地优先：数据不出域，适合企业私有化部署
• Agent 路由：根据消息来源自动路由到不同的 AI 助理

二、飞书开放平台准备工作

2.1 创建企业自建应用

1. 访问 飞书开放平台
2. 登录企业管理员账号（个人一样）
3. 点击「创建应用」→ 选择「企业自建应用」
   
4. 填写应用名称（如：AI 助理）、图标、描述

2.2 获取应用凭证

创建完成后，在「凭证与基础信息」页面获取：

• App ID（如：cli_xxxx）
• App Secret（如：xxxxxxx）

⚠️注意：App Secret 仅显示一次，请妥善保存！

2.3 配置机器人能力

在「应用能力」→「机器人」中：

• 启用机器人

• 配置机器人名称和头像

• 开启「接收消息」权限、

  不清楚如何配置的可以直接用这个脚本导入权限

{"scopes":{"tenant":["cardkit:card:read","cardkit:card:write","cardkit:template:read","contact:contact.base:readonly","im:message","im:message.group_at_msg:readonly","im:message.p2p_msg:readonly","im:message:readonly","im:message:send_as_bot","im:resource"],"user":[]}}

2.4 配置事件订阅（可选）

如需接收群聊消息、添加好友等事件：

1. 进入「事件订阅」页面
2. 填写请求地址（OpenClaw Gateway 的 Webhook URL）
3. 订阅所需事件（如：im.message.receive_v1）
   
   记得先要发布 不然不会生效；
   如果出现无法添加事件的别着急 就先去配置openclaw的飞书连接再回来开通事件

三、OpenClaw 配置飞书 Channel

3.1 安装 OpenClaw

不详细介绍如何部署了可以参考之前部署文章

npminstall-gopenclaw

3.2 配置 channels

前提如果本地还未安装 飞书渠道 需要先安装后配置

3.2.1 openclaw 飞书安装过程

win + X 选择 -> 终端管理员 -> 进入cmd 窗口
1 命令行输入

openclaw channelsadd

随后会进入一个命令行交互界面，你可以使用 方向键 移动选项、空格键 选择、回车键 确认

记住选择 Feishu/Lark (飞书) (configured) 空格选中 然后回车
后面就按步骤 配置即可

3.2.2 channel配

编辑~/.openclaw/openclaw.json，添加飞书 channel 配置：

{"channels":{"feishu":{"enabled":true,"connectionMode":"websocket","domain":"feishu","accounts":{"mj_bot":{"appId":"cli_xxxx","appSecret":"yxxxxxxxxxxxx"},"default":{"groupPolicy":"open"}}}}}

配置说明：

3.3 配置 Agent 路由

OpenClaw 支持根据消息来源路由到不同的 Agent：

{"bindings":[{"agentId":"main","match":{"channel":"feishu","accountId":"mj_bot"}},{"agentId":"serv_ops","match":{"channel":"feishu","accountId":"mj_servops_bot"}}]}

这样，不同机器人收到的消息会由不同的 AI 助理处理。

四、启动服务

4.1 启动 Gateway

openclaw gateway start

Gateway 是 OpenClaw 的消息网关，负责：

• 接收飞书推送的消息
• 转发给对应的 Agent 处理
• 将回复发送回飞书

4.2 验证连接

查看 Gateway 状态：

openclaw gateway status

查看飞书 channel 日志：

openclaw channels logs--channelfeishu

打开飞书APP尝试给这机器人发一个消息

出现如上提示不要慌
继续到终端输入这段提示代码

openclaw pairing approve feishu 你的提示码

这样一番操作基本都已经开通了个人助理机器人
如果不知道哪些实用的skill 可以参考这里的skill
实用skill

五、高级配置

5.1 多机器人部署

企业可能需要多个机器人服务于不同部门。OpenClaw 支持在同一个配置中管理多个飞书应用：

"accounts":{"hr_bot":{"appId":"cli_hr_xxxxx","appSecret":"xxxxx"},"it_bot":{"appId":"cli_it_xxxxx","appSecret":"xxxxx"}}

5.2 安全加固

Token 认证

"gateway":{"auth":{"mode":"token","token":"your_secure_token_here"}}

命令权限控制

"gateway":{"nodes":{"allowCommands":["browser.*","agent-browser.*"],"denyCommands":["camera.snap","screen.record"]}}

5.3 日志与监控

OpenClaw 支持详细的日志记录：

# 查看特定 channel 的消息日志openclaw logs--filter"channel=feishu"# 查看消息处理耗时openclaw logs--filter"message.duration_ms"

六、常见问题

Q1: 消息收不到怎么办？

• 检查飞书应用是否已发布
• 验证事件订阅 URL 是否正确
• 查看 Gateway 日志确认是否有报错

Q2: 群聊中机器人不回复？

• 确认groupPolicy配置
• 检查机器人是否已添加到群聊
• 验证 Agent 是否正常响应

Q3: 如何调试消息流转？

开启详细日志：

openclaw logs--leveldebug

七、总结

通过 OpenClaw 的 channel 系统，你可以在 30 分钟内完成飞书机器人的从零部署。核心步骤：

1. ✅ 飞书开放平台创建应用
2. ✅ 配置 openclaw.json 的 channels 和 bindings
3. ✅ 启动 Gateway 服务
4. ✅ 测试消息收发

OpenClaw 的优势在于标准化和可扩展性——今天对接飞书，明天对接 Telegram，代码无需修改，只需配置 channel 即可。

参考资料：

• OpenClaw 官方文档
• 飞书开放平台
• OpenClaw GitHub

作者：小白
发布时间：2026 年 3 月 13 日
标签：OpenClaw, 飞书, AI 助理, 企业应用, Channel 对接