Moltbot(原Clawdbot)企业微信集成

更新时间:
复制为 MD 格式

通过阿里云应用连接器(AppFlow)可以将Moltbot服务与企业微信集成,实现在群聊中,通过自然语言直接与Moltbot交互。

步骤一、购买Moltbot套餐

重要

如果您已购买轻量应用服务器,可以跳过此步骤,以重置系统的方式部署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。

    image

    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

      image

步骤三、创建AppFlow连接流

  1. 单击Appflow-企业微信智能机器人使用Moltbot(Clawdbot),选择立即使用。

  2. 添加一个新的企业微信智能机器人凭证,填写完成后点击确定

    • 凭证名称:AppFlow凭证展示名称,可任意填写

    • 机器人名称:智能机器人展示名称,后续微信需配置一致名称。

    • Token:可点击右侧刷新按钮随机获取,复制保存,后续微信配置使用

    • EncodingAESKey:可点击右侧刷新按钮随机获取,复制保存,后续微信配置使用

  3. 填入步骤二获取的Token信息,填写完成后单击确定并在下拉框中选中创建好的凭证。

  4. 单击下一步,按页面提示填入模型名称、轻量应用服务器公网IP及服务端口。

  5. 填写连接流名称和描述,配置完成后单击下一步完成创建。点击发布后,复制并保存WebhookUrl。image

步骤四、创建企业微信智能机器人

  1. 访问企业微信管理后台,在左侧导航栏单击管理工具 > 智能机器人image

  2. 选择API模式创建

    image

  3. 按照页面提示填写名称、简介以及可见范围,完成后单击保存。填写过程中需注意以下事项:image

    • 机器人名称需保证与步骤三配置的AppFlow凭证中填写的机器人名称一致。

    • URL填写步骤三中在AppFlow保存的WebhookUrl。

    • TokenEncoding-AESKey填写在AppFlow步骤三中复制保存的对应值。

    • 若域名主体校验未通过,可参考常见问题域名主体校验未通过怎么办?配置解决。

方案验证

  1. 在群聊中点击添加群成员,搜索创建完成的机器人名称加入群聊

    image

  2. 在已添加机器人的群中@机器人即可实现流式对话,效果如下:

    image

常见问题

域名主体校验未通过怎么办?

您在创建保存智能机器人的过程中,可能会遇到“域名主体校验未通过,需配置备案主体与当前企业主体相同或有关联关系的域名”的报错。该问题通常由企业微信的相关限制所引起,您需要配置一个企业自有域名解决此问题。

  • 如果您的域名已在阿里云备案,可以参考如下步骤创建一个二级域名作为企业自有域名。

    1. 访问AppFlow域名管理页面,单击添加域名按钮,进入添加域名页面,填入可用的二级域名,如airobot.example.com

    image.png

    1. 参考CNAME 记录,将该二级域名解析到上一步的记录值

    2. 解析配置完成后,返回创建域名页面,点击提交

    3. 使用该二级域名替换配置API接收消息URL(即已经填写的WebhookUrl)中的主机名。例如:

      • AppFlow获取的WebhookUrl:https://123123123.appflow.aliyunnest.com/webhook/a479a8f17

      • 企业域名:airobot.example.com

        则您最终需要填写的域名为http://airobot.example.com/webhook/a479a8f17