使用moltbot搭建个人AI助手

应用场景

随着技术的发展，个人AI助手已经成为提高工作效率和生活质量的重要工具。在日常的在线交流中，用户经常需要与不同的AI助手进行互动，以获取信息或完成任务。然而，这些AI助手往往局限于特定的平台或模型，导致用户体验不佳。

Moltbot作为一种能够持续运行的AI智能体，能够调用多种大型语言模型，并作为网关，使用户可以通过聊天软件与多个AI模型进行交互，无需在不同平台之间切换，简化了操作流程，从而提高效率和满意度。Moltbot支持的平台有WhatsApp、Telegram、Discord、Slack、iMessage、Signal、企业微信（Feishu/飞书集成）等 50 多个平台，它区别于普通聊天机器人（如 ChatGPT）的最大特点是主动性，它能主动给你发消息，例如提醒会议、报告天气异常或在你关注的股票达到阈值时通知你。由于部署在服务器上，它能直接读写服务器文件、执行 Shell 终端命令、甚至管理服务器。

本文档介绍如何在Flexus L实例上使用Moltbot应用镜像结合飞书快速入搭建个人AI助手。

资源和成本规划

资源	资源配置	说明
云主机	CPU：2核内存：2GiB	Moltbot应用镜像运行的最低配置为2核2GiB，您可根据您的业务需求选择Flexus应用服务器L实例规格。
镜像	Moltbot应用镜像	购买Flexus L实例时选择Moltbot应用镜像。
网络	弹性公网IP	Flexus L实例默认分配一个固定的弹性公网IP地址、私有IP地址。
安全组	入方向规则：协议/应用：TCP 端口：18789 源地址：0.0.0.0/0	18789：允许访问Moltbot。

操作流程

操作步骤	说明
步骤一：购买Flexus应用服务器L实例	购买Flexus应用服务器L实例，选择Moltbot应用镜像一键部署Flexus L实例。
步骤二：配置安全组	配置安全组的入方向访问规则，放通18789端口，确保可以正常访问应用。
步骤三：重置密码并登录Flexus L实例	Flexus L实例无初始密码，创建Flexus L实例后，请先设置Flexus L实例的密码。
步骤四：配置Moltbot初始化	登录Flexus L实例服务进行Moltbot初始化。
步骤五：对接聊天软件	以对接飞书为例，配置相关信息以搭建AI助手。

步骤一：购买Flexus应用服务器L实例

登录Flexus应用服务器L实例控制台。
单击“购买Flexus L实例”，在下拉列表中选择“购买Flexus应用服务器L实例”。

对Flexus应用服务器L实例进行资源配置。

参数	示例	说明
区域	北京-北京四	请就近选择靠近您业务的区域，可减少网络时延，提高访问速度。Flexus应用服务器L实例创建后无法更换区域，请谨慎选择。
应用镜像	Moltbot	选择Moltbot应用镜像。
实例规格	2核2G、系统盘40GiB	选择实例规格。
实例名称	Moltbot-Example	请自定义方便您识别的实例名称，例如Moltbot-Example。
您可能需要（可选）	数据盘：10GiB 主机安全云备份：50GB	请根据您的业务需要自主选择数据盘、主机安全、云备份附加服务并设置规格。
购买时长	1个月	单次购买最短为1个月，最长为3年。 Flexus应用服务器L实例支持自动续费功能。勾选后，在Flexus应用服务器L实例到期前自动续费。如果您购买时未开通自动续费，后续仍可以在控制台开通。自动续费的更多信息详见自动续费。
购买数量	1台	设置您购买的Flexus应用服务器L实例数量。

单击“立即购买”，根据页面提示完成购买。
单击“返回华为云Flexus云服务控制台”，查看已创建的Flexus应用服务器L实例。

步骤二：配置安全组

在Flexus应用服务器L实例控制台，单击资源卡片或名称，进入资源页面。
在左侧列表中选择“云主机 VM”，单击云主机名称，进入云主机详情页面。

选择“安全组”页签，单击“添加规则”，放通18789端口，确保可以正常访问应用。

本例在默认安全组基础上只添加基本规则，您可根据需要添加更多规则。建议您将安全组规则设置为仅允许已知的IP地址访问。

点击放大

表1 安全组规则
优先级	策略	类型	协议端口	源地址	描述
1	允许	IPv4	TCP：18789	0.0.0.0/0	允许访问Moltbot。
1	允许	IPv4	全部	sg-default-smb	针对全部IPv4协议，允许本安全组内实例的请求进入，即该条规则确保安全组内的实例网络互通。
1	允许	IPv6	全部	sg-default-smb	针对全部IPv6协议，允许本安全组内实例的请求进入，即该条规则确保安全组内的实例网络互通。

步骤三：重置密码并登录Flexus L实例

在资源卡片上，单击图标，单击“重置密码”，或者在列表视图中单击操作列下的“重置密码”，设置Flexus L实例的密码。
Flexus L实例无初始密码，登录Flexus L实例前请先设置Flexus L实例密码。更详细的操作步骤参见重置Flexus L实例密码。

图1 重置密码
单击资源卡片上的“远程登录”按钮，或者单击列表视图操作列下的“远程登录”，在弹出的登录窗口中，单击“VNC登录”，根据界面提示，输入用户名密码登录Flexus L实例。更多登录方式请参见登录方式概述。
用户名为root，密码为步骤2设置的密码。

步骤四：配置Moltbot初始化

登录服务器后，执行以下命令，进行初始化。
```
clawdbot onboard
```
运行以上命令后，需要通过键盘来完成后续配置动作：方向键控制选项，回车键表示选择并确认，空格键表示选中选项。

图2 初始化
选择配置模式（Onboarding mode），此处以快速入门（quickstart）为例。
图3 选择快速开始模式

图4 选择 Update values
选择模型提供商（Model/auth provider），此处跳过。
图5 选择模型提供商
选择消息平台（Select channel）此时选择最后一项，暂时跳过。
图6 选择消息平台
按需安装skills，空格勾选需要的skill。
图7 按需安装skills
选择pnpm作为node包管理工具，按空格键勾选需要的skill。
图8 配置包管理工具

图9 按需配置API key
开启hooks，建议按空格键勾选默认的三个。
图10 开启hooks

图11 重启网关服务
启动UI，选择Web UI，后续可以在本地通过命令ssh -N -L 18789:127.0.0.1:18789 root@ECS_PUBLIC_IP，建立一个加密的 SSH 隧道，将远程服务器的Web UI服务映射到本地机器的端口上，在本地浏览器访问http://localhost:18789即可。
图12 启动UI
初始化完成。
图13 初始化完成

步骤五：对接聊天软件

本示例使用飞书搭建AI助手，对接飞书依赖开源社区的飞书插件实现Moltbot与飞书的配置链接，Moltbot应用镜像已默认安装此插件。

登录飞书开放平台，选择已有应用。如果没有自建应用，可以单击“创建企业自建应用”。
图14 选择应用
在左侧菜单单击添加应用能力，然后添加机器人。
图15 添加机器人

配置相关权限，允许机器人拥有获取信息等基础能力。选择左侧菜单的权限管理，单击批量导入/导出权限，导入以下权限：

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

图16 配置权限
点击放大

发布版本。单击页面左上方的创建版本，填写版本号（如1.0.0）、更新说明，单击保存后确认发布。
图17 发布版本
获取凭证。选择左侧菜单的凭证与基础信息，复制App ID、App Secret用于下一步。
图18 获取凭证

登录已部署Moltbot的服务器，执行以下命令，其中appId和appSecret以上一步的实际值为准。

clawdbot config set channels.feishu.appId "cli_xxxxx"
clawdbot config set channels.feishu.appSecret "your_app_secret"
clawdbot gateway restart

图19 配置凭证
点击放大

配置华为云MaaS上的模型。
1. 前往MaaS控制台获取如下参数：
  - Base URL：即接口信息中的API地址。
  - API key：按界面提示创建新的API Key或使用已有API Key。
  - 模型ID：即接口信息中的model参数，本示例使用deepseek-v3.2。
  图20 MaaS控制台
  
  图21 获取MaaS参数
2. 输入以下命令，然后根据提示依次输入Base URL，API key和模型ID。
```
wget https://documentation-samples.obs.cn-north-4.myhuaweicloud.com/solution-as-code-publicbucket/solution-as-code-moudle/deploying-clawdbot-agents/userdata/clawdbot.sh
sh clawdbot.sh
```
  图22 配置MaaS
配置事件回调。选择左侧菜单的事件与回调，在事件配置页签配置订阅方式，选择使用长连接接收事件。单击添加事件，搜索接收消息，选中后确认添加。
图23 配置回调
再次发布版本。单击页面左上方的创建版本，填写版本号（如1.0.1）、更新说明，单击保存后确认发布。
测试对话。在飞书APP中的开发者小助手对话框中可以看到版本发布成功的提示，单击打开应用即可进入机器人的聊天窗口，可以与机器人直接对话测试效果。
图24 测试对话