如何安装 Hermes Agent：初学者配置指南

Hermes Agent 是 Nous Research 推出的一款开源 AI 智能体，可在终端中运行，连接不同的模型服务提供商，跨会话记住有用的上下文，并可通过工具、技能、消息网关和自动化功能扩展。本指南将帮助你了解如何安装 Hermes。在 macOS 或 Windows 上使用标准安装程序时，无需手动安装 Python 或 Node.js，因为官方安装程序会处理主要依赖项。

Hermes Agent 是一款以终端为主的软件，因此需要通过命令行安装。请选择与你的电脑相符的部分：

• macOS：在“应用程序”>“实用工具”>“终端”中打开 Terminal，或按 Command + Space 并搜索“Terminal”。

• Windows：先安装 WSL2，打开你的 Linux 发行版终端，然后按照 Linux 命令操作。

还需要安装 Git。请检查是否已安装 Git：

预期输出：

如果看到 git: command not found，请先安装 Git：

如果 macOS 上尚未安装 Homebrew，请运行以下命令，通过 Apple Command Line Tools 安装 Git：

在终端中复制并粘贴官方安装程序命令：

安装程序会下载 Hermes Agent，准备其 Python 环境，安装所需依赖项，并将 hermes 命令添加到 shell 路径中。对于普通用户安装，Hermes 数据存储在 ~/.hermes/ 下。

命令执行完成后，重新加载 shell：

如果你使用 macOS 上常见的 Zsh，请运行：

预期结果：

现在确认 Hermes Agent 命令可用：

预期结果：

随着 Hermes Agent 更新，具体版本号可能会变化。

Hermes Agent 需要先配置模型服务提供商，才能回答问题或使用工具。对初学者而言，最简单的设置方式是交互式配置：

配置向导支持选择 Kimi/月之暗面等服务提供商。在基础对话可以正常使用前，请勿配置路由、故障转移、网关或 cron。

选择默认模型。Kimi K3 是 Kimi 最新的旗舰模型；如果你主要用于编程，kimi-k2.7-code 是更好的选择。

如果你已清楚要设置的值，可以使用 hermes config set。例如：

在 Hermes Agent 中使用 Kimi API 前，请先在 Kimi 开放平台 激活你的 Kimi API Key。建议充值 $20 以上以解锁 Tier 2 访问权限，从而降低延迟，并为复杂的多步骤任务提供更稳定的性能

前往 Kimi 开放平台的 API Keys 页面，点击“Create API Key”。请记得复制 API key 并妥善保存，因为该密钥仅会在创建时显示一次。

粘贴你的 Kimi API key，连接 Hermes Agent。

配置好模型后，启动经典 CLI：

或者试用新版终端 UI：

你应会看到欢迎界面或提示词，其中会显示所选的提供商/模型。用一个简单请求进行测试：

成功时应如下所示：

如果 Hermes Agent 能够打开，但提示模型或身份验证错误，请运行：

然后再次选择你的提供商，并验证 API 密钥或 OAuth 登录。

与 OpenClaw 一样，Hermes Agent 也可以作为机器人运行，并连接到你的聊天应用：

完成设置后，检查网关状态：

仅在模型提供商能在终端正常运行后再使用网关。如果 CLI 无法完成基本对话，机器人通常也会因相同原因失败。

原因：你的终端尚未重新加载 PATH 更改。

解决方法：

或者：

然后尝试：

原因：缺少 Git。

在 Ubuntu、Debian 或 WSL2 上的解决方法：

在 macOS 上通过 Homebrew 解决：

原因：已安装 Hermes Agent，但尚未配置提供商密钥或登录信息。

解决方法：

或者手动设置密钥：

原因：更新后，你的配置文件可能不完整。

解决方法：

原因：基础 URL、模型名称或上下文长度不正确。

解决方法：先在其他客户端中测试端点，确认其兼容 OpenAI API，并确保模型至少支持 64K 上下文，以满足常规 Hermes Agent 工作流的需求。

安装 Hermes Agent 最简单的方法是使用官方一行安装脚本，重新加载 shell，运行 hermes model，然后通过一次真实对话和 hermes doctor 验证设置。首次设置应尽量简单：一台设备、一个提供商、一段可正常进行的对话。基础 Hermes Agent 助手稳定后，再逐步添加 Docker 隔离、网关机器人、技能、定时自动化和自定义模型提供商。