Moltbot集成飞书

步骤一、购买Moltbot套餐

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

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

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

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

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

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

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

步骤二、配置Moltbot

1. 在阿里云百炼大模型服务平台前往密钥管理页面，单击创建API-Key。

   警告

   请妥善保管百炼 API-Key。若发生泄露，第三方将有机会冒用您的身份进行恶意使用，产生超出预期的token费用。

2. 在服务器页面，单击服务器卡片中的实例ID，进入服务器概览页面。

3. 单击应用详情页签，配置Moltbot。

   

   1. 端口放通：需要放通对应端口的防火墙，单击一键放通即可。

   2. 配置Moltbot：单击执行命令，输入百炼的API-Key，单击下一步。

   3. 访问控制页面：单击执行命令可获取Clawdbot对话的地址。

4. 查看Token。在帮助 > Token配置中单击执行命令，获取Token。

   警告

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

5. 开启ResponseAPI访问，后续AppFlow会通过API访问Moltbot。

   1. 在Clawdbot页面左侧导航栏，单击Setting > Config。

   2. 在Config页面左侧导航栏单击Gateway，切换至Http页签，在Responses区域将Enabled切换至开启，单击Save。

      

步骤三：创建并配置应用

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. 访问AppFlow模版中心飞书-Moltbot模版，单击立即使用。

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

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

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

   

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

   

步骤五：配置飞书机器人

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

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

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

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

   

方案验证

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

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

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

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