HermesAgent安装验证指南：3步快速确认成功运行

安装 HermesAgent 后，系统状态是否正常？这套五步验证流程能帮你完成从基础环境到核心服务的完整性检查，确保部署无误。我们按顺序操作。

一、验证诊断工具可执行性

hermesdoctor 是官方提供的环境诊断工具。如果该命令无法调用，通常意味着安装路径未正确配置或核心组件缺失。

操作步骤：在终端（Windows 建议使用管理员权限的 PowerShell）中直接输入：

hermesdoctor --version

执行命令。若终端显示类似 hermesdoctor 1.2.0 的版本信息，则表明工具就绪。若系统返回“命令未找到”，需检查系统环境变量或重新执行安装流程。

二、执行基础环境诊断

确认工具可执行后，需进行深度环境扫描。运行 hermesdoctor check 命令，该操作将自动检测 Python 解释器版本、核心依赖包状态、配置文件路径及端口占用等关键指标。

命令执行后，系统将生成一份诊断报告。请逐一核对每项检查结果是否为绿色的 [PASS] 标记。全部通过则表明基础环境配置正确。若出现红色的 [FAIL]，请根据其后附带的修复建议进行处理。

三、测试核心命令功能

完成环境诊断后，需验证主程序 hermes 的运行状态。这是后续交互的核心接口。

首先，检查命令识别：

hermes --version

正常响应应为主程序版本号，例如 hermes 0.8.3。

其次，测试基础交互能力：

hermes chat "你好，介绍一下你自己"

若程序能返回结构化的自我介绍（JSON 格式或清晰文本），而非抛出模块导入错误或命令异常，则表明核心程序安装成功且运行正常。

四、核对 API 密钥配置

程序可运行不代表配置完整。HermesAgent 需读取配置文件中的 API Key 才能调用 AI 模型服务。

密钥存储于 ~/.hermes/.env 文件。请按顺序确认：

1. 文件是否存在：执行 ls -la ~/.hermes/.env 查看。

2. 密钥是否已配置：使用 cat ~/.hermes/.env | grep -i "api_key\|key=" 进行过滤。若输出为空或仅有注释行（以 # 开头），则需通过 hermes setup 重新配置，或手动编辑该文件填入有效的 API Key。

五、验证服务端口监听状态

若已尝试启动 HermesAgent 服务（例如执行 hermes start）但无法连接，需确认服务端口是否正常监听。

首先确认配置的端口号（默认为 8080）。随后执行：

hermesdoctor check --port 8080 （请将 8080 替换为你的实际端口）

若返回“端口可达”，表明服务已启动并监听连接。若提示“连接被拒绝”，则可能是服务进程未成功运行或被本地防火墙拦截，需进行进程与网络策略排查。

完成以上五步验证且全部通过，即可确认 HermesAgent 已成功安装并处于就绪状态，可投入正式使用。