HermesAgent

HermesAgent 是由 NousResearch 开源的自主 AI Agent，运行在终端中，通过对话执行任务。与普通聊天机器人不同，它具备文件读写、命令执行、持久记忆等能力，可以自主完成多步骤工作。

关键理解：HermesAgent 不是一个 AI 模型，而是一个「Agent 运行时」——它负责把你的指令拆解成步骤，调用 AI 大模型 API 进行推理，并在你的终端里真正执行操作。

系统要求

支持 Linux、macOS、Windows 10/11（PowerShell）、WSL2，以及 Android（Termux）。

安装

Linux / macOS：

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

Windows（PowerShell，管理员模式）：

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

验证安装：

hermes --version

配置 AI Gateway API

编辑 ~/.hermes/config.yaml：

model:
  provider: custom
  base_url: https://aigateway.link/v1
  api_key: sk-你的令牌
  default: claude-sonnet-latest

base_url 必须包含 /v1

HermesAgent 会在 base_url 后自动拼接 /chat/completions，因此 base_url 必须以 /v1 结尾，否则请求路径错误会导致 404。

推荐模型

在 config.yaml 的 default 字段填入：

模型别名	说明
claude-sonnet-latest	Claude 旗舰，代码与 Agent 能力强（推荐）
gpt-latest	GPT 最强，综合能力好
deepseek-latest	性价比极高

启动

hermes --tui          # 启动 TUI 交互界面
hermes --continue     # 恢复上一次会话
hermes model          # 命令行切换模型

会话中也可以直接发送 /model 在对话内切换模型。

对接聊天平台

HermesAgent 支持把 Agent 接入到常用聊天软件，在软件内直接对话即可调用：

hermes gateway setup

按向导提示选择并配置目标平台：Telegram、Discord、Slack、WhatsApp、飞书（Lark）等。

常见问题诊断

现象	排查方向
401 Unauthorized	检查 api_key 是否完整、是否有效，令牌额度是否充足
404 或路径错误	确认 base_url 以 /v1 结尾
模型不可用	确认 default 填写的是网关支持的模型别名

实用资源

资源	链接
HermesAgent 仓库	github.com/NousResearch/hermes-agent
模型列表	模型列表