Hermes Agent 设置

安装与准备

从 Hermes 官方文档安装。准备 WuDi Key 和目标模型。建议使用官方交互式向导保存配置，避免照搬过期 YAML 字段。

1. 打开模型向导

退出当前聊天，在终端运行：

hermes model

选择 Custom endpoint（自定义端点），而不是其官方订阅登录选项。

2. 填写连接

向导字段	内容
API base URL	https://wudiapi.com/v1
API key	你的 WuDi API Key
Model name	例如 gpt-5.6-sol，须在当前 Key 的模型列表中
API mode / transport	Chat Completions，按当前版本选项填写
上下文长度	优先自动识别；手动填写前核对渠道实际限制

有些版本会为自定义提供商保存独立名称。请使用容易识别的 WuDi API，不要与已有提供商共用同一条配置。

3. 启动新会话

保存后重新打开 Hermes，发送一条短问题。在 WuDi 日志核对调用。会话内的 /model 主要用于切换已经配置好的模型，不能替代新增 Provider 的配置向导。

文件与凭据

用户配置目录通常是 ~/.hermes/，设置位于 config.yaml，凭据与环境设置按官方版本保存在对应私密文件中。分享配置时删除真实 Key。先备份再编辑，尤其避免覆盖其他机器人和工具设置。

额外任务也可能产生调用

压缩、标题、视觉等辅助任务可能单独选择模型。若主对话成功而这些功能失败，检查相应辅助模型是否仍指向其他 Provider。不要只对主模型设置后就假设所有工具都走 WuDi。

恢复与错误

重新运行 hermes model 选择原提供商即可切回。遇到模型未找到，核对模型 ID 和分组；协议错误则先验证最小 Chat Completions 请求。

参考：Hermes 模型提供商。