用免费大模型如Qwen系列接入WinClaw作为OpenClaw的Windows友好版本时核心配置修改集中在AI模型提供商、API端点、模型标识以及必要的认证信息上。由于OpenClaw/WinClaw的设计初衷是作为连接大语言模型LLM与本地系统操作的“智能网关”其配置必须准确匹配目标大模型的API协议和参数。以下是将WinClaw的AI“大脑”从默认的OpenAI服务切换到免费/开源模型以阿里云通义千问Qwen3.5-9B的本地部署为例所需修改的关键配置项、具体操作步骤及代码示例。一、核心配置项修改详解WinClaw的配置通常存储在一个YAML或JSON格式的配置文件中如config.yaml。接入免费大模型你需要修改配置文件中与AI模型相关的部分。主要涉及以下几个模块配置项默认值如OpenAI接入Qwen等免费模型需修改为说明与注意事项ai_model.provideropenaicustom或openai-compatible指明使用的是自定义或兼容OpenAI API协议的第三方服务。ai_model.api_keyOpenAI的sk-...你的API Key或占位符对于本地部署的QwenAPI Key可能非必需或可填写任意值对于DashScope阿里云在线API需填写其提供的API Key。ai_model.modelgpt-4o-mini具体模型ID如qwen3.5-9b必须与后端服务提供的模型标识完全一致否则调用会失败。ai_model.base_urlhttps://api.openai.com/v1模型服务的API基础地址这是最关键的修改。需指向你的Qwen模型服务地址如本地Ollama的http://127.0.0.1:11434/v1或DashScope的https://dashscope.aliyuncs.com/compatible-mode/v1。ai_model.api_typechat-completionschat-completions或openai-completions需根据后端服务支持的API路径选择。OpenClaw网关通常适配/v1/chat/completions端点。ai_model.context_window例如 16384模型的实际上下文长度如 32768需与模型能力匹配以确保长对话的稳定性。二、具体配置步骤与示例假设你已经在本地通过Ollama部署了qwen3.5:9b模型服务运行在http://127.0.0.1:11434以下是修改WinClaw配置的完整流程。步骤1定位并编辑配置文件WinClaw的配置文件通常位于其安装目录或用户配置文件夹下如%APPDATA%\WinClaw\config.yaml。用文本编辑器如VS Code、Notepad打开它。步骤2修改AI模型配置节找到配置文件中关于AI模型设置的段落并将其修改为对接本地Ollama服务的Qwen模型。# 修改前的默认配置对接OpenAI ai_model: provider: openai api_key: sk-your-openai-key-here # 你的OpenAI API密钥 model: gpt-4o-mini base_url: https://api.openai.com/v1 api_type: chat-completions context_window: 16384 # 修改后的配置对接本地Ollama的Qwen3.5-9B ai_model: provider: custom # 或 “openai-compatible”表示使用兼容OpenAI API的自定义服务 api_key: ollama # 本地Ollama通常不需要有效的API Key可填写任意非空字符串如”ollama“ model: qwen3.5:9b # 必须与 ollama run qwen3.5:9b 中的模型名称一致 base_url: http://127.0.0.1:11434/v1 # Ollama默认的OpenAI兼容API端点 api_type: chat-completions # Ollama使用标准的chat completions端点 context_window: 32768 # Qwen3.5-9B支持32K上下文步骤3配置OpenClaw网关如适用如果WinClaw内部集成了OpenClaw网关可能还需要确保网关配置正确特别是端口和转发规则。OpenClaw网关默认使用18789端口需确保防火墙允许该端口的入站连接。# 在Windows PowerShell管理员中运行放行OpenClaw网关端口 New-NetFirewallRule -DisplayName OpenClaw Gateway -Direction Inbound -LocalPort 18789 -Protocol TCP -Action Allow步骤4保存并重启WinClaw保存配置文件后完全退出并重新启动WinClaw应用程序以使新的配置生效。三、使用阿里云DashScope在线API的配置示例如果你希望使用阿里云提供的免费额度在线调用Qwen模型如Qwen3.5-Plus配置方式有所不同。你需要注册阿里云账号并开通DashScope服务以获取API Key。# 配置对接阿里云DashScope在线API的Qwen模型 ai_model: provider: custom api_key: sk-your-dashscope-api-key-here # 从阿里云DashScope控制台获取 model: qwen3.5-plus # 或 “qwen3.5-9b”具体模型名参考DashScope文档 base_url: https://dashscope.aliyuncs.com/compatible-mode/v1 # DashScope的OpenAI兼容模式专用地址 api_type: chat-completions context_window: 32768四、验证与测试配置修改并重启后建议通过一个简单的任务来测试连接是否成功。在WinClaw的Web界面或聊天框中输入一个简单的、不涉及系统操作的纯聊天指令例如“请用一句话介绍你自己。”观察AI的回复。如果回复内容符合Qwen模型的风格例如开头可能是“我是通义千问…”并且没有出现“模型不可用”、“API错误”等提示则说明配置成功。随后可以尝试一个简单的文件操作指令如“请在桌面创建一个名为‘test_qwen.txt’的文件并写入‘Hello from Qwen!’。” 观察其是否能够正确规划并执行。五、常见问题与排查错误模型调用失败或超时检查服务状态确保你的模型服务Ollama正在运行。可以在浏览器中访问http://127.0.0.1:11434/api/tags来验证Ollama是否正常响应。检查base_url确认base_url地址和端口完全正确且包含正确的API路径前缀如/v1。检查防火墙确认防火墙没有阻止WinClaw或本地服务端口如11434, 18789的通信。错误模型名称无效核对model字段确保其与后端服务中的模型标识一字不差。Ollama的模型名可通过ollama list命令查看。错误API密钥错误对于本地部署api_key可以是一个占位符但字段不能为空。对于在线API如DashScope请确保API Key有效且未被禁用。通过以上配置修改和步骤你就可以成功地将免费的Qwen大模型接入WinClaw从而在享受本地AI自动化便利的同时免除了使用商业API的费用。这种组合特别适合对数据隐私有要求、希望深度定制或进行技术学习的用户。参考来源Windows下OpenClaw安装避坑Qwen3.5-9B接口配置详解-CSDN博客Windows原生部署OpenClaw并对接千问大模型Qwen的全流程(新手零踩坑)免配置就能跑模型OpenClaw 镜像直连 Qwen3-32B 指南
用免费大模型如Qwen系列接入WinClaw作为OpenClaw的Windows友好版本时核心配置修改集中在AI模型提供商、API端点、模型标识以及必要的认证信息上。由于OpenClaw/WinClaw的设计初衷是作为连接大语言模型LLM与本地系统操作的“智能网关”其配置必须准确匹配目标大模型的API协议和参数。以下是将WinClaw的AI“大脑”从默认的OpenAI服务切换到免费/开源模型以阿里云通义千问Qwen3.5-9B的本地部署为例所需修改的关键配置项、具体操作步骤及代码示例。一、核心配置项修改详解WinClaw的配置通常存储在一个YAML或JSON格式的配置文件中如config.yaml。接入免费大模型你需要修改配置文件中与AI模型相关的部分。主要涉及以下几个模块配置项默认值如OpenAI接入Qwen等免费模型需修改为说明与注意事项ai_model.provideropenaicustom或openai-compatible指明使用的是自定义或兼容OpenAI API协议的第三方服务。ai_model.api_keyOpenAI的sk-...你的API Key或占位符对于本地部署的QwenAPI Key可能非必需或可填写任意值对于DashScope阿里云在线API需填写其提供的API Key。ai_model.modelgpt-4o-mini具体模型ID如qwen3.5-9b必须与后端服务提供的模型标识完全一致否则调用会失败。ai_model.base_urlhttps://api.openai.com/v1模型服务的API基础地址这是最关键的修改。需指向你的Qwen模型服务地址如本地Ollama的http://127.0.0.1:11434/v1或DashScope的https://dashscope.aliyuncs.com/compatible-mode/v1。ai_model.api_typechat-completionschat-completions或openai-completions需根据后端服务支持的API路径选择。OpenClaw网关通常适配/v1/chat/completions端点。ai_model.context_window例如 16384模型的实际上下文长度如 32768需与模型能力匹配以确保长对话的稳定性。二、具体配置步骤与示例假设你已经在本地通过Ollama部署了qwen3.5:9b模型服务运行在http://127.0.0.1:11434以下是修改WinClaw配置的完整流程。步骤1定位并编辑配置文件WinClaw的配置文件通常位于其安装目录或用户配置文件夹下如%APPDATA%\WinClaw\config.yaml。用文本编辑器如VS Code、Notepad打开它。步骤2修改AI模型配置节找到配置文件中关于AI模型设置的段落并将其修改为对接本地Ollama服务的Qwen模型。# 修改前的默认配置对接OpenAI ai_model: provider: openai api_key: sk-your-openai-key-here # 你的OpenAI API密钥 model: gpt-4o-mini base_url: https://api.openai.com/v1 api_type: chat-completions context_window: 16384 # 修改后的配置对接本地Ollama的Qwen3.5-9B ai_model: provider: custom # 或 “openai-compatible”表示使用兼容OpenAI API的自定义服务 api_key: ollama # 本地Ollama通常不需要有效的API Key可填写任意非空字符串如”ollama“ model: qwen3.5:9b # 必须与 ollama run qwen3.5:9b 中的模型名称一致 base_url: http://127.0.0.1:11434/v1 # Ollama默认的OpenAI兼容API端点 api_type: chat-completions # Ollama使用标准的chat completions端点 context_window: 32768 # Qwen3.5-9B支持32K上下文步骤3配置OpenClaw网关如适用如果WinClaw内部集成了OpenClaw网关可能还需要确保网关配置正确特别是端口和转发规则。OpenClaw网关默认使用18789端口需确保防火墙允许该端口的入站连接。# 在Windows PowerShell管理员中运行放行OpenClaw网关端口 New-NetFirewallRule -DisplayName OpenClaw Gateway -Direction Inbound -LocalPort 18789 -Protocol TCP -Action Allow步骤4保存并重启WinClaw保存配置文件后完全退出并重新启动WinClaw应用程序以使新的配置生效。三、使用阿里云DashScope在线API的配置示例如果你希望使用阿里云提供的免费额度在线调用Qwen模型如Qwen3.5-Plus配置方式有所不同。你需要注册阿里云账号并开通DashScope服务以获取API Key。# 配置对接阿里云DashScope在线API的Qwen模型 ai_model: provider: custom api_key: sk-your-dashscope-api-key-here # 从阿里云DashScope控制台获取 model: qwen3.5-plus # 或 “qwen3.5-9b”具体模型名参考DashScope文档 base_url: https://dashscope.aliyuncs.com/compatible-mode/v1 # DashScope的OpenAI兼容模式专用地址 api_type: chat-completions context_window: 32768四、验证与测试配置修改并重启后建议通过一个简单的任务来测试连接是否成功。在WinClaw的Web界面或聊天框中输入一个简单的、不涉及系统操作的纯聊天指令例如“请用一句话介绍你自己。”观察AI的回复。如果回复内容符合Qwen模型的风格例如开头可能是“我是通义千问…”并且没有出现“模型不可用”、“API错误”等提示则说明配置成功。随后可以尝试一个简单的文件操作指令如“请在桌面创建一个名为‘test_qwen.txt’的文件并写入‘Hello from Qwen!’。” 观察其是否能够正确规划并执行。五、常见问题与排查错误模型调用失败或超时检查服务状态确保你的模型服务Ollama正在运行。可以在浏览器中访问http://127.0.0.1:11434/api/tags来验证Ollama是否正常响应。检查base_url确认base_url地址和端口完全正确且包含正确的API路径前缀如/v1。检查防火墙确认防火墙没有阻止WinClaw或本地服务端口如11434, 18789的通信。错误模型名称无效核对model字段确保其与后端服务中的模型标识一字不差。Ollama的模型名可通过ollama list命令查看。错误API密钥错误对于本地部署api_key可以是一个占位符但字段不能为空。对于在线API如DashScope请确保API Key有效且未被禁用。通过以上配置修改和步骤你就可以成功地将免费的Qwen大模型接入WinClaw从而在享受本地AI自动化便利的同时免除了使用商业API的费用。这种组合特别适合对数据隐私有要求、希望深度定制或进行技术学习的用户。参考来源Windows下OpenClaw安装避坑Qwen3.5-9B接口配置详解-CSDN博客Windows原生部署OpenClaw并对接千问大模型Qwen的全流程(新手零踩坑)免配置就能跑模型OpenClaw 镜像直连 Qwen3-32B 指南
)
