跳至主要內容

08-飞书插件精简版教程

AI悦创原创2026/3/15大约 25 分钟...约 7487 字
欢迎赞助·服务器费用时不时欠费停机～
欢迎赞助·服务器费用时不时欠费停机～

你好，我是悦创。

飞书官方插件教程略乱，不适合新手小白。其次，本身没有什么太多更新，小白看了容易有焦虑。目前官网没怎么回复，不知道热度过后是否还会维护。【敬请期待！】

注意

飞书官方流量趁的挺快，但是插件很多 bug 没有修理🔧，很多反馈没有回复～

老规矩：小白、新手、bug 不会的，直接找我付费操作：150¥

飞书官方插件名称，改来改去。挺废物的，而且会额外的消耗 Token。如果飞书文档、知识库不是你所需要的，你可以考虑对接其它通讯平台即可。

ChangeLog

  • 崩塌

官方教程中，有什么飞书插件反馈、体验群，建议不用加入。都是口水群，飞书官方也没有针对性用户进行反馈回复！只是多了几条未读消息（上百条以上）！

1. 安装飞书插件

新版命令
npx -y @larksuite/openclaw-lark install

执行过程中，可选择 新建机器人 或 关联已有机器人。

1.1 关联已有机器人

选择关联已有机器人时，若提示无效的 App ID 或 App Secret，可手动输入正确的应用凭证信息。

这个部分不会的话，查看教程：🦞立省 500！30 分钟把 OpenClaw 本地部署并在飞书上配到可用 中飞书机器人创建部分。

1.2 创建新机器人

若选择新建机器人，可通过飞书客户端扫描二维码，选择 一键创建飞书机器人。

如果 Windows 设备中无法扫码成功，可能是因为终端的分辨率问题导致，建议更换终端使用 Cmder 或 https://conemu.github.io/（我个人使用 ConEmu 比较多）。

2. 机器人创建完成

创建完成后，点击 打开机器人，在飞书中向机器人发送任意消息，即可开始对话。

2.1 验证安装状态

验证是否安装成功：在飞书对话中发送 /feishu start。若返回了版本号信息，则代表安装成功。

/feishu start

2.2 快速批量授权

若希望快速完成用户授权，便于后续 OpenClaw 通过你的身份完成消息、文档、多维表格、日历等任务，可以在飞书对话中发送 /feishu auth 来完成批量授权。

/feishu auth

2.3 快速学习飞书插件

为了让 OpenClaw 能学会这些新技能并正确使用，建议在飞书对话中发送 学习一下我安装的新飞书插件，列出有哪些能力。

学习一下我安装的新飞书插件，列出有哪些能力

3. 升级飞书插件

后续飞书如果有升级的话，应该如何升级呢？

  1. 运行 openclaw -v 命令查看已安装的 OpenClaw 的版本，新版插件对 OpenClaw 的版本要求如下。若低于该版本，插件运行可能出现异常，可执行 npm install -g openclaw 命令升级。

    1. Linux/MacOS： 2026.2.26 及以上
    2. Windows： 2026.3.2 及以上

  2. 在终端中运行以下命令升级飞书官方插件到最新版本：

    新版命令
    npx -y @larksuite/openclaw-lark update

    若执行该命令行出错，可在命令行前 增加 sudo 重新执行。

    新版命令
    sudo npx -y @larksuite/openclaw-lark update

4. 高级配置指令

4.0 邪修版

直接一股脑的，一条命令一条命令执行。别管含义与功能，你们肯定和我的需求差不多，特殊需求后期属性后往后阅读即可。

更新一条命令复制运行，待实测。欢迎测试成功的，评论分享

因为一条一条复制多行命令麻烦，故而想着能不能直接复制一条实现。欢迎粉丝测试：

  • 一条命令「Mac / Linux（bash / zsh）」；
  • 一条命令 Windows PowerShell-1；
  • 一条命令 Windows PowerShell-2；
基础命令
openclaw config set channels.feishu.streaming true
openclaw config set channels.feishu.footer.elapsed true
openclaw config set channels.feishu.footer.status true
openclaw config set channels.feishu.threadSession true
openclaw config set channels.feishu.requireMention true --json
openclaw gateway restart  # 重启生效

这些是基础常用的，特殊需求或者指令含义往下阅读。

4.1 切换到流式输出

切换到流式输出，可运行指令（如果是本地部署，需要去终端输入；如果是云端部署，去云端的对话框输入）：

openclaw config set channels.feishu.streaming true
# 流式输出卡片上支持显示更多内容
openclaw config set channels.feishu.footer.elapsed true  # 开启耗时
openclaw config set channels.feishu.footer.status true  # 开启状态展示

流式输出效果如图：

不用流式输出，可运行指令：

openclaw config set channels.feishu.streaming false

4.2 设置多任务并行及独立上下文

机器人可在话题群/消息群话题模式中，针对每个话题拥有独立上下文以及多任务并行。

如需开启该能力，可运行指令：

openclaw config set channels.feishu.threadSession true
openclaw gateway restart  # 重启生效

如需关闭，可运行指令：

openclaw config set channels.feishu.threadSession false

4.3 修改飞书机器人在群内的回复方式

目前插件支持的默认方式是机器人被拉进群后，只有 at(@) 机器人时才可回复。

模式 1：只有 【应用所有者（主人）】【@机器人】 才回复

在群内机器人仅响应 应用所有者（主人） @机器人的消息，不响应其他人发给机器人的消息 （已作为 3.17 及以上版本安装时的默认策略，推荐配置）

配置方法：

{
    "channels": {
        "feishu": {
            "enabled": true,
            "appId": "cli_你的AppID",
            "appSecret": "你的AppSecret",
            "requireMention": true,    // 要求消息必须 @ 到机器人后才会回复
            "groupPolicy": "allowlist",  // 将 groupPolicy 设置为 "allowlist"（白名单）
            "groupAllowFrom": ["ou_XXXX"]，// 并通过 groupAllowFrom 指定允许触发机器人的用户，配置你本人 openid 信息。
            "groups": { "*": { enabled: true } }
    }
  }
}

你可以直接咨询小龙虾你的 openid：

我的 openid 是什么？
点击看图示

还有一个方法：就是直接在 OpenClaw Web UI 中直接查看。（掌握方法，而不是全权依赖大模型回复！）

不嫌方法多，就怕没法发。

点击看图示
模式 2：只有 【@机器人】 才回复，可响应群内任何人发送的消息

配置方法：

# 设置需要 @ 才回复
openclaw config set channels.feishu.requireMention true --json
openclaw gateway restart  # 重启生效

完整配置示例：

{
    "channels": {
        "feishu": {
            "enabled": true,
            "appId": "cli_你的AppID",
            "appSecret": "你的AppSecret",
            "requireMention": true,
            "groupPolicy": "open"}
    }
}
模式 3：不用 @，所有消息都回复

注意：这个模式在大群里容易刷屏，谨慎使用！（我挺喜欢的，方便哈哈哈哈）

需要额外在开发者后台申请应用身份权限：获取群组中所有消息（敏感权限）im:message.group_msg。

配置方法：

# 设置不需要 @ 也回复
openclaw config set channels.feishu.requireMention false --json
openclaw gateway restart  # 重启生效

完整配置示例：

{
    "channels": {
        "feishu": {
            "enabled": true,
            "appId": "cli_你的AppID",
            "appSecret": "你的AppSecret",
            "requireMention": false,
            "groupPolicy": "open"
        }
    }
}
模式 4：只有指定群 @机器人才回复（高级）

效果：

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

配置方法：

  • 第一步：获取群 ID

    可通过以下任意方式获取目标群 ID：让机器人加入群后，发送任意消息，然后在日志里找群 ID，或让机器人回复群 ID。

    图片

    群成员可以通过点击右上角的群菜单选项进入群设置页面，查看群 ID。

    图片

  • 第二步：配置特定群规则

    # 先设置默认所有群都不需要 @
openclaw config set channels.feishu.requireMention open --json

# 然后给特定群设置需要 @（这里群 ID 只是示例，你要替换成真实的）
openclaw config set channels.feishu.groups.oc_xxxxxxxx.requireMention true --json
# openclaw config set channels.feishu.groups.【替换成你自己的群 ID】.requireMention true --json
openclaw gateway restart  # 重启生效

    完整配置示例：

5. 常用诊断命令与问题修复方法

可以在与 OpenClaw 的对话中发送以下命令：

  • /feishu start：确认是否安装成功；
  • /feishu doctor：检查配置是否正常；
  • /feishu auth：批量完成用户授权；

插件中也内置了常见问题的解决方案，遇到问题都可以先问问小龙虾。如果不行，则运行以下指令查看问题，并自主修复：

新版命令
npx @larksuite/openclaw-lark doctor

运行 fix 尝试自动修复：

新版命令
npx @larksuite/openclaw-lark doctor --fix

如果仍然无法修复，可在评论区反馈信息。

  • 运行 info 查看版本信息，反馈问题时带上辅助排查。

    新版命令
    npx @larksuite/openclaw-lark info

  • --all 查看详细配置信息：

    新版命令
    npx @larksuite/openclaw-lark info --all

6. 常见问题

6.1 在使用插件时出现权限不足，需要申请所需权限应该如何操作？

  1. 在左侧导航栏选择 权限管理，点击 批量导入/导出权限。——详细教程：🦞立省 500！30 分钟把 OpenClaw 本地部署并在飞书上配到可用

  2. 在 导入 页签中，复制下面权限替换原有示例，点击 下一步，确认新增权限 按钮。

  3. 确认导入权限无误后，点击 申请开通 按钮。

  4. “应用身份权限”可访问的数据范围的设置保持默认 "与应用的可用范围一致" ，点击 确认 完成操作。

6.2 插件安装完毕运行后，报 cannot find module xxx

  • 原因：系统没有安装插件的依赖（可能是安装被中断或权限问题）

  • 解决方法：进入插件安装目录，运行 npm install。

6.3 升级到 OpenClaw 3.2 版本上无法正常调用工具

这个 OpenClaw 版本默认把新 agent 的工具权限关闭。修复方式为在 openclaw.json 找到并修改为下面这段内容：

{
  "tools": {
    "profile": "full",
    "sessions": {
      "visibility": "all"
    }
  }
}

6.4 飞书官方插件与 OpenClaw 社区原有插件有何区别

飞书官方插件，能以用户身份读写消息、文档等，体验更丝滑；以下对比由 AI 整理，供参考。

7. 如何在飞书插件中配置 OpenClaw 关联多个飞书机器人，对应不同 Agent

这个是很适合进行付费定制配置的，可以找我付费配置。（500¥）

非必要不要尝试，目前 bug 居多！很多飞书通讯，直接奔溃！

快捷方法：

  1. 创建新的飞书机器人，用于关联到新的账号上。一键创建一个OpenClaw 机器人：立即创建
  2. 告诉 AI 你想创建一个怎样的新 Agent，以及这个 Agent 关联的飞书账号是什么，并将操作指南发给 OpenClaw 请他自己完成对应配置：如何在飞书插件中配置 OpenClaw 关联多个飞书机器人，对应不同Agent

稍微有些进阶，可以考虑后续有需要再研究。先熟悉 OpenClaw 的操作、逻辑之后接触。

OpenClaw 支持在同一台机器上配置多个飞书机器人账户，实现：

  • 账户隔离：每个飞书机器人独立管理，互不干扰；
  • 路由分发：不同飞书机器人的消息路由到不同的 Agent（工作空间）；
  • 灵活控制：每个账户可以有不同的访问策略、技能权限等；

7.1 配置方式

  1. 直接编辑配置文件：配置文件路径：~/.openclaw/openclaw.json

  2. 创建新的飞书机器人，用于关联到新的账号上。一键创建一个OpenClaw 机器人：立即创建

  3. 完整示例：

7.2 路由规则优先级

当收到飞书消息时，OpenClaw 按以下顺序匹配路由：

  1. 精确匹配：peer.kind + peer.id（特定用户/群组）
  2. 父级匹配：线程继承
  3. 账户匹配：accountId
  4. 渠道匹配：channel + accountId: "*"
  5. 默认 Agent：agents.list[].default 或第一个 agent；

7.3 常用命令

命令说明
openclaw channels list查看所有渠道账户状态
openclaw channels status查看渠道状态
openclaw agents bindings查看路由绑定
openclaw gateway status查看 Gateway 状态
openclaw logs --follow查看日志

7.4 ID 格式参考

类型格式示例
App IDcli_xxxcli_a1b2c3d4e5f6g7h8
用户 Open IDou_xxxou_5b990e213988b9bcf396f955a50b2a22
群组 Chat IDoc_xxxoc_83e1c0d069b94efc09ad22e05bc06365

7.5 获取 ID 的方法

群组 ID（chat_id）：

  1. 启动 Gateway，在群里 @机器人
  2. 运行 openclaw logs --follow 查看 chat_id

用户 ID（open_id）：

  1. 启动 Gateway，私聊机器人
  2. 运行 openclaw logs --follow 查看 open_id

7.6 dmPolicy 参考

值行为
"pairing"默认。未知用户收到配对码，需要管理员批准
"allowlist"只有 allowFrom 中的用户可以聊天
"open"允许所有用户（需要在 allowFrom 中添加 "*"）
"disabled"禁用私聊

7.7 多账号会话隔离（dmScope）

值隔离粒度行为
main最粗粒度所有私聊共用一个会话
per-peer按用户粒度同一用户跨不同 channel 共享会话
per-channel-peer按 channel + 用户 粒度不同 channel 的同一用户各自独立，但同 channel 下多账号仍共享
per-account-channel-peer按账号 + channel + 用户 粒度多账号推荐，每个机器人与每个用户的会话完全独立。

按账号 + channel + 用户 粒度设置隔离的快捷指令：

openclaw config set session.dmScope "per-account-channel-peer"

【注意】：仅设置 session.dmScope 不够——还需通过 agents + bindings 将不同账号绑定到不同 agent，才能实现记忆完全隔离

7.8 故障排查

# 检查配置问题
openclaw doctor

# 自动修复配置问题
openclaw doctor --fix

# 查看详细状态
openclaw status --deep

# 查看日志
openclaw logs --follow

原文参考：https://bytedance.larkoffice.com/docx/WNNXdhKxmo8KDJxMM9dc0GD5nFf?from=from_copylink

8. 如何集成飞书项目 Meego 读写能力

参考文档：OpenClaw x 飞书项目集成实践

小白可以等我研究，发布教程。

9. 插件问题

公众号：AI悦创【二维码】

AI悦创·编程一对一

AI悦创·推出辅导班啦，包括「Python 语言辅导班、C++ 辅导班、java 辅导班、算法/数据结构辅导班、少儿编程、pygame 游戏开发、Web、Linux」，招收学员面向国内外，国外占 80%。全部都是一对一教学：一对一辅导 + 一对一答疑 + 布置作业 + 项目实践等。当然，还有线下线上摄影课程、Photoshop、Premiere 一对一教学、QQ、微信在线，随时响应！微信：Jiabcdefh

C++ 信息奥赛题解，长期更新！长期招收一对一中小学信息奥赛集训，莆田、厦门地区有机会线下上门，其他地区线上。微信：Jiabcdefh

方法一：QQ

方法二：微信：Jiabcdefh

更新日志

2026/3/24 11:04
查看所有更新日志
  • 88b43-Add new images for OpenClaw Lark tools documentation于
  • 9ef56-{ // 定义多个 agent（隔离的工作空间和记忆） "agents": { "list": [ { "id": "main", "name": "主助手", "default": true, "workspace": "~/.openclaw/workspace-main", "model":{ "primary": "ark/doubao" } }, { "id": "work", "name": "工作助手", "workspace": "~/.openclaw/workspace-work", "model":{ "primary": "ark/deepseek" } }, { "id": "support", "name": "客服助手", "workspace": "~/.openclaw/workspace-support", "model":{ "primary": "ark/gpt" } } ] },于
  • 0d583-更新 OpenClaw 教程，添加视频教程和资助信息，调整付费配置价格于
  • d8b25-更新飞书插件文档，调整回复模式说明格式，优化可读性于
  • 1475c-优化飞书插件教程，增加示例和图示，调整配置说明格式于
  • f4a0f-Refactor code structure for improved readability and maintainability于
  • 94ae5-更新飞书插件安装命令，添加一条命令复制运行的示例，优化用户体验于
  • 7ad5c-openclaw config set channels.feishu.footer.status true于
  • 81ca9-更新飞书插件教程，添加新版和旧版命令的代码块，优化内容结构于
  • 278ec-Refactor code structure for improved readability and maintainability于
  • edcda-2026-03-16 11:20:01于
  • 7a5f5-Refactor code structure for improved readability and maintainability于
  • 04cf3-openclaw gateway restart # 重启生效于
  • 0ec8e-Add image for OpenClaw Lark Tools documentation于
  • 390ac-Add simplified tutorial for Feishu plugin installation and usage于

贡献者

AndersonHJB