MoltBot(原ClawdBot)安装指南，接入企微、飞书、钉钉、QQ四大主流社交软件

润雨的AI开源日记
13 阅读9分钟

一、安装MoltBot

执行安装命令

npm install -g moltbot@latest

执行初始化命令

moltbot onboard --install-daemon

二、初始化过程

示意图说明
选择：Yes
选择：QuickStart
选择：OpenAI
根据自己的需要选择，如果后期要使用其他AI的话，这里请选择 OpenAI
选择：OpenAI API key
输入大模型 API Key
选择：Skip for now
* 新版中，支持直接配置国内主流社交平台，请查看第四部分
选yes，现在配置skill
选no，之后再配置
按“空格键”选中左图选项，“回车键”下一步
选择：Hatch in TUI (recommended)

三、接入大模型（可选）

如果初始化中，没有你想用的模型，可以按照此步骤单独接入

这里以豆包的coding计划为案例。

1.修改使用模型

打开 MoltBot 页面

在 Web UI 中，选择 Settings-Config-Authentication，在底部选择 Raw 方式查看配置信息。

在 agents 参数下，找到 model 和 models，改为您要接入的模型名称

"model": {
"primary": "doubao/doubao-seed-1-8-251228"
},
"models": {
"doubao/doubao-seed-1-8-251228": { "alias": "doubao" }
}

其中，doubao为平台名称，doubao-seed-1-8-251228为模型名称

2.配置模型平台

在 models 参数下，修改您要接入的 base_url 以及 API KEY。（可在平台后台获取）

"models": {
  "providers": {
    "doubao": {
      "baseUrl": "https://ark.cn-beijing.volces.com/api/v3",
      "apiKey": "YOUR_API_KEY",
      "api": "openai-completions"
    }
  }
}

baseUrl 为模型的请求地址

apiKey 为你自己的密钥

api 固定为 openai-completions

3.修改认证配置

在 auth 参数下，修改认证配置

"auth": {
  "profiles": {
    "doubao:default": { "provider": "doubao", "mode": "api_key" }
  }
}

4.保存配置并重启服务

在 MoltBot 配置界面完成修改后，先单击 Save，保存完成后单击 Update。

四、接入主流社交平台

企业微信

1.创建机器人

前往企业微信官网，使用有企业管理员权限的账号登录。如尚未拥有满足条件的企业，可以参考创建&注册企业来创建一个新企业，以此来体验Moltbot（Clawdbot）的能力。

在企业微信管理后台左侧导航依次找到并进入安全与管理 > 管理工具，并且在页面内点击创建机器人。

滑到页面最底端点击API模式创建按钮：

在切换后的页面，依次填写名称、简介、可见范围、URL，并且点击随机获取按钮生成Token和Encoding-AESKey（这是企业微信与Moltbot进行加密通信的密钥）。

此处需要关注，URL处提及的“实例IP地址”为你的公网IP地址。一般家用电脑是没有公网IP的，建议购买服务器部署。

http://公网IP地址:18789/wecom

示例： 比如我的公网IP地址是12.12.12.12，那么你就应该在企业微信机器人的URL处填入：http://12.12.12.12:18789/wecom

填写完成后，先不要点创建，而是需要回到登录服务器的页面准备进行接下来的配置。

2.连接机器人

此处我们首先假设你现在处于如图所示的步骤：

如果你没有，最简单的方法是：

重新执行clawdbot onboard，重新走一遍，直到你回到如上步骤。

接下来，我们直接选择WeCom（Plugin），回车确认：

接下来我们需要修改Moltbot的配置文件。

在 Web UI 中，选择 Settings-Config-Authentication，在底部选择 Raw 方式查看配置信息。

  "wecom": {
      "enabled": true,
      "webhookPath": "/wecom",
      "token": "填入创建企业微信机器人的页面，生成的Token",
      "encodingAESKey": "填入创建企业微信机器人的页面，生成的encodingAESKey",
      "receiveId": "",
      "dm": { "policy": "pairing" }
    }

输入完成后，保存并更新，重新启动网关。

如果没有外层的"channels":{}，那么参考上图手动拼一下就好了。

3.继续创建机器人

此时我们再回到企业微信机器人创建页，点击创建按钮

创建成功后，在接下来的页面中找到企业微信机器人的二维码，用手机扫码后添加。

添加完成后，即可在聊天窗中与它进行对话：

飞书

此处我们首先假设你现在处于如图所示的步骤：

1.创建机器人

  1. 访问飞书开发者平台（open.feishu.cn/app?lang=zh…

  2. 登录后，点击 “创建企业自建应用”；

  3. 填写应用基础信息：应用名称（如 “Moltbot 助手”），选择应用图标，点击 “创建” 按钮，进入应用管理页面。

4.添加机器人能力：在应用管理页左侧导航栏，找到并点击 “添加应用能力”，在弹出的列表中选择 “机器人”，点击 “添加”。

5.点击上方的创建版本并发布。

获取飞书应用凭证

  1. 在飞书应用管理页，左侧导航栏找到 “凭据与基础信息” 栏目，点击进入；

  2. 在页面中找到 “App ID” 和 “App Secret” 两个参数，分别点击右侧 “复制” 按钮，将其保存到记事本或备忘录中；

3.保存完成后，不要关闭飞书开发者平台页面，后续配置权限还需使用。

2.连接机器人

输入APP id 与 APP Secret

输入上一步获取到的id与secret，回车确认；

后续按正常流程运行即可~

3.配置机器人

飞书应用权限与事件配置

此步骤分为「事件配置」「权限配置」「应用发布」三部分，全程在飞书开发者平台操作，按顺序执行：

（1）事件配置

  1. 在飞书应用管理页，左侧导航栏找到 “事件与回调” 栏目，点击进入；

  2. 事件配置：在页面中选择 “长连接”，点击 “保存”；

descript

3.添加事件：点击页面中的 “添加事件”，在弹出的事件列表中，选择 “消息与群组” 分类，勾选 “接收消息”，点击 “确定”，完成事件订阅。

descript

4.回调配置：订阅方式选择 “使用长连接”，无需填写其他地址，配置自动生效。

descript

（2）权限配置

  1. 在飞书应用管理页，左侧导航栏找到 “权限管理” 栏目，点击进入；

  2. 点击页面中的 “批量导入权限” 按钮，弹出权限导入窗口；

descript

descript

3.复制以下 JSON 代码，粘贴到导入窗口的输入框中，点击 “导入” 按钮，等待权限导入完成：

代码语言：txt

AI代码解释

{
  "scopes": {
    "tenant": [
      "contact:user.base:readonly",
      "im:chat",
      "im:chat:read",
      "im:chat:update",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": []
  }
}

4.导入验证：页面显示 “导入成功”，且权限列表中出现上述导入的权限，即为配置完成。

（3）发布应用

  1. 在飞书应用管理页，左侧导航栏找到 “版本管理与发布” 栏目，点击进入；

  2. 点击右上角的新建版本；

descript

填写版本号与描述后，保存并发布；

4.启动服务

回到命令行界面，输入以下命令，启动后不要关闭命令行窗口：

clawdbot gateway

5.验证服务

  1. 打开手机或电脑端飞书 APP，登录与飞书开发者平台相同的账号；

  2. 在飞书首页，找到 “工作台” 入口，点击进入，在工作台列表中找到已发布的 Moltbot 应用（如 “Moltbot 助手”），点击进入；

  3. 系统将自动启动私聊窗口，发送任意消息（如 “你好”“查询今日日程”）；

  4. 验证结果：如果收到 Moltbot 的回复，即为飞书接入成功

钉钉

首先完成初始化，启动MoltBot

1.安装钉钉插件

执行命令 clawdbot plugins install clawdbot-dingtalk 安装插件

执行命令 clawdbot onboard 开始初始化

2.初始化

选择钉钉作为频道

3.创建机器人

前往钉钉开发者平台（需有管理员权限）：https://open-dev.dingtalk.com/fe/app?hash=%23%2Fcorp%2Fapp#/corp/app

点击创建应用

选机器人

完成所有必填项（其他默认）

点击 凭证与基础信息 保存好Client ID与Client Secret，后面会用到

点击 查看版本详情 >> 编辑

完成所有必填项后点击保存，在弹出的窗口点击 确认发布

4.连接机器人

接下来我们需要修改Moltbot的配置文件。

在 Web UI 中，选择 Settings-Config-Authentication，在底部选择 Raw 方式查看配置信息。

在meta后面增加下列内容，记得把clientId和clientSecret替换为自己的实际值

   "channels" : {
     "dingtalk" : {
       "enabled" : true ,
       "clientId" : "your-dingtalk-client-id" ,
       "clientSecret" : "your-dingtalk-client-secret"
    }
  },

保存后重新启动

5.验证机器人

QQ Bot

1.安装插件

执行命令 git clone https://github.com/sliverp/qqbot.git && clawdbot plugins install ./qqbot 安装QQ机器人插件

2.创建机器人

在QQ开放平台创建机器人，自己使用无需企业资质，指定用户，指定群聊可访问即可

q.qq.com/#/apps

如果是新用户的话，注册流程会有点繁琐，但是没有什么难点，按照要求填写自己的个人信息就行

注册完整之后就可以创建属于自己的机器人了：

点击你的机器人头像进入到机器人管理员界面

在管理页面获取到当前机器人的AppID, 和AppSecret，这两个很重要

启用QQ连接插件,填写你的AppID和AppSecret

clawdbot channels add --channel qqbot --token "<AppID>:<AppSecret>"

别忘了在IP白名单哪里，填上自己的服务器的公网IP哦~

重启gateway

clawdbot gateway restart

到这里就全部结束拉，在手机QQ和电脑版上均可以使用。

记得把他拉进群聊，大家一起调戏才更有意思哦~

由于QQ开放平台的限制，在正式上线之前只能在特定范围内使用，但是已经可以愉快的跟自己的“贾维斯”聊天了，群里的小伙伴都可以使用哦，快来试试吧~https://q.qq.com/qqbot/#/developer/sandbox

找不到自己的机器人的话，可以扫描“添加成员”旁边的二维码，扫码添加机器人到自己的聊天界面

五、交流群

添加润雨： runyut 拉你进MoltBot交流群哦~，记得备注哪里来的。

avatar
文章
阅读
粉丝