Hermes Agent 安装与 First Run：init、doctor、chat、serve 怎么跑

Hermes Agent 官方仓库提供安装脚本和 CLI 使用方式。新手不要一上来就做复杂 Agent，先跑通 first run。

1. 安装前检查

检查项	说明
系统	macOS、Linux、WSL2 等环境更适合
Shell	需要能执行安装脚本
模型 Key	至少准备一个可用供应商 Key
网络	能访问仓库和模型接口
权限	不要用高权限目录乱装

2. 官方安装脚本

官方仓库给出一行安装方式。执行脚本前，建议先打开脚本看一眼，确认它会写入哪些目录、安装哪些依赖。

新手不要复制来源不明的安装命令。

3. 初始化

安装后通常先跑初始化命令，比如官方 README 提到的 hermes init。

初始化要关注：

• 配置文件放在哪里。
• 默认模型是什么。
• 是否创建 memory 或 skills 目录。
• 是否需要填 API Key。

4. 环境诊断

hermes doctor 这类诊断命令很重要。它能帮你检查配置、依赖和 Key 是否可用。

如果 doctor 不通过，不要继续跑复杂任务。

5. 第一次聊天

先用最小任务：

请回答一句话：当前 Hermes 配置是否能正常工作？

不要一上来让它读全盘文件、接入工具、执行命令。

6. Gateway 模式

官方仓库提到可用 hermes serve --gateway 类方式启动 Gateway。Gateway 一旦打开，就意味着有外部入口，要检查：

项目	检查
端口	是否暴露到公网
认证	是否有访问控制
日志	是否能追踪请求
工具权限	是否允许写操作
停止方式	出问题能否快速停用

7. First Run 验收表

步骤	成功标准
安装	命令可用
init	配置生成
doctor	诊断通过
chat	能完成一次低风险回复
serve	本地服务能启动
logs	能看到错误和请求

8. 问 AI 排错模板

我在安装 Hermes Agent。
下面是系统、安装命令、hermes init 输出、hermes doctor 输出和完整报错。
请按“可能原因 / 如何验证 / 修复步骤 / 风险”排查。
不要让我直接重装系统。

资料依据

• Hermes Agent 官方仓库：https://github.com/NousResearch/hermes-agent

安装 Hermes 的目标不是跑一个炫酷 demo，而是确认它的 CLI、配置、模型 Key、Gateway 和日志都在你能控制的范围内。