使用Hermes Agent搭建个人AI助手（飞书）

应用场景

Hermes Agent是一款由Nous Research推出的开源自主AI智能体，以MIT协议开放使用，主打跨会话持久记忆、自主提炼可复用技能、多平台接入与多模型切换能力，能够在持续使用中不断适配用户习惯，实现能力的自我迭代。

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

步骤一：部署Hermes Agent应用镜像的L实例

您可以新购买Hermes Agent应用镜像的L实例，也可以使用已有L实例部署Hermes Agent应用镜像。

步骤二：创建飞书机器人

1. 登录飞书开放平台，选择已有应用。如果没有自建应用，可以单击“创建企业自建应用”。
   图1 选择应用
   
2. 在左侧菜单单击“添加应用能力”，然后添加机器人。
   图2 添加机器人
   
3. 配置相关权限，允许机器人拥有获取信息等基础能力。选择左侧菜单的权限管理，单击“批量导入/导出权限”，导入以下权限：

   {
     "scopes": {
       "tenant": [
         "contact:contact.base:readonly",
         "docx:document",
         "docx:document.block:convert",
         "docx:document:readonly",
         "drive:drive",
         "drive:drive:readonly",
         "im:message",
         "im:message.group_at_msg:readonly",
         "im:message.group_msg",
         "im:message.p2p_msg:readonly",
         "im:message.reactions:read",
         "im:message:readonly",
         "im:message:recall",
         "im:message:send_as_bot",
         "im:message:update",
         "im:resource",
         "wiki:wiki",
         "wiki:wiki:readonly",
         "cardkit:card:write",
         "contact:user.id:readonly"
       ],
       "user": []
     }
   }

   图3 配置权限
   
4. 发布版本。单击页面左上方的“创建版本”，填写版本号（如1.0.0）、更新说明，单击“保存”后确认发布。
   图4 发布版本
   
5. 获取凭证。选择左侧菜单的凭证与基础信息，复制App ID、App Secret用于后续Hermes配置的填写。
   图5 获取凭证
   

（可选）步骤三：配置安全组

创建Flexus L实例时，系统会自动为您创建默认安全组（sg-default-smb）并关联至该实例。默认安全组仅确保安全组内实例互通，默认拒绝所有外部请求进入实例。本示例使用默认安全组及默认安全组规则，您可以按照本步骤进行查看。

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

   

3. 选择“安全组”页签，入方向规则确保使用以下默认安全组规则。

   您也可以根据实际需要添加更多规则，详情请参见配置Flexus L实例安全组规则。

   

   安全组入方向规则的源地址设置为0.0.0.0/0或::/0，表示允许或拒绝所有外部IP地址访问您的实例，如果将“22、3389、8848”等高危端口暴露到公网，可能导致网络入侵，造成业务中断、数据泄露或数据勒索等严重后果。建议您将安全组规则设置为仅允许已知的IP地址访问。

   

   表1 安全组入方向规则

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

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

Flexus L实例无初始密码，创建Flexus L实例后，如需登录云主机，请先设置Flexus L实例的密码。更多详情请参见重置Flexus L实例密码。

1. 在资源卡片上，单击图标，单击“重置密码”，或者在列表视图中单击操作列下的“重置密码”，设置Flexus L实例的密码。

   

2. 建议您使用在线重置密码，并确保当前资源为可操作资源，即已安装UniAgent。

   在线重置密码和后续手动配置Hermes Agent均依赖应用运维管理（Application Operations Management，简称AOM）的统一数据采集Agent（简称UniAgent）功能，支持脚本下发和执行。购买L实例后系统会自动安装UniAgent，若提示当前资源为不可操作资源，请耐心等待5-10分钟后，单击刷新UniAgent状态，若当前资源依旧为不可操作资源，请按界面提示手动安装UniAgent。

   

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

   用户名为root，密码为上一步设置的密码。

   

步骤五：配置Hermes Agent

1. 登录服务器后，执行以下命令开始配置Hermes Agent。

   su - hermes
   hermes setup

   

   运行以上命令后，需要通过键盘来完成后续配置动作：方向键控制选项，空格键表示勾选选项，回车键表示选择并确认。

2. 选择"Quick setup"。

   

3. provider选择”Custom endpoint (enter URL manually)”。

   

4. 填写需要配置的AI模型的参数信息。参数填写后请按回车键表示确认。
   • API base URL：模型配置以华为云MaaS为例，API base URL如下。

     https://api.modelarts-maas.com/v2

   • API key：获取模型API Key用于接口的鉴权认证。此处API key填写后并不显示，请直接按回车键进入下一项参数配置。

     如您配置的是华为云MaaS，支持使用“西南-贵阳一”区域已创建的API Key，或者登录MaaS平台，在左侧导航栏，单击“API Key管理 > 创建API Key”，根据界面提示创建新的API Key。

     

     • 当前仅支持使用“西南-贵阳一”区域的API Key。
     • 如果访问MaaS控制台提示“区域不支持服务”，请切换至“西南-贵阳一”区域。
     • 最多可创建30个API Key。每个API Key仅在创建时显示一次，请确保妥善保存。如果密钥丢失，无法找回，需要重新创建API Key以获取新的访问密钥。
   • 选择模型：请输入已经开通的模型的对应数字，如模型未开通可以在华为云MaaS模型列表开通所需模型。

     模型开通后，将按模型实际调用用量计费，详情请见模型服务计费项。

   • 设置上下文长度：此处按回车键保持默认，您也可以按需设置。

   

5. 选择现在开始配置platform。

   

6. platform选择飞书。输入飞书对应数字后按回车键。

   

   再次确认按回车键。

   

7. 选择手动输入飞书配置。

   

8. 填写步骤5复制的App ID、App Secret。Secret输入后不显示，输入后直接按回车键进入下一项配置。

   

9. 选择feishu。按回车键确认后，请等待一会，系统会自动进入下一项配置。

   

10. 选择WebSocket。

    

11. 选择Use DM pairing approval。

    

12. 选择Respond only when @mentioned in groups。

    

13. 按回车键跳过此配置。

    

14. 输入y，确认启动服务。

    

15. 输入y，确认开始会话。

    

16. 在会话中输入hello，如果返回已配置模型，证明配置已完成。

    

17. 输入/exit，退出对话。

步骤六：发布飞书版本并验证

1. 登录飞书开放平台，配置事件回调。选择左侧菜单的事件与回调，在事件配置页签配置订阅方式，选择“使用长连接接收事件”。
   可以单击“验证”测试连接是否成功，验证成功后，单击“保存”。

   图6 配置回调
   

   

   如果报错提示“应用未建立长连接”，请检查前面步骤中的机器人App ID和App Secret是否配置正确。如需修改请重新执行步骤五：配置Hermes Agent。

2. 单击“添加事件”，搜索接收消息，选中后单击“添加”。

   

3. 再次发布版本。单击页面左上方的“创建版本”，填写版本号（如1.0.1）、更新说明，单击“保存”后确认发布。
   图7 再次发布
   
4. 测试对话。

   在飞书APP中的开发者小助手对话框中可以看到版本发布成功的提示，单击打开应用即可进入机器人的聊天窗口，也可以在搜索框中搜索已创建的机器人名称，选中后进入聊天窗口，可以与机器人直接对话测试效果。

   1. 与飞书机器人首次对话，会收到配对码。

      

   2. 返回服务器命令行界面，输入以下命令，配对码替换为飞书机器人发送的配对码。
      请确保在hermes用户下执行，如果不在可以执行su - hermes切换。

      hermes pairing approve feishu 配对码

      

   3. 配对成功后，可以与机器人正常对话。

      如果机器人答复No home channel is set for feishu，可以在对话框直接发送/sethome即可。

      

常见问题

• 如果Hermes Agent配置错误，怎么重新配置？

  重新执行步骤五：配置Hermes Agent。

• 如果需要修改模型、飞书应用凭证等配置信息，要怎么操作？

  重新执行步骤五：配置Hermes Agent。