Hermes Agent

Hermes Agent (opens in a new tab) 可将本站作为 OpenAI 兼容自定义端点（provider: custom）接入。base_url 使用 https://api.4tk.ai/v1（须含 /v1），api_key 使用控制台中的子令牌；default 模型名须与后台可用模型 完全一致。

官方说明见：AI Providers · Custom endpoint (opens in a new tab)、Configuration (opens in a new tab)。

与 OpenClaw 的差异（协议）

Hermes 的自定义端点主链路遵循上游 Chat Completions（POST /v1/chat/completions）。这与 OpenClaw 文档中「主会话优先走 Responses」的推荐不同：接入 Hermes 时，请在控制台确认所选模型 已启用 Chat 列；若某模型仅配置了 Responses 而无 Chat，Hermes 可能无法作为主模型使用。

更细的协议说明见：OpenAI Chat、Responses（供对照；Hermes 自定义端点仍以 Chat 为主）。

用途	建议模型	协议 / 说明
主模型（日常对话、工具调用）	`gpt-5.4-mini`	Chat Completions（`POST /v1/chat/completions`）。
编码 / 高难度推理	`gpt-5.4`	同样走 Chat；若 Hermes 或网关对推理强度有单独参数（如 `reasoning_effort`），以你所用 Hermes 版本文档与控制台模型能力为准。
记忆 / 语义检索（若通过 OpenAI 兼容辅助模型调用）	`text-embedding-3-large`	`POST /v1/embeddings`；是否在 Hermes 内走自定义端点取决于你对 `auxiliary` 等块的配置（见官方 Configuration）。
语音（若使用 OpenAI 兼容 TTS）	`tts-1-hd`	`POST /v1/audio/speech`；同上，视 Hermes 版本与工具链是否绑定主端点。

配置文件位置

非敏感项：~/.hermes/config.yaml（可用 hermes config edit 编辑）
密钥：~/.hermes/.env（推荐）；或在 config.yaml 中用 ${VAR} 引用环境变量

环境变量

避免把密钥写进仓库，可在 ~/.hermes/.env 中写入（变量名可自定）：

FOURTK_API_KEY="你在控制台创建的子令牌"

`config.yaml` 示例（最小可用）

下列 YAML 为示意；Hermes 不同版本的字段名、是否支持 context_length 自动探测等可能略有差异，请以 Hermes 官方文档 (opens in a new tab) 为准。default 必须与控制台中的模型 ID 一致；请使用 snake_case（base_url、api_key），不要使用 baseUrl / apiKey（可能被忽略）。

model:
  default: gpt-5.4-mini
  provider: custom
  base_url: https://api.4tk.ai/v1
  api_key: ${FOURTK_API_KEY}
  context_length: 128000

交互式配置（可选）

也可运行 hermes model，选择 Custom endpoint (self-hosted / VLLM / etc.)，按提示填入 Base URL、子令牌与模型名；结果会写入 config.yaml。

多网关命名（可选）

若需要在多个自定义端点之间切换，可使用官方文档中的 custom_providers 与 /model custom:<名称>:<模型> 语法，并为条目显式指定 api_mode: chat_completions（与命名 OpenAI 兼容网关时一致）。

常见问题

连不上：确认 base_url 含 /v1、本机可访问 api.4tk.ai、子令牌有效。
配置写了但不生效：检查是否误用 camelCase；以 base_url / api_key 为准。
模型报不支持 Chat：在控制台核对模型是否启用 POST /v1/chat/completions，或改用已启用 Chat 的模型。
辅助任务走了错误上游：若你为 auxiliary 等配置了 base_url / api_key，请与主模型一致或单独指向本站，避免与旧环境变量混用导致路由混乱（详见官方 AI Providers 与 Configuration）。

OpenClaw Codex