需配置阿里云百炼qwen模型接入hermes agent方可启用其核心能力：一、获取百炼api key与endpoint；二、通过轻量应用服务器图形化配置；三、ssh手动编辑config.yaml；四、webui验证连通性与调用日志。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已完成 Hermes Agent 的基础部署，但尚未将阿里云百炼平台的 Qwen 系列大模型接入其中，则无法启用其核心推理与自进化能力。以下是配置百炼 Qwen 系列模型接入 Hermes Agent 的具体操作路径：
一、获取百炼平台 Qwen 系列 API Key 与 Endpoint
该步骤用于获取合法调用权限及服务入口地址，确保 Hermes Agent 能安全、稳定地连接至百炼 Qwen 模型服务。
1、登录阿里云百炼控制台，进入「API 密钥管理」页面。
2、点击「创建 API Key」，在弹出窗口中勾选「Coding Plan」套餐（推荐），或选择按量计费模式。
3、复制生成的 API Key，并记录对应地域（如：cn-beijing、cn-hangzhou）。
4、在百炼控制台左侧导航栏点击「模型服务」→「Qwen 系列」，选择目标模型（如：Qwen3.6-Plus 或 Qwen2.5-Turbo），点击「服务详情」，复制「Endpoint URL」（格式为 https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation）。
二、通过轻量应用服务器控制台配置百炼接入
该方式适用于已购买预装 Hermes Agent 镜像的轻量应用服务器用户，无需命令行操作，全程图形化完成。
1、登录阿里云轻量应用服务器控制台，定位目标实例卡片，点击实例 ID 进入详情页。
2、在左侧菜单选择「应用详情」页签，找到「配置 Hermes」模块。
3、点击「初始化配置百炼 API Key」按钮，进入配置向导。
4、在「百炼地域」下拉菜单中，严格选择与 API Key 所属地域一致的选项（例如：API Key 来自北京，则必须选 cn-beijing）。
5、在「API Key」输入框中粘贴第 一 步获取的密钥；在「Model Name」字段填入模型标识符（如：qwen3.6-plus）；在「Base URL」字段填入第 一 步复制的 Endpoint URL。
6、点击「下一步」，系统自动校验连通性并保存配置。
三、通过 SSH 远程连接手动编辑配置文件
该方式适用于使用 ECS、计算巢或重置系统后手动部署 Hermes Agent 的用户，可精确控制模型参数与超时策略。
1、使用 Workbench 或 FinalShell，以 root 用户身份 SSH 连接至目标服务器。
2、执行命令进入 Hermes Agent 配置目录：cd /opt/hermes-agent/config。
3、编辑主配置文件：nano config.yaml。
4、在 llm_provider 区块下，将 provider 设置为 dashscope，并补全以下字段：
api_key: "您的API Key"
model: "qwen3.6-plus"
base_url: "https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation"
region: "cn-beijing"
5、保存退出后，执行重启命令：sudo systemctl restart hermes-agent。
四、通过 Hermes Agent WebUI 安全代理面板验证接入状态
该步骤用于实时确认模型服务是否成功注册并响应请求，避免因配置遗漏导致静默失败。
1、返回轻量应用服务器控制台，在实例详情页点击「访问 WebUI 面板」→「安全代理访问」，获取临时访问链接。
2、在浏览器中打开该链接，进入 Hermes Agent 管理界面。
3、点击左侧导航栏「系统状态」，查看「LLM Provider Status」项，状态应显示为 Connected。
4、点击「日志」页签，筛选关键词 qwen3.6-plus，确认最近 5 分钟内存在成功调用日志（含 request_id 与 status=200）。
5、在「测试对话」区域输入“你好”，观察响应头中是否包含 X-Model-Name: qwen3.6-plus 字段。
