---
url: https://limapi.com/docs/agents/hermes-agent.md
---
# Hermes Agent

Hermes Agent 是 NousResearch 推出的开源终端 AI 编程工具，内置自学习循环，支持终端与桌面两种形态。通过 Anthropic Messages 兼容协议接入 LimAPI。

## 安装 Hermes Agent

1. 在终端中执行以下命令安装 Hermes Agent，安装脚本会自动安装 Python、Git 等依赖。

```bash
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
```

> Windows 不支持原生安装，请先安装 WSL2，在 WSL2 中运行以上命令。

2. 安装完成后，重新加载终端环境。

```bash
source ~/.bashrc    # 如果使用 zsh，改为 source ~/.zshrc
```

3. 运行以下命令验证安装。若有版本号输出，则表示安装成功。

```bash
hermes --version
```

## 配置接入凭证

| 配置项 | 说明 |
| --- | --- |
| API Key | [Portal](https://limapi.com/) 创建的 LimAPI API Key（`sk-` 开头） |
| Base URL | `https://limapi.com/api/anthropic`（Anthropic 兼容端点） |
| 可用模型 | 平台支持的任意模型，完整列表通过 `GET /api/v1/models` 查询或在 Portal 模型广场查看 |

**方式一：命令行配置**

通过 `hermes config set` 命令配置接入参数，将 `YOUR_API_KEY` 替换为 LimAPI API Key：

```bash
hermes config set model.provider custom
hermes config set model.base_url https://limapi.com/api/anthropic
hermes config set model.api_mode anthropic_messages
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.8-max
```

以上命令将配置写入 `~/.hermes/config.yaml`。也可以直接编辑该文件，写入以下内容：

```yaml
model:
  default: qwen3.8-max
  provider: custom
  base_url: https://limapi.com/api/anthropic
  api_mode: anthropic_messages
  api_key: YOUR_API_KEY
```

| 字段 | 说明 |
|------|------|
| `provider` | 固定为 `custom`（自定义端点） |
| `base_url` | LimAPI Anthropic 兼容端点，固定为 `https://limapi.com/api/anthropic` |
| `api_mode` | 固定为 `anthropic_messages` |
| `api_key` | Portal 创建的 API Key |
| `default` | 默认模型，可按需替换为平台支持的任意模型 |

> 除命令行版外，Hermes Agent 还提供桌面版。命令行版安装完成后可运行 `hermes desktop` 启动，桌面版与命令行版共用同一份 `~/.hermes/config.yaml` 配置文件，接入参数与本文一致。

## 验证配置

配置完成后，执行以下命令发送一条测试消息：

```bash
hermes chat -q "你好"
```

如果返回正常的回复，则配置成功。如需切换模型，通过 `-m` 参数指定：

```bash
hermes chat -m qwen3.7-max -q "你好"
```

也可以直接运行 `hermes` 进入交互界面进行对话。

## 常见问题

### 报错 401 或提示 API Key 无效

* 确认 `~/.hermes/config.yaml` 中 `model.api_key` 已填写且复制完整无空格；
* 确认 API Key 在 [Portal](https://limapi.com/) 的「API Keys」页面状态正常；
* 确认 `base_url` 为 `https://limapi.com/api/anthropic`，不要与其他平台地址混用。

### 配置后不生效

修改配置文件后需重新打开终端或重启 Hermes 会话使配置生效；若仍异常，检查 `~/.hermes/config.yaml` 的 YAML 缩进是否正确（使用两个空格缩进）。

### 想使用 OpenAI 协议模型？

Hermes Agent 同样支持 OpenAI 兼容协议：将 `base_url` 改为 `https://limapi.com/api/v1`，并删除 `api_mode` 配置项即可。

::: tip 一键配置
使用 [LimAPI Agent 桌面客户端](/agents/limapi-agent) 可自动写入 `~/.hermes/config.yaml`。
:::