---
description: "将 Hermes Agent 通过 Custom Endpoint 接入在问 OpenAI 兼容端点。"
---

# 接入 Hermes Agent

Hermes Agent 是 Nous Research 开源的自改进个人 AI Agent，内置持久记忆、技能自生成和定时任务，可通过 Gateway 接入 Telegram、Discord、Slack 等 20+ 平台。它支持任意 OpenAI 兼容端点，用「Custom Endpoint」方式即可接入在问 API。

> 首先确保你已经安装并初始化过 Hermes Agent，终端里能运行 `hermes` 命令。

## 方式一：一键配置命令（推荐）

在终端中逐条执行（Windows 用户请在 PowerShell 中执行）：

```bash
hermes config set ZAIWENAI_API_KEY 'sk-xxxx'
hermes config set model.provider custom
hermes config set model.base_url https://oneapi.zaiwenai.com/v1
hermes config set model.default gpt-5.6-luna
hermes config set model.api_key '${ZAIWENAI_API_KEY}'
hermes config set model.context_length 262144
```

> 记得把 `sk-xxxx` 换成你自己的在问 API Key。

`hermes config set` 会自动路由写入位置：`ZAIWENAI_API_KEY` 这类大写密钥名存入 `~/.hermes/.env`，其余写入 `~/.hermes/config.yaml`。命令可重复执行，用于更新配置。

::: tip 关于 api_key 引用
`config.yaml` 支持 `${VAR}` 环境变量替换：`api_key: ${ZAIWENAI_API_KEY}` 表示从 `.env` 中读取密钥，明文不会出现在 yaml 里。
:::

## 方式二：手动编辑配置文件

如果你更喜欢手动管理，可以把下面两段分别合并到对应文件。

`~/.hermes/.env`：

```bash
ZAIWENAI_API_KEY=sk-xxxx
```

`~/.hermes/config.yaml`：

```yaml
model:
  default: gpt-5.6-luna
  provider: custom
  base_url: https://oneapi.zaiwenai.com/v1
  api_key: ${ZAIWENAI_API_KEY}
  context_length: 262144
```

::: warning 合并提醒
如果 `config.yaml` 中已有 `model:` 段（例如之前用过 OpenRouter），请手动合并字段而不是整段覆盖。
:::

## 可选：注册为命名供应商

`provider` 字段本身必须使用 Hermes 官方枚举值（`custom` / `openrouter` 等），不能直接写 `zaiwenai`。但可以通过官方的「命名自定义供应商」机制注册品牌名，效果是：

- `/model` 列表中显示 **在问 AI** 名称
- 会话内可用三段语法快速切换：`/model custom:zaiwenai:gpt-5.6-luna`

需要时用 `hermes config edit` 把下面段落粘贴进 `config.yaml`：

```yaml
providers:
  zaiwenai:
    name: 在问 AI
    api: https://oneapi.zaiwenai.com/v1
    key_env: ZAIWENAI_API_KEY
    transport: chat_completions
    default_model: gpt-5.6-luna
    models:
      gpt-5.6-luna:
        context_length: 262144
```

## 关于视觉（读图）

GPT-5.6-Luna 支持图像输入，两条视觉链路都能用它：

- **主对话读图**：在会话中直接贴图或发图片文件，永远由主模型（Luna）处理 ✅
- **辅助视觉任务**（`vision_analyze` 工具、浏览器截图分析）：默认 `provider: "auto"`，按 OpenRouter → Nous Portal → 主端点顺序回落。只配置了在问 Key 时会回落到 Luna；但如果同时配置了 OpenRouter 凭据，辅助视觉会优先走 Gemini Flash（主对话不受影响）

## 关于模型与上下文长度

- `default` 填写在问支持的任意模型 ID（如 `deepseek-v4-flash`、`claude-opus-4.7`），可在工作台的模型列表中查看可用模型
- `context_length` 设为 256K（262144）：让请求停留在短上下文计费档内，避免触发长上下文倍率计费；如果你的模型实际窗口更小，请按实际规格调低

## 检查点

- 执行 `hermes config show` 或 `hermes config get model`，确认模型与端点已生效
- 启动 `hermes` 进入会话，随便发一句话验证连通性
- 如果你在用 Gateway（Telegram/Discord 等）：Gateway 与 CLI 共用 `~/.hermes` 配置，重启后同样生效——`hermes gateway restart`