OpenClaw 实战 02： 通过飞书进行对话

对接飞书本来可以直接参考官网指导。

但这篇文章最有价值是这一部分，是这一部分：无限循环。

因为我每次重装，每次都碰到这个问题。

飞书配置 #

首先，你需要一个飞书账户。
可以是公司账户，也可以是个人账户。

下面我们以个人账户来演示。
公司账户需要管理员授权等复杂操作。

创建应用 #

登录飞书开放平台。

点击企业自建应用。
名称和描述，自己随意填写。

权限管理 #

在控制台，点击权限管理。 点击 批量导入/导出权限。

在编辑器内输入如下内容：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

接下来就按照指示，开通权限即可。

开通机器人 #

在菜单栏点击 机器人，在如何开始使用点击编辑，随便输入内容。

发布应用 #

点击 创建版本，进行应用发布。

• 版本号：0.1.0
• 更新说明：完成最基础的应用设置

填写完内容后，点击保存和确认发布。

成功后，会显示已启用。

准备 #

飞书的基本配置完成后，我们需要操作 OpenClaw，让OpenClaw和飞书能够进行有效沟通。

启动飞书相关组件 #

> openclaw plugins list | grep feishu


│ @openclaw/   │ feishu   │ disabled │
│ feishu       │          │          │

可以看到现在我们插件列表中是有飞书的，只不过显示状态是 Disabled。

下面我们来开启飞书功能。

openclaw plugins enable feishu

再看一下状态:

│ Feishu       │ feishu   │ loaded   │

现在飞书插件已经加载了。

创建channel #

第一次创建channel，建议开启交互的方式来一步步进行设置。
当你熟悉后，可以直接在webui界面进行设置。

# 检查现有channel
> openclaw channels list


Chat channels:
- Feishu default: not configured, enabled

系统显示，现在我们开启了飞书渠道，但还没有进行配置。

下面进行交互式配置：

# 在开始前一定要确认 openclaw是可以正常工作的
# 否则你会陷入无限循环中 (碰到多次了)
# 一般情况下不需要操作，因为openclaw已经默认开机启动

# 先进行测试
openclaw tui

## 如果有正常唤醒回应，那就证明没问题
## 否则需要执行下面的操作，查看当前状态

openclaw gateway status

先安装插件

openclaw plugins install @openclaw/feishu

openclaw gateway restart

> openclaw channels add

◆  Configure chat channels now?
│  ● Yes / ○ No

◆  Select a channel
│  ○ Telegram (Bot API)
│  ● Feishu/Lark (飞书) (needs app creds)
│  ○ Nostr (NIP-04 DMs)

Enter Feishu App ID

Enter Feishu App Secret

AppID 和 AppSecret 在飞书开放平台里面找。

选择你创建的应用，点击左侧菜单的 凭证与基础信息。
在右侧就能看到2个关键信息。

◆  Which Feishu domain?
│  ● Feishu (feishu.cn) - China
│  ○ Lark (larksuite.com) - International
# 这里选择国内域名

◆  Group chat policy
│  ○ Allowlist - only respond in specific groups
│  ○ Open - respond in all groups (requires mention)
│  ● Disabled - don't respond in groups
# 先禁用群聊功能

正常配置好后，系统会在后台和飞书进行一次简单的会话。

有了这次简单的会话，就能执行下一步了。

我们也可以check一下，类似如下结果

openclaw channels list

🦞 OpenClaw 2026.2.24 (df9a474) — I run on caffeine, JSON5, and the audacity of "it worked on my machine."

11:23:02 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
11:23:02 [plugins] feishu_wiki: Registered feishu_wiki tool
11:23:02 [plugins] feishu_drive: Registered feishu_drive tool
11:23:02 [plugins] feishu_bitable: Registered bitable tools
Chat channels:
- Feishu default: configured, enabled

可以看到 plugin和channel都已经启用了。

飞书：事件配置 #

回到飞书开放平台，进入对应应用。

左侧菜单选择事件与回调，修改事件为 长连接。

如果之前的飞书channel正常添加了，那么这里只要飞书重新发布新版本即可。

但如果这边无法成功开启上连接，那么就是上面步骤出问题了。

就直接看本篇最有价值的部分,如何解决这个关键问题。

飞书：事件订阅 #

在订阅事件区域，点击添加事件：im.message.receive_v1

飞书：发布 #

完成上面2项配置后，重新发布新版本。

配对 #

上面虽然完成了openclaw和飞书的相关配置，在飞书内，你也应该能找到这个机器人。

你需要进行一次对话，当机器人有返回的时候，应该如下形式：

OpenClaw: access not configured.
Your Feishu user id: xxxxxx
Pairing code: xxxx
Ask the bot owner to approve with:
openclaw pairing approve feishu xxxx

最后一句换，就是执行的关键，你需要在本地执行这个命令。

执行后，应该能正常对话。

最大问题：无限循环 #

不知道你有没有碰到无限循环的问题，在配置channel的时候，一直在无限循环，而且每次安装都碰到。

这获取是这篇文章最有价值的地方。

# 查看配置是否已经写入
openclaw config get channels.feishu


# 或者你可以单独设置
openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.appId "cli_xxxx"
openclaw config set channels.feishu.appSecret "xxxx"
openclaw config set channels.feishu.domain "feishu"
openclaw config set channels.feishu.dmPolicy "pairing"

这样单独设置后，就可以继续上面的事件配置部分了。

小问题：权限问题 #

按照官网的指示后，权限还是少一个。
因为每个人的app id不同，所以无法直接贴链接。 不过大家，需要打开 openclaw logs --follow就能看到自己的修复链接是什么。

code: 99991672,
      msg: 'Access denied. One of the following scopes is required: [contact:contact.base:readonly, contact:contact:access_as_app, contact:contact:readonly, contact:contact:readonly_as_app].应用尚未开通所需的应用身份权限：[contact:contact.base:readonly, contact:contact:access_as_app, contact:contact:readonly, contact:contact:readonly_as_app]，点击链接申请并开通任一权限即可：https://open.feishu.cn/app/[app_id]/auth?q=contact:contact.base:readonly,contact:contact:access_as_app,contact:contact:readonly,contact:contact:readonly_as_app&op_from=openapi&token_type=tenant',
      error: [Object],

或者本链接 https://open.feishu.cn/app/[app_id]/auth?q=contact:contact.base:readonly,contact:contact:access_as_app,contact:contact:readonly,contact:contact:readonly_as_app&op_from=openapi&token_type=tenant 中的[app_id] 为你真正的 app_id 即可。

或者自己添加如下图权限：

至此，我们已经跑通了通过飞书来让openclaw进行部分工作了。

广告 #

都看到这里了，就赶紧动手试一下吧。