OpenClaw配置飞书教程,一句话就能让 AI 帮你干活的神器（0306最新）

OpenClaw 是什么？一句话就能让 AI 帮你干活的神器

	OpenClaw 是一款开源的个人 AI Agent 系统，装在你的电脑或服务器上，就像有了个 24 小时待命的 AI 助手。

为什么要在飞书里用 OpenClaw？

你说一句话，它就能伸出"钳子"，直接在飞书里帮你把活儿干了！

飞书刚推出了 OpenClaw 官方插件，能让你的 OpenClaw 以你的身份调用飞书的各种能力：读群聊、看文档、写文档、改文档、发消息、约日程、建多维表格……基本上你能在飞书做的事，它都能帮你做。

为什么选飞书而不是 Telegram？

• 飞书是国内平台，中文界面、中文文档、中文客服，上手快
• 国内 OpenClaw 用户大多数都接入了飞书，生态更成熟
• 飞书的开放能力比其他国内平台强，能获取更多工作上下文，玩法更多

点击加入 OpenClaw 飞书插件体验互助群

⚠️ 重要：使用前必读的安全提示

🔴 核心风险

这个插件会通过飞书接口连接你的工作数据——消息、文档、日历、联系人。AI 能读到的东西，理论上就有泄露的可能。虽然做了安全防护，但 AI 系统还不够成熟稳定，不能保证万无一失。

🔴 强烈建议：现阶段千万别用公司/企业飞书账号！请务必用个人账号体验和测试。

📌 其他风险

• AI 会"幻觉"：有时会误解你的意图，或者生成看似合理但不准确的内容
• 有些操作不可逆：比如 AI 代发的飞书消息是以你的名义发出的，发出去就收不回来了
• 应对方法：涉及发送、修改、写入等重要操作，一定要"先预览，再确认"，别让 AI 完全自动驾驶

💡 使用建议

先拿个人账号安全地"玩"起来，等后续安全隔离能力更成熟了，再考虑接入真实工作环境。

用的过程中遇到任何问题，随时反馈给我们，我们正在快速迭代中！

🎁 飞书官方专属福利

飞书开放 API 无限调用额度

为了让大家稳定地运行 🦞，飞书开放了 API 无限调用额度！

有效期至：2026 年 3 月 31 日

火山引擎 Coding Plan X 飞书专属特惠价

主流 AI 模型畅用，告别 tokens 焦虑，开通就能免费用云端部署的 ArkClaw

• Lite 套餐：首月 ￥9.9（原价 ￥40）
• Pro 套餐：首月 ￥49.9
• 飞书订阅专属活动>> szacq.cn/YbpHK/
• Arkclaw 体验中心>> szacq.cn/YwSno/

📌 选择安装方式

本地部署

• 优点：数据完全在本地，隐私性高；不用持续付云端费用
• 缺点：依赖你电脑的性能和网络；需要自己维护；操作门槛高一些
• 适合谁：个人开发者、对数据安全要求高的团队
• 操作教学：点击立即前往

云端部署

• 优点：操作简单，推荐新手。24 小时在线，不用电脑一直开着；性能稳定
• 缺点：要付服务器费用；数据存在云端
• 适合谁：团队协作、需要 7x24 小时服务的场景
• 操作教学：点击立即前往，享火山专属福利！

⚙️ 本地部署 OpenClaw 指南

前置知识｜什么是终端？

终端是什么

终端是 Mac 自带的一个程序，让你可以用文字命令直接控制电脑，而不是用鼠标点图标。在 Mac 上安装 OpenClaw 必须用到它。

怎么找到终端

	方法一：程序坞 > 启动台 > 其他 > 终端 方法二：打开程序坞搜索"终端"

怎么用终端

打开"终端" > 输入指令 > 点击"回车"确认

环境准备

安装 Node.js

1. 打开 Node.js 官网 https://nodejs.org/zh-cn

2. 下载安装包（选择 22.x LTS 版本）

3. 运行安装包

按照下面的截图一步步操作就行：

安装 Homebrew 和 Git

1. 安装 Homebrew

下载并运行安装包

2. 安装 Git

Homebrew 装完后，打开 Git 官网：https://git-scm.com/install/mac，选择你的电脑系统，把 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. 页面中会看到以下两项重要信息，务必完整复制并妥善保存：

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 大模型接入。

推荐大模型：

• 火山引擎：szacq.cn/YbpHK/，开通后按教程接入 szacq.cn/2JBQB/
• 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 套餐首月订阅 9.9 元（原价 40 元），限频不限量，基本可以实现 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}}}}}

🦞 更多优质龙虾实践文档

• 【公开】养成你人生的第一只龙虾@AI进化轮-2026V0.1
• OpenClaw 学习手册（全网首发&持续更新 ing…
• 三万·龙虾养成日记 | sanwan.ai
• https://mp.weixin.qq.com/s/QbZmug4Fi8NmY5QXJrajAA