阿里云 OpenClaw(原Moltbot、Clawdbot)集成飞书(保姆级教程)
通过阿里云应用连接器(AppFlow)可以将 OpenClaw 服务与飞书集成,实现在飞书群聊或单聊中,通过自然语言直接与 OpenClaw 交互。
步骤一、购买 OpenClaw 套餐
购买链接在这里购买预装 Moltbot 应用的轻量应用服务器。
详细配置说明:
-
在轻量应用服务器页面,预置了资源配置,如要更改配置项,请参考下面内容。
- 实例:内存必须 2GiB 及以上,可以根据自己的需求切换套餐。
- 地域:默认美国(弗吉尼亚)。
- 重要提示:目前中国内地地域(除香港)的轻量应用服务器,无法使用 OpenClaw 的联网搜索功能。
- 购买配置:默认 12 个月,可以根据自己的需求切换时长。
步骤二、配置 OpenClaw
先默认选择阿里的大模型,后续会讲如何切换,我们首先跑通流程:
-
在阿里云百炼大模型服务平台前往密钥管理页面,单击创建 API-Key。
- 接入的模型默认是 qwen3-max-2026-01-23
- 新用户有 1,000,000 的免费额度,用完就要产生费用
- 后面我们讲一下如何接入 nvidia 的免费 minimax-m2 大模型
-
在服务器页面,单击服务器卡片中的实例 ID,进入服务器概览页面。
-
单击应用详情页签,配置 OpenClaw。
- 端口放通:需要放通对应端口的防火墙,单击一键放通即可。
- 配置 OpenClaw:单击执行命令,输入百炼的 API-Key,单击下一步。
- 访问控制页面:单击执行命令可获取 Clawdbot 对话的地址。
- 查看 Token:在帮助 > Token 配置中单击执行命令,获取 Token。
-
开启 Response API 访问,后续 AppFlow 会通过 API 访问 OpenClaw。
- 在 Clawdbot 页面左侧导航栏,单击 Setting > Config。
- 在 Config 页面左侧导航栏单击 Gateway,切换至 Http 页签,在 Responses 区域将 Enabled 切换至开启,单击 Save。
步骤三:创建并配置应用
- 登录飞书开发者后台,点击创建企业自建应用,填写应用信息后单击创建。
- 在左侧导航栏中单击添加应用能力,选择按能力添加页签,找到机器人卡片,点击添加。
- 在左侧导航栏中单击权限管理,单击开通权限,搜索并添加以下 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:readonly | 允许机器人获取所在群组的所有消息。 | 敏感权限。 |
- 收集集成所需的凭证。后续配置 AppFlow 连接时需要使用这些信息。
-
在左侧导航栏进入凭证与基础信息页面,查看并复制 App ID 和 App Secret。
-
在左侧导航栏进入事件与回调页面,找到加密策略页签。复制 Encrypt Key 和 Verification Token。 若当前 Encrypt Key 为空,可点击重置生成一个新的 Encrypt Key。
-
步骤四:创建飞书连接流
-
访问 AppFlow 模板中心飞书-OpenClaw 模板,单击立即使用。
-
点击添加飞书鉴权凭证,填写凭证名称(随便填写),及参考下图填入步骤三获取的信息。填写完成后单击确定并在下拉框中选中创建好的凭证。
-
创建 Moltbot 鉴权凭证。填入步骤二获取的凭证,填写完成后单击确定并在下拉框中选中创建好的凭证。
-
点击下一步,前往服务器详情页获取服务器公网地址并按页面提示填入您的公网IP:端口号,端口号默认为 18789。 例如:48.253.178.133:18789
-
配置完成后点击发布,复制并保存您的 Webhook Url。
步骤五:配置飞书机器人
🖼️ 飞书事件配置页面:
显示事件与回调页面,事件配置页签的位置。
-
返回 飞书开发者后台,在左侧导航栏单击事件与回调,在事件配置页签,单击按钮配置订阅方式。
-
选择将事件发送至开发者服务器,并填写上一步复制的 Webhook Url,单击保存。
-
在事件配置页签的已添加事件区域,单击添加事件,搜索并添加接收消息事件。这步很关键,不设置,群里机器人是不会收到你的消息的
-
填写完成后,在左侧导航栏点击版本管理与发布,创建版本或点击最新编辑的版本,填写完成相关信息后保存并提交审批。
方案验证
配置完成后,用户可以把机器人添加到某个群里,从而实现机器人和群内成员的互动。
目前仅支持在飞书电脑端添加机器人。若需在外部群中使用机器人,可参考配置文档机器人支持外部群和外部用户单聊。
🖼️ 添加机器人界面截图:
展示添加机器人的路径:··· > 设置 > 群机器人 > 添加机器人。
- 按照添加路径添加机器人:··· > 设置 > 群机器人 > 添加机器人。
- @机器人发送消息即可实现对话。