Hermes Agent 接入指南

适用角色：开发者、主用户、子用户 更新日期：2026-08-06

Hermes Agent 官方提供自定义 OpenAI Compatible Endpoint 向导。使用向导比手工拼接配置命令更稳妥，也能跟随版本迁移配置结构。

安装

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

安装后在终端运行：

hermes model

选择 Custom endpoint，并依次填写：

API Base URL: https://<接口地址>
API Key: YOUR_API_KEY
Model: deepseek-v4-flash

API Base URL 填写根地址，客户端会自行拼接 /v1/chat/completions。

以控制台「API Key」页展示的接口地址为准。

手工配置的适用场景

向导会把 Provider、模型和地址写入 ~/.hermes/config.yaml。只有在自动化部署或排查迁移问题时才需要手工编辑；字段结构应以当前版本生成的文件为模板。

旧版 .env 中的模型字段可能已经不再生效。配置后仍连接旧 Provider 时，运行 hermes model 重新选择，并检查 config.yaml 是否保留旧的 provider 或 base_url。

验证

启动 Hermes，进行一轮普通问答，再测试一个只读工具。会话内的 /model 用于切换已经配置好的模型，新增或修改 Provider 应回到终端运行 hermes model。