OpenClaw 配置飞书教程（直接更新，不含安装openclaw）

OpenClaw 配置飞书教程

在开始之前，咱们先把目标明确一下：这篇指南会完整地带你走一遍流程，从更新 OpenClaw 开始，一直到把飞书机器人成功接入。照着步骤来，基本不会出错。

一、更新 OpenClaw

万事开头，先把工具升级到最新版。打开终端，输入：

openclaw update

⚠️ 注意一个关键前提： 如果你之前已经尝试过接入其他版本的飞书插件，那么务必要先做一次“清理工作”。

执行下面这条命令，移除旧的配置：

# 进入 .openclaw/extensions 目录，删除 feishu 文件夹
rm -rf ~/.openclaw/extensions/feishu

当然，如果你是第一次配置，压根没碰过飞书插件，那这一步完全可以跳过。

二、创建飞书机器人

2.1 创建应用

第一步，去飞书开发者后台。 点击页面上的「创建企业自建应用」按钮，然后给应用起个名字、写个简单的描述。这里的信息只是为了区分，怎么顺眼怎么填就行。

2.2 添加机器人能力

应用创建成功后，进入应用管理页面。找到并点击「添加应用能力」，在右侧的「按能力添加」菜单栏里，一眼就能看到「机器人」这个选项，点击添加它。

2.3 开通权限

接下来是关键环节——配置权限。进入「权限管理」页面。

最省事的办法是：在“权限”标签页，直接找到“批量导入”功能，然后把下面这一整段 JSON 配置粘贴进去：

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

这一套权限组合拳，是为了确保机器人后续能正常收发消息、访问文件，是功能正常运行的基础。

三、配置 OpenClaw

3.1 添加飞书渠道

回到命令行终端，运行添加渠道的命令：

openclaw channels add

在出现的渠道列表中，选择 feishu（飞书）。

3.2 处理已有配置

如果系统提示 Feishu already configured，说明之前有过配置记录。直接选择「修改配置」选项即可，无需担心。

3.3 配置参数

接下来，根据命令行终端的交互提示，依次填写以下信息：

全部填写无误后，选择 finish 完成配置。

3.4 后续配置选项

完成主要配置后，终端通常会提示两个后续选项：

Configure DM access policies now? → 选 No
Add display names for these accounts? → 选 No

对于初次配置来说，这两个选项都选 No（不配置）是最简单直接的方式，不影响基础功能。

3.5 重启 Gateway

配置信息已经更新，最后一步是重启网关服务让配置生效：

openclaw gateway restart

四、配置飞书事件订阅

配置还没完，我们还得回到飞书开发者后台，完成最后一环。

在应用管理页面，找到「事件与回调」功能。 需要添加一个关键事件：im.message.receive_v1（接收消息）。 在订阅方式上，选择「使用长连接接收事件」。这一步是为了让飞书服务器能够将消息事件主动推送给你的 OpenClaw 服务。

五、验证

好了，所有拼图都已就位。现在，是时候验收成果了。

打开你的飞书，找到刚刚创建的那个机器人应用，直接给它发条消息试试。 如果一切顺利，你会收到来自 OpenClaw 的回复。看到回复那一刻，就说明整个链路已经完全打通了。

六、常用命令

为了方便日后维护，这里罗列几个最常用的 OpenClaw 命令，备查：

# 更新 OpenClaw
openclaw update

# 添加或管理渠道
openclaw channels add

# 重启网关服务（修改配置后常用）
openclaw gateway restart

# 查看网关当前运行状态
openclaw gateway status

# 实时查看日志，用于调试排查问题
openclaw logs --follow

七、参考链接

• 飞书开发者后台
• OpenClaw 官方文档