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 Command Line Tools 安装 Git：
第 1 步：在 macOS 或 Windows 上安装 Hermes Agent
在终端中复制并粘贴官方安装命令：
安装程序会下载 Hermes Agent，准备好其 Python 环境，安装所需依赖，并将 hermes 命令添加到你的 shell 路径中。在普通用户安装模式下，Hermes 的数据会存储在 ~/.hermes/ 下。
命令执行完成后，重新加载你的 shell：
如果你使用的是 macOS 上常见的 Zsh，请运行：
预期结果：
现在确认 Hermes Agent 命令是否可用：
预期结果：
随着 Hermes Agent 的更新，具体版本号可能会发生变化。
第 2 步：配置你的模型提供商
Hermes Agent 需要先配置模型提供商，才能进行回答或使用工具。最简单的入门方式是交互式设置：
配置向导会让你选择提供商，例如 Kimi/Moonshot。在基础对话可以正常使用之前，不要配置路由、故障转移、网关或定时任务。
选择默认模型。kimi-k2.6 是目前 Kimi 最先进的模型。
如果你已经知道想要设置的值，可以使用 hermes config set。例如：
如果你还没有 API Key，Kimi 会是一个不错的选择。
第 1 步：激活你的 Kimi API
在 Hermes Agent 中使用 Kimi API 之前，请先在 Kimi 开放平台 激活你的 Kimi API Key。我们建议充值 20 美元以上以解锁 Tier 2 权限，这样可以降低延迟，并为复杂的多步骤任务提供更稳定的性能
第 2 步：创建你的 Kimi API Key
前往 Kimi 开放平台的 API Keys 页面，点击创建 API Key。请记得复制并妥善保存你的 API Key，因为该密钥只会在创建时显示一次。
第 3 步：输入你的 API Key
粘贴你的 Kimi API Key，并连接 Hermes Agent。
第 3 步：启动 Hermes Agent
模型配置完成后，启动经典命令行界面：
或者试试更新的终端界面：
此时你应该会看到欢迎界面或提示符，显示你所选择的提供商/模型。用一个简单的请求测试一下：
成功的效果应该是这样：
如果 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 报告配置缺失或过期
原因：更新后，你的配置文件可能不完整。
解决方法：
自定义端点能连接，但回复内容有问题
原因：base 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 服务器、语音、定时任务或消息网关。