hermes agent接入智谱glm或百度千帆失败时,需检查api key、base url及模型名配置:智谱需在zhipu.ai获取sk-开头密钥,base url为https://open.bigmodel.cn/api/paas/v4/,模型名如glm-5.1;百度千帆需在控制台开启openai兼容模式,base url含完整模型路径(如qwen2-72b-instruct),仅填ak作为api key。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您已安装 Hermes Agent,但尝试使用智谱 GLM 或百度千帆大模型时出现空响应、模型不可用或连接失败,则很可能是 API Key、Base URL 或模型名称配置错误。以下是针对智谱与百度千帆两种主流国产模型平台的独立配置方法:
一、智谱GLM API 配置方法
该方法通过 Hermes 的交互式 setup 向导,将智谱 AI 提供的 GLM 系列模型(如 glm-4-flash、glm-5.1)接入 Hermes。需确保使用官方兼容 OpenAI 格式的智谱 API 接口,并正确填写认证凭证。
1、访问智谱 AI 官方平台(https://www.zhipu.ai/),登录账号后进入「API 密钥管理」页面;
2、点击「创建 API Key」,复制生成的密钥(格式为 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx);
3、在终端中执行命令启动配置向导:hermes setup;
4、使用方向键选择 More providers,回车后从列表中选择 Z.AI;
5、粘贴上一步复制的 API Key;
6、Base URL 保持默认(https://open.bigmodel.cn/api/paas/v4/),直接回车;
7、在模型选择界面,输入并确认模型名,例如 glm-5.1 或 glm-4-flash;
8、完成配置后,输入 Y 启动对话,验证是否返回正常响应。
二、百度千帆 API 配置方法
该方法利用百度千帆平台提供的 OpenAI 兼容接口,将 Qwen 系列或 ERNIE Bot 模型接入 Hermes。需注意千帆控制台中必须开启「OpenAI 兼容模式」,且 Base URL 与鉴权方式须严格匹配。
1、登录百度千帆控制台(https://cloud.baidu.com/product/wenxinworkshop),进入「应用管理」→「API Key 管理」;
2、创建新 API Key,记录 AK(Access Key ID) 与 SK(Secret Access Key);
3、在「模型服务」中启用目标模型(如 Qwen2-72B-Instruct 或 ERNIE-Bot-4),并确认已开通「OpenAI 兼容接口」;
4、获取千帆 OpenAI 兼容 Base URL,标准格式为:https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/{model_name};
5、终端执行:hermes setup;
6、选择 Custom endpoint (OpenAI compatible);
7、输入 Base URL(完整含模型路径,例如 https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/Qwen2-72B-Instruct);
8、粘贴 AK 作为 API Key(千帆 OpenAI 兼容模式下仅需 AK,无需 SK);
9、模型名称字段留空或再次输入 Qwen2-72B-Instruct(依实际所选模型填写);
10、完成配置后运行 hermes 测试响应。
三、手动编辑配置文件法(备用方案)
当交互式向导无法识别特定平台或出现选项缺失时,可直接修改 Hermes 的本地配置文件,绕过向导限制。此方法适用于已知准确参数且需快速复位的场景。
1、打开配置文件路径:~/.hermes/config.yaml;
2、定位到 provider 区块,将其替换为以下智谱示例结构:
provider: zai
api_key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx
base_url: https://open.bigmodel.cn/api/paas/v4/
model: glm-5.1
3、若配置千帆,改为以下结构:
provider: custom
api_key: your_baidu_ak_here
base_url: https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/Qwen2-72B-Instruct
model: Qwen2-72B-Instruct
4、保存文件后,在终端执行:hermes model reload 强制重载模型配置;
5、运行 hermes 启动会话并观察初始响应状态。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











