Hermes Agent

让 Hermes Agent 通过自定义端点调用本站模型。

Hermes Agent 是 Nous Research 开源的命令行 AI 助手,通过「自定义端点」接入本站。

  • 协议:OpenAI 兼容(Chat Completions)
  • 地址:https://tokenfunc.com/v1
  • 模型:上下文 64K 以上的模型,例如 claude-sonnet-4-5
  1. 安装 Hermes

    macOS / Linux

    curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

    Windows

    iex (irm https://hermes-agent.nousresearch.com/install.ps1)
  2. 运行配置向导

    hermes model

    在列表中选择 Custom endpoint,然后按提示依次填写:

    提示项填写
    Base URLhttps://tokenfunc.com/v1
    API keysk-xxxxxxxxxxxxxxxx
    Modelclaude-sonnet-4-5
    API modechat_completions
    Context length模型的上下文长度,例如 200000

    Hermes 要求模型上下文至少 64K,本站不会自动告知上下文长度,所以请手动填写。

    截图待补充hermes model 向导中 Custom endpoint 的填写界面tools/hermes-wizard.png

  3. 验证

    hermes chat -q "reply ok" --oneshot

    收到回复即接入成功。也可以运行 hermes doctor 检查配置。

用配置文件配置

不想用向导时,可以直接编辑配置文件,把密钥放在同目录的 .env 里:

macOS / Linux

~/.hermes/config.yaml
model:
  default: claude-sonnet-4-5
  provider: custom
  base_url: https://tokenfunc.com/v1
  key_env: TOKENFUNC_API_KEY
~/.hermes/.env
TOKENFUNC_API_KEY=sk-xxxxxxxxxxxxxxxx

Windows

%LOCALAPPDATA%\hermes\config.yaml
model:
  default: claude-sonnet-4-5
  provider: custom
  base_url: https://tokenfunc.com/v1
  key_env: TOKENFUNC_API_KEY
%LOCALAPPDATA%\hermes.env
TOKENFUNC_API_KEY=sk-xxxxxxxxxxxxxxxx

切换模型

在会话中输入 /model custom:模型名 切换,例如 /model custom:claude-sonnet-4-5。要新增一个端点,需要先退出会话,再运行 hermes model。

常见问题

现象原因与处理
设置了 OPENAI_BASE_URL 但不生效新版只对官方 OpenAI 提供方生效,改用向导或 config.yaml
启动时提示上下文不足模型上下文低于 64K,换一个长上下文模型,或在向导里填写正确的上下文长度
能连上但回复乱码或报错地址或模型名不对,确认地址带 /v1,模型名与 模型广场 一致
401密钥错误或额度用完,到 API 密钥 检查