阿里云 OpenClaw（Clawdbot）集成飞书教程

通过阿里云应用连接器（AppFlow）可以将 OpenClaw服务与飞书集成，实现在飞书群聊或单聊中，通过自然语言直接与OpenClaw交互。

步骤一、购买OpenClaw套餐

重要

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

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

   “ 该应用镜像基于Alibaba Cloud Linux 3.2104 LTS 64位操作系统，来源于阿里云计算巢。

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

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

   • 地域 ：默认 美国（弗吉尼亚） 。

     “ 目前中国内地地域（除香港）的轻量应用服务器，无法使用OpenClaw的联网搜索功能。

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

步骤二、配置OpenClaw

1. 在 服务器页面 ，单击服务器卡片中的实例ID，在 服务器概览 页面单击 应用详情 页签。

2. 在 Moltbot使用步骤 区域中，单击 端口放通 下的 一键放通 ，放通对应端口的防火墙。

   

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

   

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

   • 按Token用量计费的百炼API Key。

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

     “ Coding Plan 仅支持 抵扣 qwen3-max-2026-01-23 和 qwen3-coder-plus 模型调用费用， 不支持抵扣多模态模型调用费用。

   API Key配置方式包括  系统推荐  及  手动输入 。系统推荐会列出百炼Coding Plan的API Key（成本可控），及离服务器最近的百炼模型服务的API Key（时延较低）。若需使用其他地域或者其他账号的API Key可选择 手动输入。

   • 系统推荐（下拉选择）

     “ 如果按界面操作创建对应地域下的百炼API Key出错，请参考 创建按量计费的API Key报错如何解决？

     轻量应用服务器所在地域	系统推荐的百炼API Key对应地域	Coding Plan的API key对应地域
     中国内地地域	华北2（北京）	华北2（北京）
     美国及欧洲地域	美国（弗吉尼亚）
     中国香港及其他亚洲地域	新加坡

   • 手动输入

     单击按钮切换至手动输入，输入百炼API Key并选择该API Key对应地域。

     

     重要

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

4. 单击 访问控制页面 下的 执行命令 ，获取OpenClaw对话的地址。

   

5. 在 帮助  >  Token配置 中单击 执行命令 ，查看并保存Token。

   

   警告

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

6. （可选）香港及海外地域可以配置使用联网搜索功能。

   1. 在 Brave Search官网 创建 Brave Search API 账户，并生成API密钥。

   2. 在镜像中配置，在MOLTBOT页面左侧导航栏，单击 Config  >  All Settings  >  Raw ，打开配置文件。将 BRAVE_API_KEY 更改为Brave Search API密钥，复制下面代码块到配置文件中，并粘贴到如图所示位置。

            
                "tools": {    "web": {      "search": {        "provider": "brave",        "apiKey": "BRAVE_API_KEY",        "maxResults": 5,        "timeoutSeconds": 30      }    }  },                                  
            
          

      

步骤三：创建并配置应用

1. 登录 飞书开发者后台 ，点击 创建企业自建应用 ，填写应用信息后单击创建。

2. 在左侧导航栏中单击 添加应用能力 ， 选择 按能力添加 页签，找到 机器人 卡片，点击 添加 。

3. 在左侧导航栏中单击 权限管理 ，单击开通权限，搜索并添加以下 API 权限：

   权限代码	用途说明	注意事项
   im:message:send_as_bot	允许机器人以应用身份发送消息。	必需权限。
   contact:user.employee_id:readonly	获取用户 user ID。	必需权限。
   im:message.group_at_msg:readonly	允许机器人接收群聊中 @ 它的消息。	核心交互权限。
   im:message.p2p_msg:readonly	允许机器人读取用户私聊发给它的消息。	单聊场景下必需。
   im:message.group_msg	允许机器人获取所在群组的所有消息。	敏感权限 。

4. 收集集成所需的凭证。后续配置 AppFlow 连接时需要使用这些信息。

   • 在左侧导航栏进入 凭证与基础信息 页面，查看并复制  App ID  和  App Secret 。

   • 在左侧导航栏进入 事件与回调 页面，找到加密策略页签。复制  Encrypt Key  和  Verification Token 。

     “ 若当前Encrypt Key 为空，可点击重置生成一个新Encrypt Key。

步骤四：创建飞书连接流

1. 访问 通过飞书使用MoltBot(ClawdBot)——多模态 ，并单击 立即使用 。

   “ 需要图片理解的场景下还需参考 如何更改OpenClaw调用的模型？ 将模型更换为对应业务场景的多模态模型。

2. 点击添加飞书鉴权凭证，填写凭证名称，及参考下图填入步骤三获取的信息。填写完成后单击确定并在下拉框中选中创建好的凭证。

   

3. 创建Moltbot鉴权凭证。填入步骤二获取的凭证，填写完成后单击确定并在下拉框中选中创建好的凭证。

4. 点击下一步，前往服务器详情页获取服务器公网地址并按页面提示填入 您的公网IP：端口号 ，端口号默认为18789。

   

5. 配置完成后点击发布，复制并保存您的WebhookUrl。

   

步骤五：配置飞书机器人

1. 返回 飞书开发者后台 ，在左侧导航栏单击 事件与回调 ，在 事件配置 页签，单击按钮配置 订阅方式 。

2. 选择 将事件发送至开发者服务器 ，并填写上一步复制的 WebhookUrl ，单击 保存 。

   

3. 在 事件配置 页签的 已添加事件 区域，单击 添加事件 ，搜索并添加 接收消息 事件。

4. 填写完成后，在左侧导航栏点击 版本管理与发布 ，创建版本或点击最新编辑的版本，填写完成相关信息后保存并提交审批。

   

方案验证

配置完成后，用户可以把机器人添加到某个群里，从而实现机器人和群内成员的互动。

“ 目前仅支持在飞书电脑端添加机器人。若需在外部群中使用机器人，可参考配置文档 机器人支持外部群和外部用户单聊 。

1. 按照添加路径添加机器人： ···  >  设置  >  群机器人  >  添加机器人  。

2. @机器人发送消息即可实现对话。

   

（可选）配置定时任务

重要

飞书机器人的Webhook地址需要在PC端获取，暂不支持从移动端获取。

1. 访问 定时调用OpenClaw并发送飞书消息 使用模板创建App连接流。

2. 在 用户授权 区域，单击 添加凭证 添加OpenClaw的Token。

3. 单击 使用生成工具 快速生成规则命令，以每小时重复任务为例，选择 时 页签，并选中 每小时 ，单击 确定 后系统会按照设置自动生成cron表达式。单击 验证cron和预览后5次执行时间 ，可预览验证cron表达式是否符合预期。

   “ 如果生成工具生成的频率无法满足您的需求，可参考 Cron表达式的使用 自行编写。

   

4. 配置执行动作：

   1. 输入指令： 填写想要定时执行的指令，如“提醒我每小时定点喝水100ml”。

   2. 公网地址：端口****： 格式为 您的轻量应用服务器公网IP:服务端口 ，若公网IP为 47.0.XX.XX ，服务端口为 18789 （服务端口默认为18789），则应填写 47.0.XX.XX:18789 。

   3. Webhook地址：

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

         

      2. 单击 添加机器人，选择自定义机器人。填写机器人名称和描述，单击 添加 ，复制 Webhook地址 并粘贴至AppFlow。

         “ 如果不想要所有ip地址都能访问webhook地址，可以单击 IP白名单 将 121.40.82.220, 47.97.73.42, 47.98.226.113, 47.96.151.112, 118.178.89.160, 120.27.202.100 地址加入。

         

5. 发布AppFlow。填写基本信息，并单击 发布 。流程发布后定时功能才会生效。

6. （可选）验证消息发送。单击 去列表查看 ，找到刚创建的连接流，在操作列单击 运行一次 ，可以触发一次运行并验证是否符合预期。

“ 若需更改定时规则可参考 如何更改定时任务的执行周期？

计费说明

在轻量应用服务器上部署并使用OpenClaw服务将产生以下费用：

• 轻量应用服务器费用： 参见 轻量应用服务器计费概述 。

• 模型调用费用： 购买轻量应用服务器镜像中OpenClaw存在默认配置的模型，根据您的购买时间，默认模型不同。

  • 2026年1月31日及后：默认使用  qwen3-max-2026-01-23  模型，计费详见 通义千问Max模型计费 。

  • 2026年1月30日前：默认使用  qwen-vl-plus  模型。计费详见 通义千问VL模型计费 。

模型调用成本控制

• 购买并配置百炼 Coding Plan ：为了在体验初期避免产生超出预期的费用，可以使用 Coding Plan 订阅，每 5 小时可调用指定额度，超出后自动禁用。若需使用Coding Plan，可以在部署完成后，参考 在OpenClaw中使用百炼购买的Coding Plan 修改配置。 Coding Plan仅支持抵扣 qwen3-max-2026-01-23 和 qwen3-coder-plus 模型调用费用。

• 配置免费额度用完即停 ：默认状态下，百炼大模型在免费额度消耗完后，继续使用会扣费，若您希望不产生超出免费额度外的模型调用费用，可前往百炼平台开启 免费额度用完即停 。

常见问题

如何让飞书中的OpenClaw机器人接收理解图片信息？

需要参考 步骤四：创建AppFlow连接流 更换支持多模态的AppFlow连接流模板后，参照重新配置并在OpenClaw中更换支持多模态的模型。

如何更改OpenClaw调用的模型？

1. 在 轻量应用服务器控制台-服务器页面 ，单击部署了OpenClaw的服务器卡片中的实例ID，进入 服务器概览 页面。

2. 单击 应用详情 页签，在 访问控制页面 单击 快速查看 可进入Clawdbot对话页面。

3. 单击 Config  >  Agents ，搜索 Primary Model ，更改为百炼中支持的模型，填写格式为 alibaba-cloud/模型Code ，如 alibaba-cloud/qwen3-max-2026-01-23 ，模型Code可以在 百炼模型广场 页面查询。

   重要

   当前不支持配置 qwen3-max 模型Code，可选择 qwen3-max-2026-01-23 或 qwen3-max-preview 等其他模型Code。

   

如何更改定时任务的执行周期？

可前往 AppFlow控制台-连接流 ，找到定时调用任务连接流，单击 连接流ID/名称 ，在右上角单击 编辑 ，找到第一个触发事件节点，单击后在 入参配置 中可重新配置定时任务的cron表达式。编辑完成后单击 发布 即可完成更新。