一个工控人的 AI 助手升级记:千问接入实录

第一时间获取精彩技术分享

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

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

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

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

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

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

需求很明确，动手。

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

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

我一开始按网上的通用教程填了国际端点，结果一直 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 个对话模型。

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

完整三步：

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 原模型名

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

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

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

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

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

❌不太必要，如果：

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

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

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

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