CLI / Agent

Hermes Agent

自动写入 OpenAI Compatible LLM 配置

/v1/chat/completions一键写入配置docs/ai-gateway-editor-more-tools.md#hermes-agent

创建 API Key

Base URLhttps://api.4stoken.cn

鉴权方式Authorization: Bearer sk-...

协议/v1/chat/completions

Download

下载安装教程

先安装工具本体，再运行 4SToken 配置脚本。Windows 与 macOS / Linux 分开操作。

官方下载 / 安装入口

安装前准备

准备已安装 Hermes Agent

准备已创建 Portal Client Key

准备默认模型 gpt-5.5 已在 Gateway 配置可用路由

Windows

1安装并关闭 Hermes Agent

2运行本页 PowerShell 脚本，自动写入 %USERPROFILE%\.hermes\.env 与 config.json

3已有配置会备份为 .bak-时间戳；如 Hermes 使用自定义路径，可设置 HERMES_CONFIG_FILE 后重跑脚本

4重新打开 Hermes Agent，确认已读取脚本写入的 OpenAI Compatible 配置

macOS / Linux

1安装并关闭 Hermes Agent

2运行本页 bash 脚本，自动写入 ~/.hermes/.env 与 config.json

3已有配置会备份为 .bak-时间戳；如 Hermes 使用自定义路径，可设置 HERMES_CONFIG_FILE 后重跑脚本

4重新打开 Hermes Agent，确认已读取脚本写入的 OpenAI Compatible 配置

Install

配置命令

将命令中的 YOUR_API_KEY 替换成你的 Client Key。

macOS / Linux

curl -fsSL https://4stoken.cn/docs/scripts/hermes-agent.sh | GATEWAY_BASE_URL='https://api.4stoken.cn' bash -s -- YOUR_API_KEY

Windows PowerShell

$f = Join-Path $env:TEMP 'hermes-agent.ps1'; Invoke-WebRequest -Uri 'https://4stoken.cn/docs/scripts/hermes-agent.ps1' -OutFile $f -UseBasicParsing; powershell -NoProfile -ExecutionPolicy Bypass -File $f -ApiKey YOUR_API_KEY

查看 bash 脚本源码查看 PowerShell 脚本源码

Verify

配置检查

按顺序检查：先测接口连通，再做模拟调用，最后回到具体软件核对配置是否真正生效。

连通性检查

先确认 Key、Base URL 与模型列表接口可达。

执行模型列表查询，确认返回 200 且能看到可用模型

curl https://api.4stoken.cn/v1/models -H "Authorization: Bearer YOUR_API_KEY"

模拟调用

绕开客户端先打一次最小请求，确认网关协议与模型路由正确。

执行最小请求，确认没有 401、403、404、模型不存在或无路由错误

curl https://api.4stoken.cn/v1/chat/completions -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d "{\"model\":\"gpt-5.5\",\"messages\":[{\"role\":\"user\",\"content\":\"hello\"}]}"

其他

回到具体软件内确认配置文件、界面设置或重启步骤已经生效。

确认 ~/.hermes/.env 已写入

在 Hermes Agent 中发送 ping 并确认返回内容

Models

支持的模型 code

Hermes Agent

以当前工具配置的网关协议为准。

支持的 modelCode系统实际模型协议说明

gpt-5.5gpt-5.5/v1/chat/completions主力 GPT 模型

gpt-5.4gpt-5.4/v1/chat/completions稳定 GPT 档位

gpt-5.4-minigpt-5.4-mini/v1/chat/completions轻量 GPT 档位

openrouter-freeopenrouter-free/v1/chat/completions备用 / 免费线路

以上列表来自 Portal 已发布模型；客户端里优先填写表格第一列。完整可用范围仍以 GET /v1/models 与「模型与价格」页为准。

Automation

自动化落盘结果

执行脚本后会一次性写好 Hermes Agent 的 OpenAI Compatible 配置，同时保留可回滚备份。

环境变量~/.hermes/.env

兼容读取 .env 的 Hermes 启动方式

Base=https://api.4stoken.cn/v1 · Model=gpt-5.5

JSON 配置~/.hermes/config.json

兼容读取结构化 LLM 配置的客户端版本

Provider=openai-compatible · Fallback=openrouter-free

配置备忘~/.hermes/signal-gateway-setup.txt

保留可复制的人工核对信息

覆盖前自动生成 .bak-时间戳备份

默认模型gpt-5.5

备用模型openrouter-free

自定义路径HERMES_CONFIG_FILE=/path/to/config.json

写入预览

OPENAI_API_BASE=https://api.4stoken.cn/v1
OPENAI_BASE_URL=https://api.4stoken.cn/v1
OPENAI_API_KEY=YOUR_API_KEY
OPENAI_MODEL=gpt-5.5
MODEL=gpt-5.5

{
  "llm": {
    "provider": "openai-compatible",
    "base_url": "https://api.4stoken.cn/v1",
    "api_key": "YOUR_API_KEY",
    "model": "gpt-5.5"
  },
  "models": [
    "gpt-5.5",
    "openrouter-free"
  ]
}

Notes

接入边界

脚本仅修改本机工具配置文件，可通过上方源码链接审计。
执行前可设置 GATEWAY_BASE_URL 覆盖默认网关地址。
GET /v1/realtime 未开放，不影响编程工具接入。