openClaw安装到飞书配置

OpenClaw飞书配置

前置准备工作

在开始配置之前，我们需要先申请一个飞书机器人作为与OpenClaw交互的对话BOT。由于只需要基础的对话权限，这个步骤相当简单，提交申请后通常无需审批就能快速通过。

首先访问飞书开放平台（https://open.larkoffice.com/）。个人用户可以注册一个飞书企业账号登录后，点击创建自建应用：

接下来，按照个人偏好设置应用名称和图标，并确保开启机器人功能：

现在需要为机器人开通对话等消息权限。在左侧菜单中找到“开发配置 > 权限管理”，点击“批量导入/导出权限”按钮：

切换到“导入”标签页，将下面的JSON配置粘贴进去，点击下一步，然后申请开通：

“contact:contact.base:readonly” // 这个权限非必须，试用阶段也可以跳过，使用中可能会遇到警告提示

{"scopes": {"tenant": ["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","contact:contact.base:readonly" ],"user": ["contact:user.employee_id:readonly"]}}

第四步是填写发布说明。点击顶部的“创建版本”按钮，填入相应的发布说明：

最后一步，选择机器人的权限范围并确认提交。如果是个人使用的机器人，权限范围只需配置自己即可；如果是无权限风险的通用机器人，可以根据需要设置可用范围。需要注意的是，内部场景使用的机器人不要勾选对外共享选项。

提交完成后，通常免审批就能通过。接下来在左侧菜单中选择“凭证与基础信息”，复制APP ID、APP Secret和BaseURL，这些信息后续配置会用到：

对接OpenClaw的实际操作

准备工作完成后，接下来就是实际对接OpenClaw了。

为了实现飞书与OpenClaw的通信，目前有两种方案可供选择（二选一即可，配置完成后也支持随时切换）：

OpenClaw内置的飞书通道：本文下面的流程基于内置飞书插件的配置方式。这种方式的优点在于可以利用OpenClaw内置的引导流程快速完成设置，但缺点是与飞书生态的深度整合不够完善，仅支持以机器人身份进行简单的文档读写，对于复杂的日程管理、待办任务处理、多维表格、飞书消息搜索等高阶能力暂时还不支持。

使用飞书官方的插件：最近飞书官方也推出了OpenClaw的插件，相比OpenClaw内置的飞书插件，额外支持按照用户身份进行文档检索、飞书消息搜索、日历和飞书任务创建。

飞书密钥配置

在终端中执行以下命令：

openclaw channels add

在弹出的选项中选择Feishu，然后根据交互式提示，输入之前准备好的App ID和App Secret即可。

填写完飞书密钥后，在终端中执行以下命令重启网关，确保新配置生效：

重启网关以应用新配置

openclaw gateway restart

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

值得一提的是，飞书官网也提供了插件安装的相关指南：

https://bytedance.larkoffice.com/docx/MFK7dDFLFoVlOGxWCv5cTXKmnMh