使用Hermes Agent搭建个人AI助手（Discord）
应用场景
Hermes Agent是一款由Nous Research推出的开源自主AI智能体，以MIT协议开放使用，主打跨会话持久记忆、自主提炼可复用技能、多平台接入与多模型切换能力，能够在持续使用中不断适配用户习惯，实现能力的自我迭代。
本文档介绍如何在Flexus L实例上使用Hermes Agent应用镜像结合Telegram快速搭建个人AI助手。
步骤一：部署Hermes Agent应用镜像的L实例
您可以新购买Hermes Agent应用镜像的L实例，也可以使用已有L实例部署Hermes Agent应用镜像。
- 进入Flexus应用服务器L实例购买页。
- 对Flexus应用服务器L实例进行资源配置。
参数
示例
说明
区域
中国-香港
请就近选择靠近您业务的区域，可减少网络时延，提高访问速度。Flexus应用服务器L实例创建后无法更换区域，请谨慎选择。
应用镜像
Hermes Agent
选择Hermes Agent应用镜像。
实例规格
2核2G、系统盘60GiB
您可根据您的业务需求选择Flexus应用服务器L实例规格。
实例名称
Hermes-Example
请自定义方便您识别的实例名称，例如Hermes-Example。
您可能需要（可选）
- 数据盘：10GiB
- 主机安全
- 云备份：70GB
请根据您的业务需要自主选择数据盘、主机安全、云备份附加服务并设置规格。
购买时长
1个月
单次购买最短为1个月，最长为3年。
Flexus应用服务器L实例支持自动续费功能。勾选后，在Flexus应用服务器L实例到期前自动续费。如果您购买时未开通自动续费，后续仍可以在控制台开通。自动续费的更多信息详见自动续费规则说明。
购买数量
1台
设置您购买的Flexus应用服务器L实例数量。
- 单击“下一步：确认配置”，进入订单详情页面。
- 单击“去支付”，根据页面提示完成支付。
- 单击“返回华为云Flexus云服务控制台”，查看已创建的Flexus应用服务器L实例。
- 登录Flexus应用服务器L实例控制台，查看目标L实例是否为Hermes Agent应用镜像。
- 如是，请执行步骤二：创建Discord机器人；
- 如不是，请执行步骤2。
- 单击L实例资源卡片上的
图标，单击“切换镜像”。按照界面提示切换为Hermes Agent应用镜像，待切换成功且L实例为运行中时，进行下一步。 
切换镜像会清除原系统盘数据，包括系统盘上的系统分区和所有其它分区，请做好数据备份。
步骤二：创建Discord机器人
- 登录Discord开发者平台，单击New Application。
- 输入自定义的机器人名称，阅读并勾选协议后，单击Create。
- 进入Application页面，在左侧菜单中选择Bot，单击Reset Token按钮，生成新的Token。
如果需要验证，请输入Discord账号的密码。
复制并妥善保存Token，用于后续Hermes配置的填写。
- 在Bot配置页面，下滑到Privileged Gateway Intents，按需开启以下权限。
- Message Content Intent：必选，读取消息内容，若未开启机器人将无法读取消息或发送回复。
- Server Members Intent：建议选择。
- Presence Intent ：建议选择。
勾选后单击Save Changes。
- 在左侧菜单中选择OAuth2，在OAuth2 URL Generator模块，先配置Scopes下的权限，建议先按照最小化原则勾选bot、 applications.commands。
- 再配置Bot Permissions下的权限，勾选View Channels、Send Messages、Read Message History、Embed Links、Attach Files、Add Reactions (可选)。
- 复制页面底部生成的链接，在浏览器中打开。
- 在弹窗中选择需要加入的Discord Server，需要您具有Server的管理员权限。
- （可选）如果您还未创建Server，可以在Discord首页新建一个Server。
- 选择Server后，单击Continue后进行授权。
- 添加成功后，界面显示如下。
- 单击左下角的设置按钮。
- 左侧目录下滑到底部，单击Developer，打开Developer Mode，然后关闭弹窗。
- 单击左下角用户头像。
- 复制并保存User ID，用于后续Hermes配置的填写。
（可选）步骤三：配置安全组
创建Flexus L实例时，系统会自动为您创建默认安全组（sg-default-smb）并关联至该实例。默认安全组仅确保安全组内实例互通，默认拒绝所有外部请求进入实例。本示例使用默认安全组及默认安全组规则，您可以按照本步骤进行查看。
- 在左侧列表中选择“云主机 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：模型的API地址，请在模型供应商处获取。例如https://api.openai.com/v1。
- API key：获取模型API Key用于接口的鉴权认证。此处API key填写后并不显示，请直接按回车键进入下一项参数配置。
- 选择模型：请输入模型的对应数字或名称。
- 设置上下文长度：此处按回车键保持默认，您也可以按需设置。
- 选择稍后配置platform。
- 输入y，确认开始会话。
- 在会话窗口，如果返回已配置模型，且输入hello后可以正常答复，证明模型配置已完成。
- 输入/exit，退出对话。
- 输入以下命令，开始配置platform。
hermes gateway setup
- platform选择Discord。
- 输入步骤3获取的Token。输入后不显示，请直接按回车键进入下一项配置。
- 输入步骤15获取的User ID。
- 输入/set-home。
- 按回车键保持默认选项Done。
- 输入y，确认重启网关。
步骤六：验证对话效果
常见问题
- 如果Hermes Agent配置错误，怎么重新配置？
重新执行步骤五：配置Hermes Agent。
- 如果需要修改模型、对接通道等配置信息，要怎么操作？
重新执行步骤五：配置Hermes Agent。
