OpenClaw(原Moltbot、Clawdbot)集成飞书

更新时间:
复制为 MD 格式

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

环境准备

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

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

步骤一、购买OpenClaw套餐

重要

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

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

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

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

    • 地域:默认北京

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

步骤二、配置OpenClaw

  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对应地域

      Coding PlanAPI key对应地域

      中国内地地域

      华北2(北京)

      华北2(北京)

      美国及欧洲地域

      美国(弗吉尼亚)

      中国香港及其他亚洲地域

      新加坡

    • 手动输入

      单击按钮切换至手动输入,输入百炼API Key并选择该API Key对应地域,单击下一步image

      重要

      手动配置需确保选择的API Key对应地域正确,否则会导致模型无法正常调用。

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

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

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

    警告

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

集成飞书

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

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配置定时任务