
# 使用Moltbot搭建个人AI助手（飞书）--旧版
#### 操作场景
Flexus L实例提供的Moltbot 26.1.24版本应用镜像当前已下线，如需新购请参考[OpenClaw最佳实践汇总](https://support.huaweicloud.com/bestpractice-flexusl/flexusl_bp_0001.html)选择OpenClaw应用镜像。
如果您希望切换镜像至OpenClaw应用镜像，请先确认规格配置是否满足，OpenClaw应用镜像的运行配置建议选择2核4GiB及以上。
- 若L实例规格较低，请先升级规格，再切换镜像至OpenClaw应用镜像。
- 若L实例规格满足，请切换镜像至OpenClaw应用镜像。
更多操作请参考[变更Flexus L实例规格](https://support.huaweicloud.com/usermanual-flexusl/instance_admin_0003.html)、[切换单台Flexus L实例操作系统](https://support.huaweicloud.com/usermanual-flexusl/instance_os_0003.html)。
本文档介绍如何在Flexus L实例上使用Moltbot 26.1.24版本应用镜像结合飞书快速搭建个人AI助手。
![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/note_3.0-zh-cn.png)
Flexus L实例提供的Moltbot 26.1.24版本和OpenClaw应用镜像均使用官方开源脚本安装，部署前请阅读[OpenClaw风险说明及安全建议](https://support.huaweicloud.com/bestpractice-flexusl/flexusl_bp_0010.html)。
#### 前提条件
已购买装有Moltbot 26.1.24版本应用镜像的Flexus L实例。
您可以登录Flexus应用服务器L实例[控制台](https://console.huaweicloud.com/smb/?&locale=zh-cn#/resource/list)，在L实例资源卡片上查看应用镜像版本。
图1查看应用镜像版本   
![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002550205285.png "点击放大")
#### 操作流程
| 操作步骤                                                          | 说明                                               |
|:---|:---|
| [步骤一：配置安全组]           | 配置安全组的入方向访问规则，使用Flexus L实例默认安全组（sg-default-smb）。 |
| [步骤二：重置密码并登录Flexus L实例] | Flexus L实例无初始密码，创建Flexus L实例后，请先设置Flexus L实例的密码。 |
| [步骤三：配置Moltbot初始化]     | 登录Flexus L实例服务进行Moltbot初始化。                      |
| [步骤四：对接通讯软件]          | 以对接飞书为例，配置相关信息以搭建AI助手。                           |
   
 #### 步骤一：配置安全组
1. 在[Flexus应用服务器L实例控制台](https://console.huaweicloud.com/smb/?&locale=zh-cn#/resource/list)，单击资源卡片或名称，进入资源页面。
2. 选择"安全组"页签，入方向规则确保使用以下默认安全组规则。 本例使用默认安全组，您可根据需要添加更多规则。
   ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/note_3.0-zh-cn.png)
   安全组入方向规则的源地址设置为0.0.0.0/0或::/0，表示允许或拒绝所有外部IP地址访问您的实例，如果将"22、3389、8848"等高危端口暴露到公网，可能导致网络入侵，造成业务中断、数据泄露或数据勒索等严重后果。**建议您将安全组规则设置为仅允许已知的IP地址访问。**
   ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002550160849.png "点击放大")
   表1安全组入方向规则 
   | 优先级 | 策略 | 类型   | 协议端口   | 源地址            | 描述                                            |
   |:---|:---|:---|:---|:---|:---|
   | 1   | 允许 | IPv4 | TCP：全部 | sg-default-smb | 针对全部IPv4协议，允许本安全组内实例的请求进入，即该条规则确保安全组内的实例网络互通。 |
   | 1   | 允许 | IPv6 | TCP：全部 | sg-default-smb | 针对全部IPv6协议，允许本安全组内实例的请求进入，即该条规则确保安全组内的实例网络互通。 |
      
   
 
 #### 步骤二：重置密码并登录Flexus L实例
1. 在资源卡片上，单击![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002176109417.png)图标，单击"重置密码"，或者在列表视图中单击操作列下的"重置密码"，设置Flexus L实例的密码。
   Flexus L实例无初始密码，登录Flexus L实例前请先设置Flexus L实例密码。更详细的操作步骤参见[重置Flexus L实例密码](https://support.huaweicloud.com/usermanual-flexusl/instance_admin_0002.html)。
   图2重置密码   
   ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002078946216.png "点击放大") 
2. 单击资源卡片上的"远程登录"按钮，或者单击列表视图操作列下的"远程登录"，在弹出的登录窗口中，单击"VNC登录"，根据界面提示，输入用户名密码登录Flexus L实例。更多登录方式请参见[登录方式概述](https://support.huaweicloud.com/usermanual-flexusl/server_login_0001.html)。
   用户名为root，密码为上一步设置的密码。
   ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002550200853.png "点击放大")
   
 
 #### 步骤三：配置Moltbot初始化
1. 登录服务器后，执行以下命令，根据界面引导信息开始初始化。
   ```
   clawdbot onboard
   ```
   ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/note_3.0-zh-cn.png)
   - 运行以上命令后，需要通过键盘来完成后续配置动作：方向键控制选项，空格键表示勾选选项，回车键表示选择并确认。
   
   - 请参考[OpenClaw（Moltbot）社区文档](https://docs.openclaw.ai/start/onboarding)充分了解相关风险说明后再开始初始化。
    
   ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002518721006.png "点击放大")
   
2. 选择配置模式（Onboarding mode），此处以快速入门（QuickStart）为例。
   1. 选择QuickStart模式。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002518561096.png "点击放大")
      
   
   2. 选择Update values。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002550160851.png)
      
    
3. 配置模型信息。
   1. 选择模型提供商（Model/auth provider），此处选择Skip for now跳过。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002550200855.png)
      
   
   2. 选择All provider。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002518721008.png)
      
   
   3. 默认模型选择Keep current。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002518561100.png)
      
    
4. 选择消息平台（Select channel），此处选择Skip for now跳过。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002550160853.png)
   
5. 按需安装skills，此处选择Yes。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002550200857.png "点击放大")
   
6. 选择pnpm作为node包管理工具，按空格键勾选需要的skill。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002518721010.png "点击放大")
   
7. 按需配置API key，此处均选择No。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002518561102.png "点击放大")
   
8. 开启hooks，建议按空格键勾选默认的三个hooks。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002550160855.png "点击放大")
   
9. 显示如下信息表示初始化完成。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002518561104.png "点击放大")
   
 
 #### 步骤四：对接通讯软件
本示例使用飞书搭建AI助手，对接飞书依赖开源社区的[飞书插件](https://github.com/m1heng/clawdbot-feishu)实现Moltbot与飞书的配置链接，Moltbot应用镜像已默认安装此插件。
1. 登录[飞书开放平台](https://open.feishu.cn/app?lang=zh-CN)，选择已有应用。如果没有自建应用，可以单击"创建企业自建应用"。
   图3选择应用   
   ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002550160857.png "点击放大") 
2. 在左侧菜单单击添加应用能力，然后添加机器人。
   图4添加机器人   
   ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002550200861.png "点击放大") 
3. 配置相关权限，允许机器人拥有获取信息等基础能力。选择左侧菜单的权限管理，单击批量导入/导出权限，导入以下权限：
   ```
   {
     "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": []
     }
   }
   ```
   图5配置权限   
   ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002518721014.png "点击放大") 
4. 发布版本。单击页面左上方的创建版本，填写版本号（如1.0.0）、更新说明，单击保存后确认发布。
   图6发布版本   
   ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002518561108.png "点击放大") 
5. 获取凭证。选择左侧菜单的凭证与基础信息，复制App ID、App Secret用于下一步。
   图7获取凭证   
   ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002550160859.png "点击放大") 
6. 登录已部署Moltbot的服务器，执行以下命令，其中appId和appSecret以上一步的实际值为准。
   ```
   clawdbot config set channels.feishu.appId "cli_xxxxx"
   clawdbot config set channels.feishu.appSecret "your_app_secret"
   clawdbot gateway restart
   ```
   图8配置凭证   
   ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002550200863.png "点击放大") 
7. 配置华为云MaaS上的模型。
   1. 前往[MaaS控制台](https://console.huaweicloud.com/modelarts/?#/model-studio/deployment)查找目标模型，您可以选择已开通模型或者开通更多模型，在模型的调用信息中选择版本，本示例使用deepseek-v3.2。
      图9MaaS控制台   
      ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002518721016.png "点击放大") 
   
   2. 在模型的调用说明中获取如下参数。
      - Base URL：即接口信息中的API地址。
      
      - API key：按界面提示创建新的API Key或使用已有API Key。
      
      - 模型ID：即接口信息中的model参数。
      
      
      ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002518561110.png "点击放大")
      
   
   3. 输入以下命令，然后根据提示依次输入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/maas.sh
      sh maas.sh
      ```
      图10配置MaaS   
      ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002550160861.png "点击放大") 
    
8. 配置事件回调。选择左侧菜单的事件与回调，在事件配置页签配置订阅方式，选择使用长连接接收事件。
   单击添加事件，搜索接收消息，选中后确认添加。
   图11配置回调   
   ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002518721018.png "点击放大") 
9. 再次发布版本。单击页面左上方的创建版本，填写版本号（如1.0.1）、更新说明，单击保存后确认发布。
   图12再次发布   
   ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002518561112.png "点击放大") 
10. 测试对话。在飞书APP中的开发者小助手对话框中可以看到版本发布成功的提示，单击打开应用即可进入机器人的聊天窗口，可以与机器人直接对话测试效果。
    图13测试对话   
    ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002550160863.png) 
 
#### 常见问题
- Moltbot初始化配置错误后，如何重新开始初始化？
  1. 请登录已部署Moltbot的云主机，执行以下命令删除旧的配置文件。
     ```
     rm -f /root/.clawdbot/clawdbot.json
     ```
     
  
  2. 重新执行[步骤三：配置Moltbot初始化]、[步骤四：对接通讯软件]。
   
- 如何修改已配置的模型？
  - 如果已按照本文档配置华为云MaaS的模型，请按照步骤四中的第[7]步进行修改。
  
  - 如果是第三方模型，请参考对应开源社区文档。
   
 
#### 相关文档
- [通过控制台VNC登录Flexus L实例](https://support.huaweicloud.com/usermanual-flexusl/server_login_0002.html)
- [在线或离线重置Flexus L实例密码](https://support.huaweicloud.com/usermanual-flexusl/instance_admin_0006.html)
- [配置Flexus L实例安全组规则](https://support.huaweicloud.com/usermanual-flexusl/security_admin_0004.html)
 
