使用Hermes Agent搭建个人AI助手（微信）
应用场景
Hermes Agent是一款由Nous Research推出的开源自主AI智能体，以MIT协议开放使用，主打跨会话持久记忆、自主提炼可复用技能、多平台接入与多模型切换能力，能够在持续使用中不断适配用户习惯，实现能力的自我迭代。
本文档介绍如何在Flexus L实例上使用Hermes Agent应用镜像结合飞书快速搭建个人AI助手。
步骤一：部署Hermes Agent应用镜像的L实例
您可以新购买Hermes Agent应用镜像的L实例，也可以使用已有L实例部署Hermes Agent应用镜像。
- 进入Flexus应用服务器L实例购买页。
- 对Flexus应用服务器L实例进行资源配置。
参数
示例
说明
区域
北京-北京四
请就近选择靠近您业务的区域，可减少网络时延，提高访问速度。Flexus应用服务器L实例创建后无法更换区域，请谨慎选择。
应用镜像
Hermes Agent
选择Hermes Agent应用镜像。
实例规格
2核2G、系统盘40GiB
您可根据您的业务需求选择Flexus应用服务器L实例规格。
实例名称
Hermes-Example
请自定义方便您识别的实例名称，例如Hermes-Example。
您可能需要（可选）
- 数据盘：10GiB
- 主机安全
- 云备份：50GB
请根据您的业务需要自主选择数据盘、主机安全、云备份附加服务并设置规格。
购买时长
1个月
单次购买最短为1个月，最长为3年。
Flexus应用服务器L实例支持自动续费功能。勾选后，在Flexus应用服务器L实例到期前自动续费。如果您购买时未开通自动续费，后续仍可以在控制台开通。自动续费的更多信息详见自动续费。
购买数量
1台
设置您购买的Flexus应用服务器L实例数量。
- 单击“下一步：确认配置”，进入订单详情页面。
- 单击“去支付”，根据页面提示完成支付。
- 单击“返回华为云Flexus云服务控制台”，查看已创建的Flexus应用服务器L实例。
- 登录Flexus应用服务器L实例控制台，查看目标L实例是否为Hermes Agent应用镜像。
- 如是，请执行（可选）步骤二：配置安全组；
- 如不是，请执行步骤2。
- 单击L实例资源卡片上的
图标，单击“切换镜像”。按照界面提示切换为Hermes Agent应用镜像，待切换成功且L实例为运行中时，进行下一步。 
切换镜像会清除原系统盘数据，包括系统盘上的系统分区和所有其它分区，请做好数据备份。
（可选）步骤二：配置安全组
创建Flexus L实例时，系统会自动为您创建默认安全组（sg-default-smb）并关联至该实例。默认安全组仅确保安全组内实例互通，默认拒绝所有外部请求进入实例。本示例使用默认安全组及默认安全组规则，您可以按照本步骤进行查看。
- 在Flexus应用服务器L实例控制台，单击资源卡片或名称，进入资源页面。
- 在左侧列表中选择“云主机 VM”，单击云主机名称，进入云主机详情页面。
- 选择“安全组”页签，入方向规则确保使用以下默认安全组规则。
您也可以根据实际需要添加更多规则，详情请参见配置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实例密码。
- 登录Flexus应用服务器L实例控制台。
- 在资源卡片上，单击
图标，单击“重置密码”，根据界面提示设置L实例的密码。 
更多详情请参见重置Flexus L实例密码。
- 单击资源卡片上的“远程登录”按钮，在弹出的登录窗口中，单击“CloudShell登录”。
此处以CloudShell登录方式为例，您也可以使用其他远程登录工具连接L实例，更多登录方式请参见登录方式概述。
- 根据界面提示，输入用户名密码登录Flexus L实例。用户名为root，密码为步骤2设置的L实例密码。此处以公网连接方式为例。
请确认安全组中来源为CloudShell代理IP的远程端口（SSH默认端口为22）已经放开。各区域的CloudShell代理IP可能不同，请以CloudShell配置界面显示为准。
- 如果未放开，请执行步骤5后再单击“连接”。
- 如果已放开，单击“连接”，连接成功后执行步骤步骤四：配置Hermes Agent。
更多CloudShell登录详情请参见通过CloudShell登录Linux系统Flexus L实例。
- 在L实例资源卡片上，单击
图标，单击“配置安全组规则 > 添加规则”。添加一条规则，允许来自CloudShell代理IP的流量通过22端口。 
步骤四：配置Hermes Agent
- 登录服务器后，执行以下命令开始配置Hermes Agent。
su - hermes hermes setup
运行以上命令后，需要通过键盘来完成后续配置动作：方向键控制选项，空格键表示勾选选项，回车键表示选择并确认。
- 选择"Quick setup"。
- provider选择”Custom endpoint (enter URL manually)”。
- 填写需要配置的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模型列表开通所需模型。
模型开通后，将按模型实际调用用量计费，详情请见模型服务计费项。
- 设置上下文长度：此处按回车键保持默认，您也可以按需设置。
- API base URL：模型配置以华为云MaaS为例，API base URL如下。
- 选择稍后配置platform。
- 输入y，确认开始会话。
- 在会话窗口，如果返回已配置模型，且输入hello后可以正常答复，证明配置已完成。输入/exit，退出对话。
- 执行以下命令，开始配置platform。
hermes gateway setup
- platform选择Weixin。
- 输入y，扫码配置微信。若二维码未显示，请按照指引单击链接，在新开页面中使用微信APP扫码完成配置。
- 选择Use DM pairing approval。
- 选择Disable group chats。
- 输入y，设置home channel。
- 可以查看到微信已配置完成。如无需配置其他platform，则选择默认Done。
- 输入y，确认启动服务。
步骤五：验证机器人对话效果
常见问题
- 如果Hermes Agent配置错误，怎么重新配置？
重新执行步骤四：配置Hermes Agent。
- 如果需要修改模型、飞书应用凭证等配置信息，要怎么操作？
重新执行步骤四：配置Hermes Agent。
