工具接入
Hermes Agent
在 Nous Research 的 Hermes Agent 中把 LynShen 配置为自定义端点。
Hermes Agent 是 Nous Research 的开源 Agent，官网 hermes-agent.nousresearch.com。本页按 v0.21.6（2026-10-08 发布）和 2026-10-11 的官方文档编写。
接入方式
transport 值 | 协议 | Base URL |
|---|---|---|
chat_completions（默认） | Chat Completions | https://api.lynshen.org/v1 |
codex_responses | Responses | https://api.lynshen.org/v1 |
anthropic_messages | Messages | https://api.lynshen.org/v1（Hermes 会去掉结尾的 /v1） |
配置文件位置
| 系统 | 配置 | 密钥 |
|---|---|---|
| macOS、Linux | ~/.hermes/config.yaml | ~/.hermes/.env |
| Windows | %LOCALAPPDATA%\hermes\config.yaml | %LOCALAPPDATA%\hermes\.env |
config.yaml 是模型和端点配置的唯一来源。.env 中的 OPENAI_BASE_URL 只对内置的 openai-api 服务商生效，对自定义端点无效。
方式一：使用向导
- 在终端（不是会话中）运行
hermes model。 - 选择 Custom endpoint (self-hosted / VLLM / etc.)。
- 输入 Base URL：
https://api.lynshen.org/v1。 - 输入密钥
sk-...。向导把密钥写入.env，config.yaml只保存对它的引用。 - 选择 API 模式：Chat Completions、Responses 或 Anthropic Messages。
- 输入模型 ID，例如
deepseek-v4-pro。
方式二：编辑 config.yaml
最简单的写法：
model:
provider: custom
default: deepseek-v4-pro
base_url: https://api.lynshen.org/v1
key_env: LYNSHEN_API_KEY # 或直接写 api_key: sk-...在 ~/.hermes/.env 中写入：
LYNSHEN_API_KEY=sk-...需要按协议区分模型时，定义命名的自定义服务商：
providers:
lynshen:
api: https://api.lynshen.org/v1
key_env: LYNSHEN_API_KEY
transport: chat_completions
default_model: deepseek-v4-pro
context_length: 128000
lynshen-claude:
api: https://api.lynshen.org/v1
key_env: LYNSHEN_API_KEY
transport: anthropic_messages
default_model: claude-sonnet-5
lynshen-gpt:
api: https://api.lynshen.org/v1
key_env: LYNSHEN_API_KEY
transport: codex_responses
default_model: gpt-5.5
agent:
reasoning_effort: medium
display:
show_reasoning: true- Hermes 要求模型至少有 64,000 Token 的上下文。
context_length是示例，请按模型官方上限填写。 - 旧版配置使用顶层
custom_providers:列表，字段名为model和api_mode。Hermes 仍能读取，hermes update会把它迁移成providers:。
选择模型
- 会话中：
/model custom:<模型ID>。 - 使用命名服务商：
/model custom:lynshen-claude:claude-sonnet-5。 /model只能在已经配置的服务商之间切换。添加新服务商时，退出会话后运行hermes model。
显示推理
display.show_reasoning默认为true。会话中用/reasoning show或/reasoning hide切换。/reasoning high设置推理强度。加--global写入配置。- 没有设置推理强度时，Hermes 的 Chat Completions 请求默认带
reasoning_effort: medium。 - Hermes 能读取 LynShen 流式 Chat 中的
reasoning_details推理文字，所以 Chat Completions 模式也能显示思考过程。
常见问题
| 现象 | 原因和处理 |
|---|---|
| 启动时提示上下文太小 | 设置 context_length，至少 64000。 |
| 模型不支持推理参数，返回 400 | Hermes 默认发送 reasoning_effort: medium。在 model_overrides 中把该模型标记为 supports_reasoning: false。 |
设置了 OPENAI_BASE_URL 但不生效 | 自定义端点不读取这个变量。使用 config.yaml。 |
| 401 | 确认 .env 中的变量名与 key_env 一致。 |
来源
2026-10-11 查阅：