openClaw安装到飞书配置

openClaw飞书配置

前置准备工作

我们前置需要先申请一个飞书机器人，来当做我们与OpenClaw进行交互对话的BOT，由于仅需要基础的对话权限，该步骤比较快速，提交后免批便可以通过。

申请时先打开飞书开放平台:https://open.larkoffice.com/，个人用户可以申请注册一个飞书企业，进行登录，然后点击创建自建应用:
根据自己的喜好进行命名和图标设置，并开启机器人功能。
为机器人开通对话等消息权限。在左侧菜单选择"开发配置 > 权限管理"，单击"批量导入/导出权限"按钮。

在"导入"的TAB中，粘贴填入下面的JSON，点击下一步，然后点击申请开通。

"contact:contact.base:readonly" // 非必须，试用阶段也可跳过该权限申请，使用中可能会遇到waring提示

json 复制代码

{
  "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内置的飞书插件额外支持按照用户身份来进行文档检索、飞书消息搜索、日历和飞书任务创建
飞书密钥配置

在终端中执行如下命令。

json 复制代码

openclaw channels add

在弹出的选项中选择Feishu，然后根据交互式选择，输入前置已经准备好的 App ID 和 App Secret 即可。
填写完飞书密钥后，在终端中执行如下命令网关重启，确保新配置已被应用。

重启网关以应用新配置

zsh 复制代码

openclaw gateway restart

zsh 复制代码

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

飞书官网也支持了插件安装相关指南
https://bytedance.larkoffice.com/docx/MFK7dDFLFoVlOGxWCv5cTXKmnMh