在当下AI智能体快速普及的时代,OpenClaw作为一款开源、高权限的个人AI助手,凭借其强大的自动化能力、数据隐私可控以及支持多种交互方式,深受开发者与效率爱好者的青睐。尤其是在国内办公场景中,将OpenClaw接入飞书机器人,能让你直接在飞书里指挥AI完成邮件发送、日程查询、文件处理、网络搜索等任务,极大提升工作效率。
本文将详细介绍多种OpenClaw接入飞书机器人的实现方式,包括最简单的桥接工具法(10分钟上手)、官方插件法以及腾讯云Lighthouse一键部署法。无论你是新手还是有一定经验的用户,都能找到适合自己的方案。跟着一步步操作,你就能拥有一个专属的飞书AI助手。

文章导航
一、OpenClaw简介及接入飞书的优势
OpenClaw是一款可在本地或云服务器运行的AI智能体,支持多种大模型(如Moonshot、Qwen、GLM、MiniMax等),并通过技能包(Skill)扩展功能。它最大的特点是数据完全自主可控,避免了将敏感信息上传到第三方平台的风险。
接入飞书后,你可以在飞书私聊或群聊中直接与OpenClaw对话,实现:
- 日程管理、邮件收发
- 文件双向传输:图片、PDF、视频等
- 网络信息检索与整理
- 多轮对话记忆,避免重复说明需求
- 自定义自动化工作流
相比其他AI工具,OpenClaw+飞书的组合在国内办公环境中兼容性更好、延迟更低、隐私更安全。
二、准备工作:部署OpenClaw本体
所有接入方式的前提都是先拥有一个正常运行的OpenClaw实例。推荐两种部署方式:
1. 本地部署(适合开发测试)
- 从官方GitHub仓库下载最新版本
- 运行
openclaw onboard完成快速配置(选择QuickStart模式) - 配置大模型API Key(推荐国内模型:Moonshot、Qwen、通义千问等)
2. 云端部署(推荐,7×24小时在线)
最便捷的方式是使用腾讯云Lighthouse应用模板一键部署:
- 登录腾讯云Lighthouse控制台
- 新购实例或重装系统 → 选择“应用模板 → AI智能体 →OpenClaw”
- 优先选择海外地域(硅谷、新加坡等),配置2核2GB及以上
- 购买/重装完成后,登录服务器
- 执行
openclaw onboard,按提示完成模型、Hooks(建议开启Memory)等配置
部署完成后,OpenClaw本体即可正常运行,接下来就是接入飞书。

三、方法一:桥接工具法(最简单,10分钟完成)
这是目前最受欢迎的方式,通过开源桥接工具实现OpenClaw与飞书的连接,无需修改OpenClaw核心代码,配置极其简单。
步骤1:创建飞书机器人
- 打开飞书开放平台:https://open.feishu.cn
- 登录企业账号 → 点击“创建应用” → 选择“企业自建应用”
- 填写应用名称(如“OpenClaw助手”),上传图标 → 创建
- 在左侧菜单找到“机器人” → 添加机器人能力
- 点击“版本管理与发布” → 创建新版本并发布
- 在“凭据与基础信息”页面复制App ID和App Secret(后面会用到)
步骤2:下载并运行桥接工具
项目地址:https://github.com/wy51ai/openclawCNAPP
- 进入Release页面下载对应系统的可执行文件
- Windows:下载后重命名为
openclaw-bridge.exe - Mac/Linux:下载后重命名为
openclaw-bridge,并执行chmod +x openclaw-bridge - 在文件所在目录打开终端,运行启动命令(替换为自己的App ID和App Secret):
# Windows
openclaw-bridge.exe start fs_app_id=cli_xxxxxx fs_app_secret=yyyyyy
# Mac/Linux
./openclaw-bridge start fs_app_id=cli_xxxxxx fs_app_secret=yyyyyy
看到“Started”提示即表示桥接成功。
步骤3:常用管理命令
| 命令 | 功能 |
| ./openclaw-bridge start | 后台启动 |
| ./openclaw-bridge stop | 停止 |
| ./openclaw-bridge restart | 重启 |
| ./openclaw-bridge status | 查看状态 |
| ./openclaw-bridge run | 前台运行(调试用) |
步骤4:验证接入
打开飞书APP → 工作台 → 找到刚刚发布的机器人 → 进入对话 → 发送“你好”或任意指令。若OpenClaw正常回复,即接入成功。
优点:配置最简单,支持文件双向传输(部分升级版桥接工具已支持WebSocket和30MB内文件传输),适合大多数用户。
四、方法二:官方插件法(openclaw-feishu插件)
如果你的OpenClaw版本较新,可直接使用官方或社区维护的飞书插件。
步骤1:安装插件
在OpenClaw运行的服务器终端执行:
openclaw plugins install @m1heng-clawd/feishu
步骤2:重启OpenClaw
openclaw daemon restart
步骤3:创建飞书自建应用(同方法一)
步骤4:配置插件参数
openclaw config set channels.feishu.appId "cli_xxxxxx"
openclaw config set channels.feishu.appSecret "your_app_secret"
openclaw config set channels.feishu.enabled true
步骤5:权限与事件配置
在飞书开放平台为应用添加以下权限(可通过批量导入JSON):
{
"scopes": {
"tenant": [
"contact:user.base:readonly",
"im:chat",
"im:chat:read",
"im:chat:update",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message:send_as_bot",
"im:resource"
],
"user": []
}
}
事件订阅必选:
– im.message.receive_v1(接收消息)
– 其他可选:消息已读、机器人进出群等
发布版本后,即可在飞书工作台使用。
优点:深度集成,支持群聊@机器人、媒体文件上传下载。
五、方法三:Lighthouse部署+手动添加飞书Channel
适合希望全程在云服务器操作的用户。
步骤1:一键部署OpenClaw(同准备工作)
步骤2:创建飞书应用并获取凭证(同上)
步骤3:添加飞书Channel
在服务器终端执行:
openclaw channels add
按提示选择飞书,输入App ID和App Secret。
步骤4:配置权限与事件(同方法二)
步骤5:启动网关
openclaw gateway --port 18789 --verbose
或简写:
openclaw gateway
保持终端窗口开启(或使用screen/tmux后台运行)。
步骤6:验证
同前述方法,在飞书工作台对话测试。
六、三种方法的对比
| 项目 | 桥接工具法 | 官方插件法 | Lighthouse+手动Channel |
|---|---|---|---|
| 配置难度 | ★☆☆(最简单) | ★★☆ | ★★★ |
| 所需时间 | 10分钟 | 20-30分钟 | 30-60分钟 |
| 文件传输支持 | 部分升级版支持双向 | 原生支持 | 需额外配置 |
| 群聊支持 | 支持 | 支持@机器人 | 支持 |
| 是否需要服务器 | 本地/云均可 | 需要运行Moltbot实例 | 推荐云服务器 |
| 推荐人群 | 新手、快速上手 | 追求深度集成 | 喜欢完整控制流程 |
七、高级功能扩展
接入成功后,你还可以:
- 开启Memory Hook,实现多轮对话上下文记忆
- 安装网络搜索Skill,让OpenClaw能实时获取最新资讯
- 配置文件传输Skill,实现电脑↔飞书双向传文件(尤其在桥接工具升级版中表现优秀)
- 自定义技能包,实现自动填写飞书表格、批量处理文档等高级自动化

八、常见问题与排查
1、机器人无响应
- 检查App ID/Secret是否正确
- 检查事件是否订阅“接收消息”
- 检查服务器网关是否正常运行(执行status命令)
2、文件传输失败
- 确认权限包含
im:resource - 单文件不超过30MB(飞书限制)
3、消息延迟高
- 优先选择国内或靠近中国的服务器地域
- 使用WebSocket桥接版本
4、群聊无法@机器人
- 确保事件包含群聊相关订阅
- 机器人需被邀请进群
九、结语
通过上述任意一种方式,你都能轻松将OpenClaw接入飞书,拥有一个私人高权限AI助手。无论是快速上手的桥接工具,还是追求极致集成的插件方式,都能满足不同需求。
现在就动手试试吧!当你在飞书里输入一条指令,OpenClaw立即帮你处理复杂任务时,你会发现工作效率的飞跃。未来,随着社区不断完善,OpenClaw+飞书的组合将带来更多惊喜。
赶紧部署属于你的专属AI助手,提升日常办公体验!
延展阅读: