如何安装 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 也可以作为 Bot 使用，并连接到你的聊天应用：

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

仅在模型提供商能在终端中正常工作后再使用网关。如果 CLI 无法完成一次基础对话，Bot 通常也会因同样的原因失败。

原因：你的终端尚未重新加载 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 隔离、网关 Bot、技能、定时自动化和自定义模型提供商等功能。