OpenClaw 接入飞书配置指南

安装 Homebrew 和 Git

1. 下载并运行 Homebrew 安装包
2. 安装 Git：Homebrew 装完后，打开 Git 官网，把 Homebrew 下的指令复制到'终端'运行。

   ⚠️ 注意：别复制'$'这个符号，只复制英文部分

   brew install git
   

Step 1｜安装 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｜把 OpenClaw 接入飞书

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

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

2. 创建企业自建应用

1. 登录开发者后台：开发者后台 - 飞书开放平台，创建企业自建应用
2. 在弹出的窗口中，填写以下信息：

   配置项	填写内容	说明
   应用名称	（随便写）	自定义名称
   应用描述	（随便写）	简单描述用途
   应用图标	可以暂时不传
   填完后，点'创建'按钮，会自动跳转到应用详情页

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. 安装飞书官方插件

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

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

6.2 遇到问题怎么办？

运行下面这段指令：

feishu-plugin-onboard doctor 

可以查看问题，自主修复。 运行 fix 尝试自动修复，出现'All checks passed'就可以进入下一步了。如果输入一次不行就输入两次！

feishu-plugin-onboard doctor --fix 

6.3 配置完成后，启动 OpenClaw

openclaw gateway run --allow-unconfigured 

⚠️ 注意：这个指令运行后，终端页面不能关！ 后续所有指令都需要新建终端页面运行（快捷键：Command + T 创建新终端窗口）

怎么验证安装成功？

1. 运行上面的代码后，如果出现日志，说明插件已经开始运行了
2. 运行下面这段指令：

   openclaw plugins list 
   

   ID 为 feishu-openclaw-plugin 的 Status 为 'loaded'，ID 为 feishu 的 Status 为 'disabled'，就说明已成功启用飞书官方插件

6.4 订阅机器人长链接，接收事件和卡片回调

这一步的作用是让 OpenClaw 能在飞书内收发消息

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

7. 发布应用

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

1. 点上方'创建版本'
2. 在弹出的窗口中：
   • 填写版本号（如：1.0.0）
   • 填写版本描述（如：首次发布，集成 OpenClaw）
3. 点'确定'创建版本
4. 创建成功后，点版本右侧的'发布'按钮
5. 等待管理员审批就行

🎉 到这里，你已经离成功只差一步了！

Step 3｜在飞书中完成 OpenClaw 初始化配置

1. 配置 OpenClaw 的 AI 大模型

这一步是给你的龙虾 🦞 装上大脑，选一个 AI 大模型接入。 推荐大模型：

• MinMax：https://minimaxi.com/news/minimax-m2
• 其他模型可前往产品官网获取

先获取 API Key，然后运行下面这段指令：

openclaw config 

按照以下内容选择：Local > Model > 选择你的模型厂商 > Paste API key now > 输入「API key」

2. 运行 OpenClaw Gateway

打开'终端'依次输入以下指令，检查 Gateway 是否正常：

openclaw gateway install 

openclaw gateway start 

openclaw gateway status 

出现绿色 'loaded'，就说明安装成功了

3. 找到并打开我们创建的飞书机器人

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

4. 在飞书中向机器人发送任意消息，系统会生成一个配对码

配对码有效期 5 分钟，超时需重新触发 打开'终端'执行以下命令完成绑定：

"复制到内容" --notify 

如果你收到的信息最后一行是 openclaw pairing approve feishu 8BB9EBV8，就复制这段内容，并在最后加上 --notify

输入：openclaw pairing approve feishu 8BB9EBV8 --notify

完成配对后有个授权的过程。如果没收到授权申请，就在聊天框输入 /feishu auth

🎉 到这步你已经完成了飞书内安装 OpenClaw 的全部配置，现在可以开始用了！

试试跟它说：'你好！'吧～

为了让你的 🦞 虾更好用，推荐立即在'对话框'输入以下指令

👍 飞书 X OpenClaw 推荐应用场景

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

核心功能

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

实际效果

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

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

单一通用 AI 助手在复杂协作中力不从心。OpenClaw 的多 Agent 架构支持搭建专业化分工的 AI 团队，搭配云文档、多维表格等功能，让 AI 们在飞书群中实现高效协作，就像一个真正的项目组。

⚠️ 常见问题清单

1. 常见终端指令

2. OpenClaw 消耗贵吗？

不少开发者提到 OpenClaw 调用烧 tokens 的问题。目前火山方舟 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，或者让 Bot 回复群 ID。或飞书群设置页面中有 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}}}}}