接入 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。命令可重复执行，用于更新配置。

关于 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

合并提醒

如果 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

接入 Hermes Agent ​

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

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

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

关于视觉（读图） ​

关于模型与上下文长度 ​

检查点 ​