在服务器上安装 Hermes Agent

Hermes Agent 是由 Nous Research 开发的一款开源 AI 智能体，支持代码执行、文件操作、网络搜索、浏览器控制、桌面自动化等多种能力。这篇文章就来记录下如何在 Linux 服务器上安装 Hermes Agent。

准备材料

• Git（安装程序唯一需要你手动准备的东西，其余全自动处理）
• 稳定的网络连接
• 一个 LLM API Key（支持 OpenAI、DeepSeek、Claude 等多家提供商）

你无需手动安装 Python、Node.js、ripgrep、ffmpeg。安装程序会自动检测缺失的依赖并安装。

安装步骤

1. 登录服务器，执行这一行命令（Linux / macOS / WSL2 / Android / Termux）安装。我这里以 Ubuntu 的服务器为例

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

安装程序会自动处理仓库克隆、虚拟环境配置、依赖安装以及全局 hermes 命令注册。

如为 Windows 用户，请在 PowerShell 执行以下命令安装

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

2. 服务器检测系统环境后，会全自动化安装所有的依赖组件。一般安装的过程大概需要 5-20 分钟，视具体情况而定。

3. 在 Hermes Agent 安装脚本完成之后会提示这个。这里使用上下键选择“(○) Full setup — configure every provider, tool & option yourself (bring your own keys)”，然后点击“Enter”键进入配置页面

4. 这里可以用上下键选择预定义好的模板提供商。在这里，我因为要接入自定义模型，所以说我选择“→ (○) Custom endpoint (enter URL manually)”

5. 这里以商汤日日新模型为例。第一步填写 API 地址，第二步填写 API Key，第三步选择自动识别 API 类型，第四步选择模型，第五步选择自动识别上下文长度，第六步输入提供商名字（我这里写商汤日日新模型的英文名）

6. 这个的意思是 Hermes 支持对接的社交平台。如果没有对接社交平台的相关需求，可以按 ESC 按键关掉

7. 这里选择的是 Hermes 可以使用的能力，一般按 ESC 按键关掉，使用默认的能力就行

8. 接下来的步骤，推荐按我的设置

9. 这样，Hermes Agent 就安装完成了

10. 使用 hermes 命令，确认正常即可代表安装成功

安装后的常用命令

如选择 hermes 命令无法调用，重新加载 shell 使 hermes 命令生效：

source ~/.bashrc   # 或 source ~/.zshrc
hermes             # 开始聊天！

首次运行会自动引导你配置模型提供商。

如需重新配置单项设置，使用以下命令：

hermes model          # 选择 LLM 提供商和模型
hermes tools          # 配置启用的工具
hermes gateway setup  # 配置消息平台（Telegram、Discord 等）
hermes config set     # 设置单个配置项
hermes setup          # 或重新运行完整设置向导

配置模型提供商

配置 API Key 和模型：

hermes model

按提示选择提供商（支持 DeepSeek、OpenAI、Claude 等）并输入 API Key。

也可以直接编辑配置文件 ~/.hermes/config.yaml：

providers:
  custom:
    api_key: "your-api-key"
    base_url: "https://api.example.com/v1"
    model: "your-model-name"

故障排查

问题	解决方法
hermes: command not found	重新加载 shell（source ~/.bashrc）或检查 PATH
API key not set	运行 hermes model 配置提供商
更新后配置丢失	运行 hermes config check，然后 hermes config migrate

如需更多诊断信息，运行 hermes doctor——它会告诉你确切缺少什么以及如何修复。