1. 项目概述
最近在折腾一个很有意思的项目——把阿里云的通义千问Qwen3.5大模型接入WinClaw。WinClaw是OpenClaw的Windows友好版本,本质上是一个智能网关,能在本地系统操作和大语言模型之间架起桥梁。这个组合特别适合像我这样既想用AI自动化办公,又不想花钱买商业API的用户。
说实话,刚开始看到配置项的时候有点懵,毕竟要从默认的OpenAI切换到Qwen这种开源模型。但实际操作下来发现,只要搞清楚几个关键配置项,整个过程其实挺顺畅的。下面我就把整个配置过程拆解开来,包括核心参数修改、本地部署和在线API两种接入方式,以及我踩过的那些坑。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心配置解析
2.1 配置文件结构
WinClaw的配置文件通常是YAML或JSON格式,位置一般在%APPDATA%\WinClaw\config.yaml。这个文件决定了WinClaw如何与AI模型交互,我们需要重点关注ai_model这个配置节。
默认情况下,WinClaw是配置成使用OpenAI的API,大概长这样:
yaml复制ai_model:
provider: "openai"
api_key: "sk-your-openai-key-here"
model: "gpt-4o-mini"
base_url: "https://api.openai.com/v1"
api_type: "chat-completions"
context_window: 16384
要接入Qwen,我们需要修改以下几个关键参数:
2.2 必须修改的配置项
- provider:从
openai改成custom或openai-compatible,告诉WinClaw我们要用第三方服务 - api_key:如果是本地部署的Qwen,可以随便填个非空字符串;如果用阿里云的DashScope API,就需要填真实的API Key
- model:必须和实际运行的模型名称完全一致,比如
qwen3.5:9b - base_url:这是最重要的修改,要指向Qwen模型的API地址
- context_window:Qwen3.5-9B支持32K上下文,比默认的16K要大
特别注意:
model字段必须和后端服务的模型标识一字不差,包括大小写和特殊字符。我有次就因为少写了个冒号,调试了半天。
3. 本地部署方案
3.1 使用Ollama运行Qwen
我最推荐的方式是用Ollama在本地跑Qwen模型。Ollama是个特别方便的本地大模型运行工具,安装简单,对Windows友好。
先安装Ollama(官网下载安装包就行),然后在命令行跑:
bash复制ollama pull qwen3.5:9b
ollama run qwen3.5:9b
这样就会启动一个本地API服务,默认监听11434端口,而且自带OpenAI兼容的API端点。
3.2 对应配置修改
配置文件要改成这样:
yaml复制ai_model:
provider: "custom"
api_key: "ollama" # 随便填,但不能为空
model: "qwen3.5:9b" # 必须和ollama run用的名称一致
base_url: "http://127.0.0.1:11434/v1" # Ollama的OpenAI兼容端点
api_type: "chat-completions"
context_window: 32768 # Qwen3.5-9B支持32K上下文
3.3 端口和防火墙设置
WinClaw内部可能会用到OpenClaw网关,默认端口是18789。记得在防火墙里放行这个端口:
powershell复制New-NetFirewallRule -DisplayName "OpenClaw Gateway" -Direction Inbound -LocalPort 18789 -Protocol TCP -Action Allow
4. 在线API方案
4.1 使用阿里云DashScope
如果本地机器性能不够,也可以用阿里云的DashScope在线API。他们现在有免费额度,足够日常使用了。
先去阿里云开通DashScope服务,拿到API Key。然后配置改成:
yaml复制ai_model:
provider: "custom"
api_key: "sk-your-dashscope-api-key-here" # 从控制台获取
model: "qwen3.5-plus" # 或者qwen3.5-9b
base_url: "https://dashscope.aliyuncs.com/compatible-mode/v1" # 专用兼容地址
api_type: "chat-completions"
context_window: 32768
4.2 在线API的优缺点
优点是不用本地跑模型,响应速度快,适合性能较弱的电脑。缺点是有调用频率限制,而且免费额度用完后要收费。
5. 验证与测试
5.1 基础测试
改完配置后,先来个简单测试:
- 在WinClaw里输入:"请用一句话介绍你自己"
- 如果返回"我是通义千问..."之类的,说明模型连接成功了
5.2 功能测试
然后试试实际功能:
"请在桌面创建一个名为'test_qwen.txt'的文件,并写入'Hello from Qwen!'"
如果文件成功创建,说明整个流程都通了。
6. 常见问题排查
6.1 模型调用失败
我遇到最多的问题就是模型连不上。排查步骤:
- 先确认Ollama服务是否运行:浏览器访问
http://127.0.0.1:11434/api/tags,应该能看到模型列表 - 检查
base_url是否写对了,特别是端口号和/v1这个路径 - 看看防火墙有没有挡住11434或18789端口
6.2 模型名称错误
这个错误很隐蔽,因为WinClaw不会明确告诉你模型名不对。一定要用ollama list确认本地模型的全称,包括大小写和特殊符号。
6.3 API密钥问题
本地部署时,api_key可以随便填,但不能为空。我有次手快删掉了这个字段,结果怎么调都不行,后来发现是这个问题。
7. 性能优化建议
7.1 上下文长度设置
Qwen3.5-9B支持32K上下文,但实际使用时可以根据需求调整。如果只是处理简单任务,可以设小一点,比如8192,能提高响应速度。
7.2 批量操作技巧
WinClaw支持批量指令执行。我习惯把常用操作写成脚本,比如:
text复制1. 读取D:/reports/下的所有PDF
2. 提取每份PDF中的关键数据
3. 汇总成Excel表格
4. 保存到桌面
这样比单条指令效率高得多。
8. 实际应用案例
8.1 自动化文档处理
我用这个组合实现了一个自动周报生成器:
- 扫描指定文件夹里的工作日志
- 提取关键信息
- 生成格式规范的周报
- 自动邮件发送给领导
整个过程完全自动化,每周五下午准时发出,再也不用担心忘写周报了。
8.2 智能文件管理
还设置了一个智能文件整理规则:
- 自动识别下载文件夹里的文件类型
- 图片移到Pictures
- 文档移到Documents
- 压缩包解压后分类存放
配合WinClaw的文件操作API,简直不要太方便。
9. 进阶配置技巧
9.1 多模型切换
可以在配置文件里预设多个模型配置,用的时候通过命令行参数切换:
bash复制WinClaw.exe --model=qwen3.5-9b
9.2 自定义指令集
WinClaw支持自定义指令别名。我在配置里加了这样一段:
yaml复制custom_commands:
"整理桌面": "将桌面上的文件按类型分类存放,删除超过30天的临时文件"
"备份工作": "将Documents文件夹压缩,加上日期标签,保存到D:/backups/"
这样只要说"整理桌面",WinClaw就知道要做什么。
10. 资源占用监控
本地跑Qwen3.5-9B还是挺吃资源的,建议开着任务管理器。如果发现内存占用过高,可以:
- 降低
context_window值 - 使用
qwen3.5:4b这种小一点的模型 - 设置WinClaw的对话历史长度限制
我在一台16G内存的笔记本上跑,同时开几个Chrome标签页就会有点卡,后来改用阿里云的在线API就好多了。
经过这一番折腾,最大的体会是:开源模型+自动化工具的组合真的能极大提升工作效率。虽然配置过程有点门槛,但一旦调通,后面的回报绝对是值得的。特别是对需要处理大量重复工作的朋友,这种方案比纯手工操作能省下至少一半的时间。
