Hermes Agent

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

安装 Hermes Agent

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

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

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

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

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

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

hermes --version

配置接入凭证

配置项	说明
API Key	Portal 创建的 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：

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。也可以直接编辑该文件，写入以下内容：

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 配置文件，接入参数与本文一致。

验证配置

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

hermes chat -q "你好"

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

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

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

常见问题

报错 401 或提示 API Key 无效

• 确认 ~/.hermes/config.yaml 中 model.api_key 已填写且复制完整无空格；
• 确认 API Key 在 Portal 的「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 配置项即可。

一键配置

使用 LimAPI Agent 桌面客户端 可自动写入 ~/.hermes/config.yaml。