跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

OpenClaw 接入飞书配置教程

档详细介绍了 OpenClaw 接入飞书的完整配置流程。OpenClaw 是一款开源个人 AI Agent 系统，通过飞书插件可实现读群聊、写文档、约日程等自动化操作。文章首先强调了使用个人账号的安全建议，随后提供了本地与云端两种部署方式的对比。核心内容包括环境准备（Node.js、Homebrew、Git）、OpenClaw CLI 安装、飞书企业自建应用创建及权限配置、插件安装与调试、以及大模型接入与配对绑定。此外，还涵盖了流式输出配置、群组回复策略调整及常见问题排查，帮助用户实现办公自动化与多 Agent 团队协作。

MqEngine发布于 2026/4/6更新于 2026/9/172 浏览
OpenClaw 接入飞书配置教程

OpenClaw 简介

OpenClaw 是一款开源的个人 AI Agent 系统，部署在电脑或服务器上，如同一个 24 小时待命的 AI 助手。

为何选择飞书集成

通过 OpenClaw 飞书插件，你可以以个人身份调用飞书的各种能力：读取群聊、查看文档、撰写与修改文档、发送消息、预约日程、创建多维表格等。相比其他平台，飞书在国内具有中文界面和文档优势，生态更成熟，开放能力更强，能获取更多工作上下文。

安全提示

核心风险

该插件会通过飞书接口连接你的工作数据（消息、文档、日历、联系人）。AI 能读到的内容理论上存在泄露可能。虽然做了安全防护，但系统尚未完全成熟稳定。

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

其他风险

  • AI 幻觉：可能误解意图或生成不准确内容。
  • 操作不可逆：代发的消息以你的名义发出，无法撤回。
  • 应对方法：涉及发送、修改、写入等重要操作，务必'先预览，再确认'。

使用建议

先拿个人账号安全地体验，待后续安全隔离能力更成熟后，再考虑接入真实工作环境。

安装方式选择

本地部署

  • 优点：数据完全在本地，隐私性高；无需持续支付云端费用。
  • 缺点：依赖电脑性能与网络；需自行维护；操作门槛较高。
  • 适合人群：个人开发者、对数据安全要求高的团队。

云端部署

  • 优点：操作简单，推荐新手；24 小时在线；性能稳定。
  • 缺点：需支付服务器费用；数据存储在云端。
  • 适合人群：团队协作、需要 7x24 小时服务的场景。

本地部署指南

前置知识｜什么是终端？

终端是 Mac 自带的程序，允许通过文字命令直接控制电脑。在 Mac 上安装 OpenClaw 必须使用它。

如何找到终端
  1. 程序坞 > 启动台 > 其他 > 终端
  2. 打开程序坞搜索'终端'
如何使用终端

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

环境准备

安装 Node.js
  1. 访问 Node.js 官网 https://nodejs.org/zh-cn
  2. 下载安装包（建议选择 22.x LTS 版本）
  3. 运行安装包，按步骤操作即可。
安装 Homebrew 和 Git
  1. 下载并运行 Homebrew 安装包。
  2. 安装 Git：打开 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｜接入飞书

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 的全部配置。试试跟它说：'你好！'吧～

常用指令
指令名称指令代码
确认是否安装成功/feishu start
批量完成用户授权/feishu auth
切换为流式回复openclaw config set channels.feishu.streaming true
检查配置是否正常/feishu doctor

推荐应用场景

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

核心功能

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

实际效果

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

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

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

角色名称核心职责适用场景
AI 大总管总协调、任务分发、进度跟踪项目启动、跨部门需求对接
AI 资讯助理行业资讯收集、定时推送、趋势分析市场调研、竞品分析、日报生成
AI 内容助理文案创作、视频脚本、文档生成内容营销、方案撰写、会议纪要
AI 代码助理技术支持、代码审查、方案设计技术评审、BUG 排查、架构咨询
AI 任务助理任务跟踪、提醒催办、状态同步项目管理、OKR 跟进、待办提醒

常见问题清单

1. 常见终端指令

指令名称指令代码使用说明
启动 AI 网关服务openclaw gateway run必用指令，运行时需保留该终端窗口
彻底停止后台运行的网关进程openclaw gateway stop
重启网关openclaw gateway restart修改了配置文件后，必须运行此指令才能生效
启动交互式安装向导openclaw configure用于设置飞书应用的 App ID、Secret 以及选择大模型供应商
启动可视化界面openclaw dashboard包含聊天、控制、代理与技能、配置等板块
自动诊断openclaw doctor检查系统环境、依赖项和配置是否存在异常
获取运行状态openclaw health获取网关和已连接渠道的实时运行状态
打开插件列表openclaw plugins list

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}}}}}

目录

  1. OpenClaw 简介
  2. 为何选择飞书集成
  3. 安全提示
  4. 核心风险
  5. 其他风险
  6. 使用建议
  7. 安装方式选择
  8. 本地部署
  9. 云端部署
  10. 本地部署指南
  11. 前置知识｜什么是终端？
  12. 如何找到终端
  13. 如何使用终端
  14. 环境准备
  15. 安装 Node.js
  16. 安装 Homebrew 和 Git
  17. Step 1｜安装 OpenClaw
  18. Step 2｜接入飞书
  19. 1. 创建飞书机器人并开启权限
  20. 2. 创建企业自建应用
  21. 3. 添加应用能力
  22. 4. 批量导入应用权限
  23. 5. 获取应用凭证
  24. 6. 安装飞书官方插件
  25. 遇到问题怎么办？
  26. 配置完成后，启动 OpenClaw
  27. 订阅机器人长链接
  28. 7. 发布应用
  29. Step 3｜飞书初始化配置
  30. 1. 配置 AI 大模型
  31. 2. 运行 OpenClaw Gateway
  32. 3. 打开飞书机器人
  33. 4. 配对绑定
  34. 常用指令
  35. 推荐应用场景
  36. 团队协作场景：构建多 Agent AI 助理团队
  37. 常见问题清单
  38. 1. 常见终端指令
  39. 2. OpenClaw 消耗贵吗？
  40. 3. 插件安装完运行后，报 cannot find module xxx
  41. 4. 如果想要切换到流式输出怎么配置
  42. 5. 如何修改飞书机器人在群内的回复方式
  43. 查看当前配置
  44. 设置需要 @ 才回复
  45. 设置不需要 @ 也回复
  46. 给特定群设置规则
  47. 重启 Gateway 生效
  48. 模式 1：只有 @机器人 才回复（最常用）
  49. 模式 2：不用 @，所有消息都回复
  50. 模式 3：只有指定群 @机器人 才回复（高级）
  51. 先设置默认所有群都不需要 @
  52. 然后给特定群设置需要 @（这里群 ID 只是示例，你要替换成真实的）
  53. 重启生效

更多推荐文章

查看全部
  • DeepSeek-R1-Distill-Llama-70B：开源推理效率分析
  • AIGC 个性化与定制化内容生成的技术与应用
  • 秋葉 aaaki 整合包 Stable Diffusion v4.10 与 ComfyUI 下载配置指南
  • MiniMax 海螺 AI 视频：图片与文本生成高质量视频
  • C++ 搜索引擎核心：基于正倒排索引的 Searcher 实现解析
  • Python 异步编程实战：构建高性能网络应用
  • 信息安全认证解析：CISP、CISAW 区别及 CISSP 含金量对比
  • Python 的抽象基类、协议和鸭子类型
  • Nature Sensors 刊文：清华 SuperTac 仿生多模态触觉传感器突破
  • 企业管理系统前端组件化设计：为何 OA、CRM、ERP 表单不能直接用 Element UI 或 Ant Design
  • C++ 算法刷题实战：重组偶数、体操队形及二叉树路径和
  • Django Web 框架实战：从零构建产品管理系统
  • FPGA 实现多协议编码器接口：BISS-C、SSI 与多摩川集成
  • hls4ml：FPGA机器学习快速上手指南
  • 基于 Go 语言与 DeepSeek 大模型的 AIOps 监控系统构建
  • OpenClaw 消息路由机制详解
  • 高效集成 Gemini API：Zotero 学术场景 AI 辅助分析指南
  • 鸿蒙webview开发中web内部网络请求访问资源跨域问题，客户端解决方案
  • 实战 LLaMA Factory：在国产 DCU 上高效微调 Llama 3 模型
  • DDD 领域驱动设计：失血、贫血、充血与胀血模型详解及代码示例

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online

  • 随机西班牙地址生成器

    随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online