一、配置步骤
第 1 步：打开 Custom Endpoints
左侧菜单进入 Providers → Custom Endpoints，点击下方的 New endpoint 新建一个。
第 2 步：填写 Gravitex 网关信息
在 Edit Endpoint 表单中依次填写：
勾选 Use for new chats 和 Discover models，点击 Test 确认连通后，再点击 Save 保存。
第 3 步：确认 Gateway Connection 模式
左侧菜单进入 Gateways，查看 Connection mode。默认使用 Local gateway（本机运行、支持离线），接入 Gravitex 一般无需修改此项；只有当你需要让 Hermes 后端运行在远程或云端时，才需要切换为 Hermes Cloud / Remote gateway / Connect via SSH。
第 4 步：在 Model 中选择 gravitex
左侧菜单进入 Model，在模型下拉框中选择第 2 步配置好的gravitex，点击 Apply 应用。如需给 Vision、Web extract、Compression、Skills hub、Approval、MCP、Title gen 等辅助任务单独指定模型，可在下方 Auxiliary models 中逐项点击 Change；默认都会跟随主模型（auto · use main model）。
第 5 步：发送消息测试
回到 Chat 页面发送一条消息，确认能收到 gravitex 网关正常返回的回复。二、验证是否成功
- Model 选择器中能看到并成功选中
gravitex，点击 Apply 后无报错。 - 在 Chat 中发送消息后能正常收到回复，没有出现
invalid api key/endpoint unavailable/model_not_found等报错。
三、常见问题排查
四、安全须知
- API Key 等同于密码，不要写入公开文档、聊天记录、截图或代码仓库。
- Custom Endpoint 详情中可能以环境变量形式（如
${HERMES_CUSTOM_GRAVITEX_API_KEY}）显示 Key 信息，请勿在公共环境下截图分享。 - 若 Key 已在聊天、日志或截图中泄露，应立即在 Gravitex 后台作废并重新生成。