OpenClaw(原Moltbot、Clawdbot)集成飞书

更新时间:
复制为 MD 格式

本文介绍将 OpenClaw服务与飞书集成,实现在飞书群聊或单聊中,通过自然语言直接与OpenClaw交互。

环境准备

配置消息渠道前,需参考以下步骤或部署OpenClaw镜像文档购买并配置OpenClaw应用镜像的轻量应用服务器,若已完成可跳过此步骤。

购买并配置OpenClaw应用镜像的轻量应用服务器

步骤一、购买OpenClaw套餐

重要

如果已购买轻量应用服务器,可以跳过此步骤,以重置系统的方式部署OpenClaw(重置系统时选择应用镜像下的OpenClaw镜像),但重置系统会清除轻量应用服务器上的系统盘数据,请根据需要做好数据备份。具体操作,请参见重置系统

  1. 购买预装OpenClaw应用的轻量应用服务器

  2. 轻量应用服务器页面,预置了资源配置,如要更改配置项,请参考下面内容。

    • 实例:内存必须2GiB及以上,可以根据自己的需求切换套餐。

    • 地域:默认北京

    • 购买配置:默认12个月,可以根据自己的需求切换时长。

步骤二、配置OpenClaw

OpenClaw 提供两种配置方式,请根据您的镜像版本切换以下页签查看对应的操作步骤。

OpenClaw 2026.5.19 及以上版本(推荐)

  1. 登录轻量应用服务器控制台,单击服务器卡片中的实例 ID,在服务器概览页面单击应用详情页签。

  2. 在应用详情页左下角单击初始化按钮,根据弹出的初始化向导完成步骤 1:模型配置

    • 大模型平台:从下拉框中选择模型厂商,支持阿里云百炼 Token Plan(团队版)、阿里云百炼 Coding Plan、阿里云百炼、deepseek、Kimi、GLM Coding Plan、智谱等多家厂商。

    • API Key:选择 API Key 对应的地域,并填入 API Key。

    • 模型:选择或手动输入模型名。

    配置完成后单击立即配置进入下一步。

  3. 在初始化向导步骤 2:使用 Web UI中,需要先在放通 OpenClaw 访问端口区域单击确定放通完成端口放通,然后单击登录 Web UI即可跳转到 OpenClaw WebUI,与 OpenClaw 的 Agent 对话。

    重要

    端口放通将使服务暴露于公网。初始化完成后,可在应用详情页顶部状态栏的公网访问开关一键关闭,详见如何开启/关闭OpenClaw WebUI的公网访问

  4. (可选)查看 Token。初始化完成后,在应用详情页顶部状态栏的Token字段单击复制按钮即可获取完整 Token。

    警告

    请勿泄露包含 Token 的完整 URL。该链接包含身份验证凭据,任何持有此链接的人都能直接绕过登录验证,获得 OpenClaw 控制台的管理员权限。

OpenClaw 2026.5.19 之前版本

  1. 轻量应用服务器-控制台,单击服务器卡片中的实例ID,在服务器概览页面单击应用详情页签。

  2. OpenClaw使用步骤区域中,单击端口放通下的执行命令,可开放获取OpenClaw服务运行端口的防火墙。

    重要
  3. 单击配置OpenClaw下的执行命令配置百炼API key。

    目前支持配置两种类型的百炼API Key:

    • Coding Plan 套餐专属 API Key(推荐):采用固定月费模式,提供月度请求额度,超出时段限额的调用会报错且不计费用,可避免产生超出预期的费用。

      Coding Plan 目前支持 qwen3.5-pluskimi-k2.5MiniMax-M2.5glm-5等模型,详细的模型列表请参考Coding Plan概述
    • Token用量计费的百炼API Key。

    配置API Key。在下拉框中选择Coding PlanAPI Key或直接输入按量计费的API Key,选择模型后单击下一步

    手动输入API Key时,需确保所选地域与API Key对应的地域一致,否则会导致模型无法正常调用。
    重要

    初始化过程中暂不支持配置百炼 Token Plan,强行输入会导致报错。如需使用 Token Plan,请先完成初始化,再参见如何在 OpenClaw 中接入百炼 Token Plan 团队版?进行配置。

  4. 单击访问Web UI面板下的执行命令,获取OpenClaw WebUI的地址,可以在Web页面与OpenClawAgent对话。

    可根据需求参考关闭OpenClaw WebUI的公网访问一键关闭WebUI的公网访问权限。
  5. (可选)查看Token。

    应用详情 > 基础配置 > 查看Token中单击查看,查看并保存Token。

    警告

    请勿泄露包含 Token 的完整 URL。该链接包含身份验证凭据,任何持有此链接的人都能直接绕过登录验证,获得 OpenClaw 控制台的管理员权限。

集成飞书

OpenClaw插件集成方式仅支持镜像版本为OpenClaw 2026.2.9及以上的实例。如需在旧版本中集成该消息渠道,请参考通过AppFlow集成消息渠道。您可在轻量应用服务器概览页的基本信息 > 镜像信息中查看当前实例的镜像版本。

OpenClaw 提供两种飞书集成方式,请根据您的镜像版本切换以下页签查看对应的操作步骤。

OpenClaw 2026.5.19 及以上版本(推荐)

控制台扫码接入

  1. 登录轻量应用服务器控制台,找到目标 OpenClaw 服务器,进入应用详情页签。

  2. 通道 (Channels)卡片中,单击添加通道,在通道下拉框中选择飞书

  3. 保持默认选中的扫码接入 IM页签,单击扫码配置

  4. 等待命令执行完成后,页面将显示一个二维码。使用飞书扫描该二维码完成接入。

    生成二维码一般需要30秒到2分钟,请耐心等待。
  5. 扫码完成后,单击关闭

  6. 与机器人对话验证。

    首次对话一般需要等待30秒到2分钟,请耐心等待。

OpenClaw 2026.5.19 之前版本

通过旧版控制台通道配置区域完成集成。

控制台扫码接入

只支持 OpenClaw 2026.3.28 镜像及以上版本,其他版本使用手动配置接入。
  1. 登录轻量应用服务器控制台,找到目标 OpenClaw 服务器,进入应用详情页签。

  2. 通道配置区域的飞书部分,单击扫码配置

  3. 等待命令执行完成后,页面将显示一个二维码。使用飞书扫描该二维码完成接入。

    生成二维码一般需要30秒到2分钟,请耐心等待。
  4. 扫码完成后,单击关闭

  5. 与机器人对话验证。

    首次对话一般需要等待30秒到2分钟,请耐心等待。

手动配置

1. 创建飞书应用

  1. 访问飞书开放平台,单击创建企业自建应用,填写应用名称和描述,选择应用图标,单击创建

  2. 左侧导航栏单击凭证与基础信息 页面,复制App ID(格式如 cli_xxx)和App Secret

  3. 左侧导航栏单击 权限管理 页面,点击批量导入/导出权限 按钮,粘贴以下 JSON 配置,单击下一步,确认新增权限,单击申请开通

    JSON配置文件内容

    {
      "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"]
      }
    }
  4. 左侧导航栏中单击添加应用能力, 选择按能力添加页签,找到机器人卡片,单击配置

    image

  5. 配置事件订阅。

    1. 轻量应用服务器控制台,进入目标实例详情页,在应用详情 > 通道配置 > 飞书区域,填入之前获取的App IDApp Secret,并单击应用

    2. 在飞书开放平台左侧导航栏单击事件与回调,在事件配置页签中单击订阅方式,选择使用 长连接 接收事件,单击保存

    3. 在事件配置页面,单击添加事件,搜索事件im.message.receive_v1(接收消息),单击确认添加

  6. 版本管理与发布 页面创建版本,填写应用版本号更新说明,单击保存,提交审核并发布。

2. 配置机器人

可以创建群聊或在已有群聊中添加机器人,在飞书群中@机器人进行对话,或通过搜索的方式与机器人私聊进行测试。

若需在外部群中使用机器人,可参考配置文档机器人支持外部群和外部用户单聊
  1. 按照添加路径添加机器人:··· > 设置 > 群机器人 > 添加机器人

  2. 单击机器人头像,单击发送消息,可向机器人私发一条消息,@机器人可在群中向机器人发送消息。

OpenClaw 2026.3.13 版本之前,需使用配对码连接机器人,可参考如下步骤配置。

使用配对码连接机器人

  1. 向机器人私发消息,机器人会回复一个配对码

    image

  2. WebUI页面输入openclaw pairing approve feishu 配对码完成配对。

    配对码是上一步机器人回复的配对码。

    image

    重要

    如出现“目前没有待处理的配对请求”报错,请参考如何通过终端命令将OpenClaw与飞书配对

常见问题

如何通过终端命令将OpenClaw与飞书配对?

  1. 登录服务器。

    1. 登录轻量应用服务器控制台

    2. 在服务器列表中,找到目标服务器卡片,单击卡片中的远程连接。在弹出的连接窗口中,在Workbench 一键连接区域单击立即登录

  2. 获取配对码。

    在终端执行以下命令,找到待配对的飞书机器人配对码,复制查询结果中的配对码。

    openclaw pairing list feishu

    image

  3. 完成配对。

    在终端执行以下命令,批准配对请求。将命令中的YXXX替换为上一步获取的实际配对码。

    openclaw pairing approve feishu YXXX 

如何配置OpenClaw定时执行任务并输出内容到飞书机器人?

可以通过与OpenClaw对话创建定时任务。

  1. 获取群机器人的Webhook地址:

    1. 单击群设置 > 群机器人

      image

    2. 单击添加机器人,选择自定义机器人。填写机器人名称和描述,单击添加,复制Webhook地址

  2. OpenClaw对话中创建相应任务,格式为定时任务内容+群机器人的Webhook地址,以查询实时天气为例创建定时任务。

  3. 验证消息发送。可在对话中让Agent立即发送消息,测试该定时任务。在机器人所在的群聊查看是否执行定时任务。

如要修改或者取消定时任务,可直接在对话中让Agent修改或取消定时任务。

如需使用AppFlow配置定时任务,请参考如何使用AppFlow配置定时任务