OpenClaw 中文教程

外观

飞书（Feishu）

约 2236 字大约 7 分钟

2026-03-02

概述

飞书（Feishu/Lark）是 OpenClaw 支持的重要 IM 渠道之一。相比于 Telegram 等国外平台，飞书是国内的平台，有中文的界面、文档和客服，更容易上手。飞书的开放能力更强，能获取更多工作中必要的上下文，是国内接入 OpenClaw 的最佳选择。

通过飞书官方插件，OpenClaw 可以：

  • 以你的身份完成工作（回消息、写文档、生成多维表格等）
  • 获取飞书内的海量上下文（消息、文档、会议纪要、多维表格、日程、任务等）
  • 支持消息流式生成

前置准备

版本要求

  • Linux/MacOS：openclaw 2026.2.26 及以上
  • Windows：openclaw 2026.3.2 及以上

查看版本：

openclaw -v

如低于要求版本，执行升级：

npm install -g openclaw@latest

免安装方案

使用以下平台安装的 OpenClaw 已自带飞书插件，无需阅读后续的安装步骤：

安装步骤

1. 安装飞书插件

执行以下命令安装飞书官方插件：

npx -y https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/8ab6e7a04c17db1becfcbda8ca35f091_1rCCFRWlRV.tgz install

提示

如果执行出错，可尝试在命令前增加 sudo 重新执行。

执行过程中通过飞书客户端扫描二维码，可以一键创建飞书机器人。系统将自动申请所需的权限、安全设置并提交发布。

Windows 用户

如果 Windows 设备中扫码无法成功，可能是因为终端的分辨率问题导致，建议更换终端，使用：Cmder

2. 验证安装

创建好后，在飞书中打开机器人即可使用：

  1. 在飞书中向机器人发送任意消息，即可开始对话
  2. 确认是否安装成功，可发送：/feishu start
    • 如果返回了版本号信息，则代表安装成功
  3. 让龙虾学习新技能：发送「学习一下我安装的新飞书插件，列出有哪些能力」
  4. 如果想要让小龙虾可以读写你的飞书数据（如云文档、日历、消息、多维表格），可以输入 /feishu auth 来完成批量授权

飞书插件能力

类别能力
💬 消息消息读取（群聊/单聊历史、话题回复）、消息发送、消息回复、消息搜索、图片/文件下载
📄 文档创建云文档、更新云文档、读取云文档内容
📊 多维表格创建/管理多维表格，数据表、字段、记录（增删改查、批量操作、高级筛选）、视图
📅 日历日程日历管理、日程管理（创建/查询/修改/删除/搜索）、参会人管理、忙闲查询
✅ 任务任务管理（创建/查询/更新/完成）、清单管理、子任务、评论

使用配置

流式输出配置

切换到流式输出（推荐），可运行指令：

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    # 开启状态展示

多任务并行独立上下文

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

开启：

openclaw config set channels.feishu.threadSession true

关闭：

openclaw config set channels.feishu.threadSession false

群内回复方式配置

目前插件默认方式：可被拉进群，只有 @机器人才可回复。

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

openclaw config set channels.feishu.requireMention true --json
# 重启生效
sh /workspace/projects/scripts/restart.sh

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

需要额外在开发者后台申请权限：im:message.group_msg

openclaw config set channels.feishu.requireMention false --json
# 重启生效
sh /workspace/projects/scripts/restart.sh

注意

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

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

第一步：获取群 ID 让机器人加入群后，发送任意消息，然后在日志里找群 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

诊断与修复

诊断命令

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

命令说明
/feishu start确认是否安装成功
/feishu doctor检查配置是否正常
/feishu auth批量完成用户授权

手动诊断

如果对话中命令不行，则运行指令：

npx https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/8ab6e7a04c17db1becfcbda8ca35f091_1rCCFRWlRV.tgz doctor

自动修复

运行以下命令尝试自动修复：

npx https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/8ab6e7a04c17db1becfcbda8ca35f091_1rCCFRWlRV.tgz doctor --fix

查看版本信息

npx https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/8ab6e7a04c17db1becfcbda8ca35f091_1rCCFRWlRV.tgz info

查看详细配置信息：

npx https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/8ab6e7a04c17db1becfcbda8ca35f091_1rCCFRWlRV.tgz info --all

权限申请

如果使用插件时出现权限不足，需要申请所需权限：

步骤 1：导入权限

  1. 打开 飞书开放平台
  2. 选择「开发配置 > 权限管理」
  3. 单击「批量导入/导出权限」按钮
  4. 在「导入」页签中，将如下权限替换原有示例
{
  "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",
      "sheets:spreadsheet.meta:read",
      "sheets:spreadsheet:read",
      "sheets:spreadsheet:create",
      "sheets:spreadsheet:write_only",
      "docs:document:export",
      "docs:document.media:upload",
      "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: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:message",
      "im:message.group_msg:get_as_user",
      "im:message.p2p_msg:get_as_user",
      "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"
    ]
  }
}
  1. 确认权限无误后，单击「申请开通」

步骤 2：发布应用

  1. 单击顶部的「创建版本」按钮
  2. 按需配置应用版本号、默认能力及更新说明
  3. 单击「保存」创建版本
  4. 单击「确认发布」完成应用发布

插件更新

插件能力实时更新，欢迎更新到插件最新版本体验最新能力。

在「终端」中运行：

npx -y https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/8ab6e7a04c17db1becfcbda8ca35f091_1rCCFRWlRV.tgz update

提示

如果执行出错，可尝试在命令前增加 sudo 重新执行。

多机器人配置

方式一：快捷创建

一键创建新的 OpenClaw 机器人：立即创建

方式二：手动配置

  1. 告诉 AI 你想创建一个怎样的新 Agent，以及这个 Agent 关联的飞书账号是什么
  2. 将操作指南发给 OpenClaw 请他自己完成对应配置

安全与风险提示

核心风险

这个插件通过飞书接口连接了你的工作数据——消息、文档、日程、联系人，AI 能读到的东西理论上就有泄露的可能。

强烈建议

  • 现阶段切勿使用公司/企业飞书账号接入！ 请务必优先使用个人账号进行体验和测试
  • 对于涉及发送、修改、写入等重要操作，请务必做到「先预览，再确认」
  • 切勿让 AI 处于完全脱离人工干预的「全自动驾驶」状态

操作风险

  • AI 并不完美，可能存在「幻觉」
  • 部分操作不可逆转（例如 AI 代发的飞书消息是以您的名义发出的）

常见问题

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

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

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

Q: Coze 上安装失败

依次执行以下命令：

export NPM_CONFIG_REGISTRY=https://registry.npmmirror.com
npx -y https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/8ab6e7a04c17db1becfcbda8ca35f091_1rCCFRWlRV.tgz install

检查老插件的配置，如果为「true」需要改成「false」。

Q: 升级到 OpenClaw 3.2 版本后无法正常调用工具

原因：这个版本默认把新 agent 的工具权限关闭

修复方式：在 openclaw.json 加上这段内容：

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

相关资源