OpenClaw 接入飞书配置教程

1. 打开 OpenClaw 官网：https://openclaw.ai/
2. 下滑找到'Quick Start'，获取安装指令。
3. 打开'终端'输入以下指令：

   npm i -g openclaw 
   

   如果出现 'error' 报错，尝试强制执行：

   sudo npm i -g openclaw 
   

   输入密码时屏幕无显示属正常现象，盲打完密码后按回车。
4. 验证安装成功：

   openclaw --version 
   

   若看到版本号，说明安装完成。

Step 2｜接入飞书

1. 创建飞书机器人并开启权限

后续会提供一键创建机器人的能力，敬请期待。

2. 创建企业自建应用

1. 登录开发者后台：开发者后台 - 飞书开放平台，创建企业自建应用。
2. 填写信息：
   • 应用名称：自定义
   • 应用描述：简单描述用途
   • 应用图标：暂时可不传
3. 点击'创建'按钮，跳转至应用详情页。

3. 添加应用能力

在能力列表中找到'机器人'能力卡片，点击'添加'。

4. 批量导入应用权限

1. 在应用详情页左侧目录树，找到 权限管理 > 批量导入/导出权限。
2. 清空输入框内容，复制下方代码块完整粘贴，点击'确定新增权限'：

   {"scopes":{"tenant":["contact:contact.base:readonly","docx:document:readonly","im:chat:read","im:chat:update","im:message.group_at_msg:readonly","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","application:application:self_manage","cardkit:card:write","cardkit:card:read"],"user":["contact:user.employee_id:readonly","offline_access","base:app:copy","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","base:app:create","base:app:update","base:app:read","board:whiteboard:node:create","board:whiteboard:node:read","calendar:calendar: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","contact:contact.base:readonly","contact:user.base: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","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"]}}
   

5. 获取应用凭证

1. 在应用详情页左侧目录，找到'凭证与基础信息'。
2. 复制并妥善保存以下两项信息：
   • App ID：格式如 cli_xxxxxxxxxxxx
   • App Secret：一串长字符串，不可泄露。

6. 安装飞书官方插件

依次在终端中执行以下命令：

npm config set registry https://registry.npmjs.org 
curl -o /tmp/feishu-openclaw-plugin-onboard-cli.tgz https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/90600c5361ebe210fdae13020544bdc7_GmKPCTpnyF.tgz 
npm install /tmp/feishu-openclaw-plugin-onboard-cli.tgz -g 

若出现 'error' 报错，尝试强制执行：

sudo npm install /tmp/feishu-openclaw-plugin-onboard-cli.tgz -g 
rm /tmp/feishu-openclaw-plugin-onboard-cli.tgz 
feishu-plugin-onboard install 

输入完所有指令后，需填写刚才获取的飞书机器人 APP ID 和 APP Secret。

遇到问题怎么办？

运行诊断指令：

feishu-plugin-onboard doctor 

尝试自动修复：

feishu-plugin-onboard doctor --fix 

配置完成后，启动 OpenClaw

openclaw gateway run --allow-unconfigured 

注意：此指令运行后，终端页面不能关闭。后续指令需新建终端页面运行（快捷键：Command + T）。

验证安装成功：

1. 运行上述代码后，若看到服务启动日志，说明插件开始运行。
2. 运行以下指令检查插件状态：

   openclaw plugins list 
   

   ID 为 feishu-openclaw-plugin 的 Status 为 'loaded'，即表示已成功启用。

订阅机器人长链接

1. 进入 飞书开放平台，找到刚创建的应用，配置'事件与回调'。
2. 进入 事件配置 > 订阅方式 > 使用长链接接受事件 > 保存。
3. 添加'接收消息'事件。
4. 进行'回调配置'，搜索并添加'卡片回传交互'，点'确认添加'。

7. 发布应用

应用必须发布后才能在飞书中使用。

1. 点击上方'创建版本'。
2. 填写版本号（如 1.0.0）和版本描述。
3. 点击'确定'创建版本，成功后点击版本右侧的'发布'按钮，等待管理员审批。

Step 3｜飞书初始化配置

1. 配置 AI 大模型

推荐大模型：火山引擎、MinMax 或其他模型厂商。先获取 API Key，然后运行指令：

openclaw config 

按照提示选择：Local > Model > 选择模型厂商 > Paste API key now > 输入「API key」。

2. 运行 OpenClaw Gateway

打开'终端'依次输入以下指令：

openclaw gateway install 
openclaw gateway start 
openclaw gateway status 

出现绿色 'loaded' 即为安装成功。

3. 打开飞书机器人

'开发者小助手'会将审批通过的应用推送到你的消息界面，点击'打开应用'。

4. 配对绑定

在飞书中向机器人发送任意消息，系统会生成一个配对码（有效期 5 分钟）。 打开'终端'执行以下命令完成绑定：

openclaw pairing approve feishu <配对码> --notify 

如果未收到授权申请，可在聊天框输入 /feishu auth。

至此，已完成飞书内安装 OpenClaw 的全部配置。试试跟它说：'你好！'吧～

常用指令

推荐应用场景

OpenClaw 能将你从重复性、低价值的劳动中解放出来。通过自然语言指令就能完成日常办公任务，实现远程控制与自动化执行。

核心功能

• 智能早报生成：自动抓取天气、日历事件、新闻热点和未读邮件摘要，通过飞书消息同步给你。
• 邮件与日程管理：读取收件箱，提取会议/任务信息生成飞书日程，异常邮件实时推送。
• 文件智能整理：按规则扫描本地文件与云文档，自动分类、归档并生成目录索引，还能提供知识问答。
• 跨端远程办公：在手机飞书发送指令，由部署在电脑或服务器的 OpenClaw 执行复杂任务。

实际效果

• 时间节省：日均处理邮件超 50 封，日程创建效率提升 80%。
• 错误率降低：文件整理错误率从 17% 降至 0%。
• 重复劳动减少：每日固定流程耗时减少 73%。
• 响应速度：远程任务执行，突破时空限制，指令即结果。

团队协作场景：构建多 Agent AI 助理团队

OpenClaw 的多 Agent 架构支持搭建专业化分工的 AI 团队，搭配云文档、多维表格等功能，让 AI 们在飞书群中实现高效协作。

常见问题清单

1. 常见终端指令

2. OpenClaw 消耗贵吗？

目前火山方舟 Coding Plan 已经支持了 OpenClaw，Lite 套餐首月订阅价格优惠，限频不限量，基本可以实现 tokens 自由。消耗情况取决于用法，丰俭由人。

3. 插件安装完运行后，报 cannot find module xxx

原因是系统没有安装插件的依赖（可能是安装被中断或权限问题）。 解决方法：进入插件安装目录，运行 npm install。

4. 如果想要切换到流式输出怎么配置

切换到流式输出：

openclaw config set channels.feishu.streaming true 

不用流式输出：

openclaw config set channels.feishu.streaming false 

流式输出卡片上支持显示更多内容：

openclaw config set channels.feishu.footer.elapsed true // 开启耗时
openclaw config set channels.feishu.footer.status true // 开启状态展示 

5. 如何修改飞书机器人在群内的回复方式

# 查看当前配置
openclaw config get channels.feishu 
# 设置需要 @ 才回复
openclaw config set channels.feishu.requireMention true--json
# 设置不需要 @ 也回复
openclaw config set channels.feishu.requireMention open--json
# 给特定群设置规则
openclaw config set channels.feishu.groups.群 ID.requireMention true--json
# 重启 Gateway 生效
sh /workspace/projects/scripts/restart.sh 

模式 1：只有 @机器人 才回复（最常用）

配置方法

openclaw config set channels.feishu.requireMention true--json
sh /workspace/projects/scripts/restart.sh 

完整配置示例

{"channels":{"feishu":{"enabled":true,"appId":"cli_你的 AppID","appSecret":"你的 AppSecret","requireMention":true,"groupPolicy":"open"}}}

模式 2：不用 @，所有消息都回复

配置方法

openclaw config set channels.feishu.requireMention false--json
sh /workspace/projects/scripts/restart.sh 

完整配置示例

{"channels":{"feishu":{"enabled":true,"appId":"cli_你的 AppID","appSecret":"你的 AppSecret","requireMention":"open","groupPolicy":"open"}}}

注意：这个模式在大群里容易刷屏，谨慎使用！

模式 3：只有指定群 @机器人 才回复（高级）

效果

• 大部分群：不用 @ 也能回复（或者完全不回复）
• 特定群：必须 @ 才回复
• 适合：不同群不同规则，比如工作群严格一点，闲聊群随意一点

配置方法 第一步：获取群 ID。让 Bot 加入群后，发送任意消息，然后在日志里找群 ID。 第二步：配置特定群规则。

# 先设置默认所有群都不需要 @
openclaw config set channels.feishu.requireMention open--json
# 然后给特定群设置需要 @（这里群 ID 只是示例，你要替换成真实的）
openclaw config set channels.feishu.groups.oc_xxxxxxxx.requireMention true--json
# 重启生效
sh /workspace/projects/scripts/restart.sh 

完整配置示例

{"channels":{"feishu":{"enabled":true,"appId":"cli_你的 AppID","appSecret":"你的 AppSecret","requireMention":"open","groupPolicy":"open","groups":{"oc_532044075a61d112f04fa63109c75e9b":{"requireMention":true},"oc_另一个群 ID":{"requireMention":true}}}}}