使用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实例为运行中时，进行下一步。 
切换镜像会清除原系统盘数据，包括系统盘上的系统分区和所有其它分区，请做好数据备份。
步骤二：创建企业微信机器人
- 登录企业微信官网，使用具有企业管理员权限的账号登录。 如果没有满足条件的企业，请先创建一个新企业，详细操作，请参见创建&注册企业。图1 登录企业微信
- 在“企业微信”左侧的导航栏，选择“安全与管理 > 管理工具”，并单击“智能机器人”卡片。 图2 智能机器人
- 在“智能机器人”页面，单击“创建机器人”，在弹窗中单击“手动创建”。 图3 创建机器人
- 在“创建智能机器人”页面底部，单击“API模式创建”。 图4 API模式创建
- API模式创建页面，配置机器人信息，连接方式选择“使用长连接”，获取并保存Bot ID和Secret后单击保存。 图5 获取应用凭证信息
参数
说明
机器人名称
请输入自定义的智能机器人名称。
可见范围
请单击“添加”，在“组织架构”下选择智能机器人开放的成员范围。
连接方式
推荐使用长连接。
Bot ID
企业微信机器人的ID标识。
Secret
企业微信机器人的密钥。
（可选）步骤三：配置安全组
创建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实例的密码。
- 建议您使用在线重置密码，并确保当前资源为可操作资源，即已安装UniAgent。
在线重置密码和后续手动配置Hermes Agent均依赖应用运维管理（Application Operations Management，简称AOM）的统一数据采集Agent（简称UniAgent）功能，支持脚本下发和执行。购买L实例后系统会自动安装UniAgent，若提示当前资源为不可操作资源，请耐心等待5-10分钟后，单击刷新UniAgent状态，若当前资源依旧为不可操作资源，请按界面提示手动安装UniAgent。
- 单击资源卡片上的“远程登录”按钮，或者单击列表视图操作列下的“远程登录”，在弹出的登录窗口中，单击“VNC登录”，根据界面提示，输入用户名密码登录Flexus L实例。更多登录方式请参见登录方式概述。
用户名为root，密码为上一步设置的密码。
步骤五：配置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选择WeCom。
- 填写步骤5复制的Bot ID、Secret。Secret输入后不显示，输入后直接按回车键进入下一项配置。
Allowed user IDs可以按回车键按时跳过。
- 选择Use DM pairing。
- 选择Use DM pairing approval。
- 按回车键跳过此配置。
- 可以查看到企业微信已配置完成。如无需配置其他platform，则选择默认Done。
- 输入y，确认启动服务。
步骤六：验证机器人对话效果
常见问题
- 如果Hermes Agent配置错误，怎么重新配置？
重新执行步骤五：配置Hermes Agent。
- 如果需要修改模型、飞书应用凭证等配置信息，要怎么操作？
重新执行步骤五：配置Hermes Agent。
