百炼API Key未正确配置、地域不匹配或权限未开通会导致Hermes Agent无法调用大模型；需依次完成获取验证Key、确保地域与BaseURL一致、在轻量/无影/ECS中按场景配置并校验连接状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已完成 Hermes Agent 的基础部署，但无法调用阿里云百炼大模型服务，则可能是由于百炼 API Key 未正确配置、地域不匹配或权限未开通所致。以下是完成百炼接入的详细配置步骤：
一、获取并验证百炼 API Key
百炼 API Key 是 Hermes Agent 调用阿里云大模型服务的身份凭证，必须通过百炼控制台生成，并确保具备对应模型的调用权限。
1、登录阿里云百炼控制台，进入【API密钥管理】页面。
2、单击【创建API密钥】，填写描述（如“Hermes-Agent-Prod”），点击【确定】生成新密钥。
3、在密钥列表中找到刚生成的密钥，单击右侧【复制】按钮，将 API Key ID 与 Secret 完整保存至本地安全位置。
4、进入【模型服务】→【模型调用】页面，确认所选模型（如 qwen-max、qwen-plus 或 coding-plan 对应模型）已开启服务并处于“已启用”状态。
二、配置百炼地域与端点一致性
Hermes Agent 必须与百炼 API 所属地域严格一致，否则请求将被拒绝；地域不匹配是配置失败的最常见原因。
1、在百炼控制台右上角查看当前所在地域（如“华东1（杭州）”或“华北2（北京）”）。
2、在 Hermes Agent 配置界面中，选择与之完全相同的地域选项；不可使用“自动识别”或留空，默认值可能与实际不符。
3、若使用 Custom endpoint 方式（如无影云电脑场景），BaseURL 必须为对应地域的百炼服务地址，例如：
— 华北2（北京）：https://dashscope.aliyuncs.com/compatible-mode/v1
— 华东1（杭州）：https://dashscope.aliyuncs.com/compatible-mode/v1
4、确认 BaseURL 后缀含 /compatible-mode/v1，非 /api/v1 或 /v1/chat/completions。
三、轻量服务器环境下的百炼初始化配置
在预装 Hermes Agent 的轻量应用服务器中，需通过控制台引导式流程完成百炼参数注入，该过程将写入系统级配置文件并重启服务。
1、登录阿里云轻量应用服务器控制台，定位目标实例，单击实例ID进入详情页。
2、切换至【应用详情】页签，单击【配置Hermes】区域内的【初始化配置百炼API Key】按钮。
3、在弹出表单中：先选择百炼地域，再从下拉菜单选取已绑定的 Coding Plan API Key；如手动输入，请粘贴完整 Secret 值（非仅 Key ID）。
4、单击【下一步】，系统执行校验并提示“配置成功”，此时 Hermes Agent 后台服务将自动重载配置。
5、返回【应用详情】页，单击【安全代理访问】获取 WebUI 地址，在页面底部【配置信息】区块中核对 “LLM Provider” 显示为 “Bailian” 且 “Status” 为 “Connected”。
四、无影云电脑中的百炼模型手动配置
无影云电脑采用桌面级应用方式配置模型，需通过 Hermes Model 工具显式指定百炼兼容接口参数，绕过自动发现机制。
1、连接已购 Hermes Agent 云电脑后，双击桌面【Hermes Model】图标启动配置工具。
2、在 Provider 列表中选择【More providers】→【Custom endpoint】。
3、在 BaseURL 输入框中填入百炼兼容模式地址，确保协议为 https 且末尾无斜杠。
4、在 API-Key 输入框中粘贴百炼 Secret 值；Model name 输入框填写百炼平台显示的模型标识符，例如 qwen-max 或 qwen-plus。
5、单击【Save & Test】，等待测试结果返回 “Success: Model responded with valid schema”，表示百炼接入就绪。
五、ECS 或计算巢部署中的命令行配置方式
对于通过计算巢或 ECS 手动部署的 Hermes Agent，需直接编辑配置文件并重载服务，适用于高级用户或自动化脚本集成场景。
1、通过 Workbench 远程连接至 ECS 实例，执行 sudo su root 切换为 root 用户。
2、打开配置文件：vi /etc/hermes/config.yaml。
3、定位到 llm: 区块，修改以下字段：
— provider: bailian
— api_key: "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"（替换为真实 Secret）
— base_url: "https://dashscope.aliyuncs.com/compatible-mode/v1"
— model: "qwen-plus"
4、保存退出后执行 systemctl restart hermes 重启服务。
5、运行 hermes status 命令，检查输出中 LLM Status: Connected 及模型名称是否正确显示。
