Hermes Agent 是 Nous Research 开发的一款开源 AI 智能体，可以在终端中运行，连接不同的模型提供商，能在多次会话中记住有用的上下文，还可以通过工具、技能、消息网关和自动化功能进行扩展。本指南将帮助你了解如何安装 Hermes。在 macOS 或 Windows 上使用标准安装程序时，你不需要手动安装 Python 或 Node.js，因为官方安装程序会为你处理好主要依赖项。
安装 Hermes Agent 之前
Hermes Agent 是一款以终端为主的软件，因此你需要通过命令行进行安装。请根据你的电脑选择对应的部分：
macOS：从「应用程序 > 实用工具 > 终端」打开终端，或按 Command + Space 搜索“Terminal”。
Windows：先安装 WSL2，打开你的 Linux 发行版终端，然后按照 Linux 命令操作。
你还需要 Git。检查是否已安装 Git：
预期输出：
如果看到 git: command not found，请先安装 Git：
如果你在 macOS 上没有安装 Homebrew，可以运行以下命令，通过 Apple 命令行工具安装 Git：
步骤 1：在 macOS 或 Windows 上安装 Hermes Agent
在终端中复制并粘贴官方安装命令：
安装程序会下载 Hermes Agent，准备好其 Python 环境，安装所需的依赖项，并将 hermes 命令添加到你的 shell 路径中。在普通用户安装模式下，Hermes 的数据会存储在 ~/.hermes/ 目录下。
命令执行完成后，重新加载你的 shell：
如果你使用的是 Zsh（在 macOS 上很常见），运行：
预期结果：
现在确认 Hermes Agent 命令是否可用：
预期结果：
随着 Hermes Agent 的更新，具体的版本号可能会发生变化。
步骤 2：配置你的模型提供商
Hermes Agent 需要先配置模型提供商，之后才能回答问题或使用工具。最简单的入门方式是交互式配置：
该向导会让你选择一个提供商，比如 Kimi/Moonshot。在基本的聊天功能正常运行之前，不要配置路由、故障切换、网关或定时任务。
选择默认模型。kimi-k2.6 是目前 Kimi 最先进的模型。
如果你已经知道要设置的值，可以使用 hermes config set。例如：
如果你还没有 API 密钥，Kimi 可能是个不错的选择。
步骤 1：激活你的 Kimi API
在 Hermes Agent 中使用 Kimi API 之前，请先在Kimi 开放平台激活你的 Kimi API 密钥。我们建议充值 20 美元以上以解锁二级访问权限，这样可以降低延迟，并为复杂的多步骤任务提供更稳定的性能支持
步骤 2：创建你的 Kimi API 密钥
进入 Kimi 开放平台的API 密钥页面，点击“创建 API 密钥”。请记得复制并妥善保存你的 API 密钥，因为它只在创建时显示一次。
步骤 3：输入你的 API 密钥
粘贴你的 Kimi API 密钥并连接 Hermes Agent。
步骤 3：启动 Hermes Agent
配置好模型后，启动经典版 CLI：
或者试试更新的终端 UI：
你应该会看到一个欢迎界面或提示符，显示你选择的提供方/模型。用一个简单的请求测试一下：
成功的效果应该是这样的：
如果 Hermes Agent 能打开，但回复模型或身份验证错误，运行：
然后重新选择你的提供方，并检查 API 密钥或 OAuth 登录是否有效。
第 4 步：把 Hermes Agent 变成一个 Bot
和 OpenClaw 一样，Hermes Agent 也可以作为 bot 接入你的聊天应用：
设置完成后，检查网关状态：
只有在终端里模型提供方能正常工作后才使用网关。如果 CLI 无法完成基本对话，bot 通常也会因为同样的原因失败。
Hermes Agent 安装常见问题
hermes: command not found
原因：终端还没有重新加载 PATH 变更。
解决方法：
或者：
然后再试：
git: command not found
原因：缺少 Git。
在 Ubuntu、Debian 或 WSL2 上的解决方法：
在 macOS 上使用 Homebrew 的解决方法：
未设置 API 密钥
原因：已安装 Hermes Agent，但未配置提供方密钥或登录信息。
解决方法：
或手动设置密钥：
hermes doctor 报告配置缺失或过期
原因：更新后你的配置文件可能不完整。
解决方法：
自定义端点能连接但回复内容有问题
原因：基础 URL、模型名称或上下文长度设置有误。
解决方法：先在另一个客户端中测试该端点，确认它兼容 OpenAI API，并确保模型支持至少 64K 上下文，以满足 Hermes Agent 正常工作流程的需求。
快速命令参考
结语
安装 Hermes Agent 最简单的方法是使用官方的一行式安装程序，重新加载 shell，运行 hermes model，然后通过一次真实对话加上 hermes doctor 验证配置是否正确。第一次设置时保持简单：一台机器、一个提供方、一次能正常运行的对话。等基础的 Hermes Agent 助手稳定运行后，你就可以放心地在此基础上叠加 Docker 隔离、网关 bot、技能、定时自动化任务以及自定义模型提供方。
常见问题
~/.hermes/ 目录下，并可以通过技能、记忆、定时任务和消息网关进行扩展。hermes model，选择一个提供商（比如 Kimi），启动 hermes，测试一次普通聊天，运行 hermes doctor，并确认 hermes --continue 能恢复你的会话。完成后，再根据需要添加 Docker 隔离、技能、MCP 服务器、语音、定时任务或消息网关。