OpenClaw如何连接飞书

将OpenClaw连接到飞书

把OpenClaw接入飞书，过程其实相当清晰，主要就分三步：在飞书那边创建一个自己的应用并做好配置，然后在OpenClaw这边装上飞书插件、填好凭证，最后将两边手动“牵上线”完成配对。好消息是，整个过程无需编写任何代码，只要跟着步骤一步步来，小白也能轻松搞定。

下面，咱们就手把手走一遍完整的流程，你可以边看边操作：

???? 第一步：在飞书开放平台创建应用

这是连接的基础，你得先在飞书那边创建一个专用的“机器人”应用，来负责消息的接收与发送。

创建应用：登录飞书开放平台，点击页面上明显的「创建企业自建应用」按钮，填写好应用名称等信息后完成创建。

获取凭证：进入应用详情页，找到左侧菜单栏的「凭证与基础信息」。这个页面里的 App ID 和 App Secret 是关键中的关键，相当于机器人的“身份证”和“钥匙”，请务必复制并妥善保管，下一步马上要用。

添加机器人能力：转到「应用能力」模块，找到并开启「机器人」能力。这一步是核心，没有它，你的应用就没法进行对话交互。

配置事件订阅（关键）：为了让飞书在用户给机器人发消息时，能准确通知到你的OpenClaw，这里需要重点配置。 进入「事件与回调」页面，在「事件配置」页签下，先将「订阅方式」切换为「使用长连接接收事件」并保存。接着，点击「添加事件」，搜索并添加 im.message.receive_v1（接收消息）事件。这一步配置好了，你的机器人才能真正“听到”用户说的话。

配置权限：为了让机器人能正常收发消息、识别用户身份，需要给它开通必要的“通行证”。 进入「权限管理」页面，一个便捷的方法是使用「批量导入/导出权限」功能。直接将下面这串最精简的权限配置粘贴进去：

{"scopes": {"tenant": ["im:message","im:message.group_at_msg:readonly","im:message.p2p_msg:readonly","im:message:send_as_bot","contact:user.employee_id:readonly"]}}

点击「确认开通」，这些权限就生效了。

发布应用：所有配置完成后，最后一步别忘了去「版本管理与发布」页面，创建一个新版本并提交发布。只有发布后，配置才会最终生效，企业内的其他同事也才能搜索并使用这个机器人。

⚙️ 第二步：在OpenClaw中安装和配置飞书插件

好了，飞书那边的“地基”打好了，现在回到OpenClaw这边，告诉它如何连过去。

安装飞书插件：打开你的终端，执行以下命令来安装官方提供的飞书插件：

openclaw plugins install @m1heng-clawd/feishu

填写飞书凭证：插件装好后，需要把第一步获取的 App ID 和 App Secret 交给OpenClaw。通过几行简单的命令行就能快速完成：

# 请将命令中的 “你的飞书 app id” 和 “你的飞书 app secret” 替换为实际的值
openclaw config set channels.feishu.appId “你的飞书 app id”
openclaw config set channels.feishu.appSecret “你的飞书 app secret”
openclaw config set channels.feishu.enabled true

重启网关服务：为了让所有配置修改生效，必须重启一下OpenClaw的网关服务：

openclaw gateway restart

???? 第三步：完成配对，开始对话

万事俱备，只欠东风。现在需要在OpenClaw和你飞书里的机器人之间建立一个专属的连接通道。

发起对话获取配对码：在飞书客户端（电脑或手机都行），找到你刚刚创建并发布的那个机器人，给它随便发送一条消息。比如发个“你好”，它会自动回复给你一个“配对码”（通常是一串六位数字）。

在OpenClaw中确认配对：复制飞书机器人回复的那个配对码。然后，回到OpenClaw的WebUI界面，或者直接在终端里执行以下命令来完成最终的配对：

# 请将 “你的配对码” 替换为实际收到的数字
openclaw pairing approve feishu 你的配对码

验证成功：当终端显示“配对成功”的提示时，恭喜你！现在就可以直接在飞书里和你的AI助手自由对话了。你还可以把它邀请到部门群或项目群里，让大家一起体验智能协作的便利。