Hermes Agent 接入
Hermes 官方提供 Custom endpoint 向导。不要手改不熟悉的配置层级，优先用 hermes model 完成 Provider、地址、Key 和模型选择。
配置命令
hermes modelProviderCustom endpoint
Base URL
https://api.reniuniu.win/v1接入方式配置后测试
第一步：运行模型向导
退出正在运行的 Hermes 会话，在终端执行：
bash
hermes model选择 Custom endpoint，依次填写牛API地址、专用 Key 和控制台模型 ID。向导会把结果保存到 Hermes 的 config.yaml。
Dashboard 可以查看模型状态，但空白环境会提示运行 hermes model 完成 Custom endpoint 的首次配置。因此首次接入仍以终端向导为准，不要只在 Dashboard 中切换。
hermes model 与 /model 的区别
hermes model 用于新增 Provider、凭据和端点；聊天会话里的 /model 只能切换已经配置好的模型。首次接入必须先运行终端命令。
第二步：限制工具
执行 hermes tools，首次只保留最少的只读工具。不要使用 --yolo，它会绕过危险命令审批。
第三步：最小测试
重新启动 Hermes，先做纯文本回复，再测试一个只读文件操作。满足以下条件后再开放写入工具：
- 回复正常结束；
- 控制台出现对应模型的请求记录；
- 没有递归规划或重复工具调用；
- Token 消耗符合一次短请求的预期。
常见问题
| 现象 | 处理 |
|---|---|
| 找不到 Custom endpoint | 更新 Hermes，再运行 hermes model |
| 配置没有生效 | 退出旧会话后重新启动 Hermes |
| 工具调用错误 | 运行 hermes tools 关闭工具，退回纯文本 |
| 用量增长过快 | 中止任务，检查是否递归规划或自动重试 |
| 需要诊断 | 运行 hermes doctor，分享日志前先脱敏 |