实战：给 AI 助手 Hermes 接入阿里云百炼，WebUI 自由切换千问 8 个模型

你是不是也这样：AI 助手用着用着，总觉得差点意思------模型是国外的，想换个国产的试试，又不知道从哪里下手。

上个月我把一台 AI 助手（Hermes Agent）成功接上了阿里云百炼（千问），过程一波三折。官方文档确实有，但真正卡住你的三个坑，文档里一个都没写。

这篇文章把完整过程记下来，供和我一样的非程序员参考。

一、先想清楚：我为什么要折腾

我的 AI 助手平时用的模型是国外服务，但有些场景我想换国产模型：

想试试千问的旗舰模型，看看中文理解和长文本到底行不行
阿里云百炼有免费额度，注册就送，国内访问更快更稳
千问平台还代理了 DeepSeek、GLM 等一堆国产模型，一个 Key 全搞定

需求很明确，动手。

二、官方文档教你的 VS 我实际踩的

阿里云百炼有国内版和国际版两个端点，长得几乎一样：

你的 Key 长这样	对应平台	端点地址
`sk-ws-` 开头	国内百炼	`https://dashscope.aliyuncs.com/compatible-mode/v1`
国际版 Key	DashScope International	`https://dashscope-intl.aliyuncs.com/compatible-mode/v1`

我一开始按网上的通用教程填了国际端点，结果一直 401。查了半天发现：有些工具内置的"阿里云"选项默认连国际版，国内 Key 直接填进去必挂。

判断方法很简单，一行命令验证 Key 能不能拉到模型列表：

复制代码

curl -s "https://dashscope.aliyuncs.com/compatible-mode/v1/models" \
      
  -H "Authorization: Bearer sk-你的key" -w "\nHTTP:%{http_code}\n" | head -c 300
      
# 返回 HTTP 200 说明端点 + Key 配对正确

复制代码

我第一版把配置写进了"providers"段（网上教程都这么教），重启之后，WebUI 的模型下拉里死活找不到千问。

后来才弄明白：WebUI 的模型选择器只认custom_providers这一段，写在别的段它对不上号。

复制代码

custom_providers:
      
  - name: Qwen Domestic
        
# 注意别叫 qwen，会和内置名字撞车
      
    base_url: https://dashscope.aliyuncs.com/compatible-mode/v1
      
    api_key: sk-你的key
      
    models: [qwen3.8-max, qwen3.8-flash, qwen3.7-plus, qwen3.7-flash, qwen-plus, qwen-max, qwen-flash, qwen-turbo]

我一开始没写 models 白名单，想着"让系统自动探测不香吗"。

结果重启一看：模型列表确实出来了，但前 15 个全是语音、翻译、嵌入这类非对话模型，翻半天才找到能聊天的。原来系统自动探测把平台上 255 个模型全拉了下来，还只显示了前面 15 个------恰好都不是对话模型。

解法就一行：在custom_providers里写明models白名单，选择器就只显示你想要的 8 个对话模型。

做法	模型选择器表现	判断
不写 models	自动探测拉 255 个，前 15 个是语音/翻译/嵌入模型	❌ 没法用
写 models 白名单	只显示 8 个精选对话模型，干净可控	✅ 好用

三、正确的配置长什么样（照抄即可）

完整三步：

Step 1：写配置（改 ~/.hermes/config.yaml）

复制代码

custom_providers:
      
  - name: Qwen Domestic
      
    base_url: https://dashscope.aliyuncs.com/compatible-mode/v1
      
    api_key: sk-你的key
      
    models: [qwen3.8-max, qwen3.8-flash, qwen3.7-plus, qwen3.7-flash, qwen-plus, qwen-max, qwen-flash, qwen-turbo]

model_aliases:
      
  qwen:      {model: qwen3.8-max, provider: custom:qwen-domestic}
      
  qwen-plus: {model: qwen3.7-plus, provider: custom:qwen-domestic}

复制代码

Step 2：重启。改完必须重启工具进程才生效，这一步别省。

Step 3：验证。

WebUI 模型下拉出现 Qwen Domestic 组，8 个模型可选
命令行切换：/model qwen 切到千问旗舰，/model qwen-plus 切到千问 7B 档
想切回原来的模型：/model 原模型名

四、想多加、少加模型？改一行就行

这是这个方案最大的好处：选择器显示哪些模型完全由你说了算。

想做的事	操作
加模型	在 `models` 列表加一行模型名（如 `deepseek-v3`），重启
减模型	从 `models` 列表删掉名字，重启后选择器里就没了
查你 Key 能用哪些模型	`curl` 拉 `/v1/models`，或登录百炼控制台→模型广场

五、值不值得折腾？我的判断

✅值得，如果你是这几类人：

主力在海外模型上，想加个国产备胎、防断供
想要免费额度 + 国内访问速度
想一个 Key 用遍千问、DeepSeek、GLM 等国产全家桶

❌不太必要，如果：

现在的模型用得顺手，也没有换的需求
完全不想碰配置文件

折腾完那天晚上，我用千问旗舰模型聊了几个工控现场的问题，虽然有些场景还是原模型更懂我，但多一个国产选项，心里踏实多了。

现在的 AI 工具，就像十六七年前的手机------能打电话发短信，但你要的某个功能，总得自己装。会装的人，和只会用的人，差别会越来越大。

你用的 AI 工具支持换国产模型吗？评论区聊聊你的配置经历。