1. Windows 原生跑 OpenClaw 对接 Qwen 到底难在哪很多人第一次在 Windows 上折腾 OpenClaw 对接 Qwen卡住的地方往往不是模型本身而是环境。OpenClaw 是一个基于 Node.js 的本地 AI 网关它把聊天、定时任务、代理转发这些能力打包成一个跑在本机的服务默认监听 18789 端口你通过浏览器就能和它交互。Qwen 则是阿里云百炼平台上的通义千问系列模型提供 OpenAI 兼容接口理论上只要填对 Base URL 和 Key 就能通。听起来简单但 Windows 原生环境不装 WSL、不碰 Linux 子系统下PowerShell 的执行策略、Node.js 版本、环境变量作用域、配置文件路径这几件事凑在一起新手很容易在第一步就报错退出。我实测下来最容易踩的坑有三个一是 PowerShell 默认禁止运行脚本npm install -g这类全局安装命令会直接抛UnauthorizedAccess二是 Node.js 版本低于 22 时OpenClaw 的部分依赖会编译失败报node-gyp相关错误三是配置文件openclaw.json放在%USERPROFILE%\.openclaw目录下很多人用记事本编辑后存成了.txt导致服务读不到配置。这篇就按「装环境 → 配 Key → 写配置 → 验证请求 → 排错」的顺序把每一步的命令和预期结果都写清楚你跟着敲就行。适合谁看手上有 Windows 10/11 笔记本、想本地跑一个能对接 Qwen 的 AI 网关、又不想装双系统或虚拟机的开发者。全程用原生 PowerShell不需要管理员权限的地方我会标注需要提权的地方也会说明。核心检索词就三个Windows 原生部署 OpenClaw、Qwen 接入、PowerShell 验证下面每个环节都会围绕它们展开。2. 前置准备Node.js、Git 与 TaoToken 统一 Key2.1 装 Node.js 22 LTS 并验证 PATHOpenClaw 官方要求 Node.js 22.x LTS。去 Node.js 官网下载 Windows 安装包.msi安装时务必勾选「Add to PATH」这一步决定了你后面能不能在 PowerShell 里直接敲node。装完打开一个普通PowerShell不需要管理员执行node -v npm -v预期输出类似v22.14.0和10.9.2。如果提示「无法将 node 识别为 cmdlet」说明 PATH 没生效关掉 PowerShell 重开一次或者手动把C:\Program Files\nodejs\加到系统环境变量里。这一步别跳过后面所有命令都依赖它。2.2 装 Git 并放开 PowerShell 执行策略OpenClaw 的部分依赖需要从 Git 仓库拉取所以先装 Git for Windows安装时同样勾选「Add Git to PATH」。装完在 PowerShell 里验证git --version然后处理执行策略。Windows 默认的Restricted策略会拦住 npm 的全局脚本以管理员身份打开 PowerShell执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force提示确认时输入Y。这条命令只影响当前用户不会动系统级策略相对安全。执行完可以用Get-ExecutionPolicy -Scope CurrentUser确认返回RemoteSigned。2.3 用 TaoToken 统一 Key 管理 Qwen 接入这里说下 Key 的事。Qwen 官方渠道需要你去阿里云百炼控制台创建 API Key按量付费和 Coding Plan 的 Base URL 不一样切换起来容易混。我自己的做法是用 TaoToken 做统一入口它把多家模型的 Key 收敛成一个Base URL 固定换模型只改 Model ID 就行省得每次翻控制台。具体操作访问 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后进控制台在 API Keys 页面创建一个新 Key复制保存。这个 Key 就是你后面填进openclaw.json的apiKey字段。TaoToken 的 API 端点固定为https://taotoken.net/api兼容 OpenAI 的/v1/chat/completions格式所以 OpenClaw 里选「Custom OpenAI Compatible API」就能对接。如果你坚持用 Qwen 官方渠道Base URL 填https://dashscope.aliyuncs.com/compatible-mode/v1Key 填sk-开头的那串。两种方式在 OpenClaw 配置里的结构完全一样只是baseUrl和apiKey不同。我建议新手先用 TaoToken 跑通链路因为它的 Key 不区分付费类型少一层心智负担。2.4 全局安装 OpenClaw保持管理员 PowerShell先配国内 npm 镜像加速可选但推荐npm config set registry https://registry.npmmirror.com npm install -g openclawlatest安装完成后验证openclaw --version能打印出版本号就说明装好了。如果卡在node-gyp报错九成是 Node.js 版本不对回 2.1 确认是不是 22.x。如果报EACCES权限错误说明你没用管理员 PowerShell重开一个提权的窗口再跑。3. 可复制配置openclaw.json 对接 Qwen 完整片段3.1 初始化向导与跳过方式OpenClaw 提供openclaw onboard交互式向导会问你选哪个 AI 提供商、填 Key、选默认模型。新手可以跟着走但向导里选项多容易在「Qwen OAuth」那一步卡住后面排错章节会讲。我推荐直接跳过向导手写配置文件可控性更强。先执行一次初始化生成目录结构openclaw onboard看到提示后输入y确认然后直接Ctrl C中断向导。这样%USERPROFILE%\.openclaw目录就建好了里面会有默认的openclaw.json。3.2 编辑 openclaw.json 的完整 JSON在文件管理器地址栏输入%USERPROFILE%\.openclaw回车找到openclaw.json右键用记事本或 VS Code 打开。全选原有内容替换为下面这段把apiKey换成你自己的{ models: { providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, api: openai-completions, models: [ { id: qwen3.5-flash, name: Qwen3.5-Flash, contextWindow: 131072, maxTokens: 8192 }, { id: qwen3.5-plus, name: Qwen3.5-Plus, contextWindow: 262144, maxTokens: 16384 }, { id: qwen3-coder-next, name: Qwen3-Coder-Next, contextWindow: 131072, maxTokens: 8192 } ] } } }, agents: { defaults: { model: { primary: taotoken/qwen3.5-plus } } }, gateway: { mode: local } }几个关键点baseUrl末尾不要带/v1OpenClaw 会自己拼/v1/chat/completionsapi字段固定写openai-completions这是协议类型primary的格式是提供商名/模型ID这里就是taotoken/qwen3.5-plus。如果你用 Qwen 官方渠道把taotoken改成bailianbaseUrl换成https://dashscope.aliyuncs.com/compatible-mode/v1即可。保存时注意记事本默认存成.txt一定要在「另存为」里把文件名写成openclaw.json编码选 UTF-8。存完在 PowerShell 里Get-Content $env:USERPROFILE\.openclaw\openclaw.json确认内容能正常读出没有乱码。3.3 环境变量与 gateway.mode 设置gateway.mode必须设为local否则启动时会报Gateway mode not set。上面 JSON 里已经加了。如果你不想改配置文件也可以在启动命令里加--allow-unconfigured临时绕过但长期用还是写进配置稳妥。另外如果你想让 OpenClaw 在后台常驻可以把它注册成 Windows 计划任务openclaw gateway install openclaw gateway startinstall会创建计划任务start启动服务关掉终端也不影响。想停就openclaw gateway stop想彻底卸载就openclaw gateway uninstall。4. PowerShell 验证请求与成功结果4.1 启动网关并查看状态配置写好后在管理员 PowerShell 里启动openclaw gateway run前台运行会实时打印日志你能看到它加载了哪些 provider、监听了哪个端口。正常输出里会有listening on 18789和provider taotoken loaded之类的字样。另开一个 PowerShell 窗口查状态openclaw status预期返回网关运行中、模型列表包含qwen3.5-plus。如果状态显示stopped说明前台窗口被关了重新跑gateway run即可。4.2 用 PowerShell 直接打 API 验证连通性不想开浏览器的话可以直接用 PowerShell 的Invoke-RestMethod打一次对话请求验证 Key 和 Base URL 是否通$headers { Authorization Bearer sk-你的TaoToken密钥 Content-Type application/json } $body { model qwen3.5-plus messages ( { role user; content 你好请用一句话介绍你自己 } ) } | ConvertTo-Json -Depth 5 Invoke-RestMethod -Uri https://taotoken.net/api/v1/chat/completions -Method Post -Headers $headers -Body $body如果返回一个包含choices数组的对象里面message.content有模型回复说明链路完全通了。这一步是纯 PowerShell 验证不依赖 OpenClaw 服务能帮你快速定位是 Key 问题还是 OpenClaw 配置问题。4.3 浏览器面板验证 Qwen 接入打开 Edge 或 Chrome访问http://localhost:18789进入 OpenClaw 管理面板。左侧菜单点「聊天」在输入框发一条「你好请介绍一下自己」。如果收到 Qwen 的回复而不是报错说明接入成功。面板里还能看到 Token 消耗统计方便你监控用量。如果面板打不开先确认gateway run窗口还在前台跑着再检查 18789 端口有没有被占用netstat -ano | findstr 18789。被占用的话换个端口在配置里加port: 18790再重启。5. 常见报错排查401、local proxy failed、reading choices5.1 401 unauthorized 与 token_missing报401或unauthorized/token_missing九成是 Key 填错或没生效。先检查openclaw.json里apiKey字段有没有多余空格再确认 Key 本身没过期。用 4.2 的 PowerShell 命令单独打一次 API如果也报 401说明 Key 有问题去 TaoToken 控制台重新生成一个。如果 PowerShell 能通但 OpenClaw 报 401说明配置文件没被读到执行openclaw doctor --fix清理认证缓存后重启网关。5.2 local proxy failed 与连接超时local proxy failed通常是网络层问题。先确认你的网络能正常访问https://taotoken.net/api在 PowerShell 里Test-NetConnection taotoken.net -Port 443看TcpTestSucceeded是不是True。如果是False检查防火墙有没有拦 Node.js或者换个网络环境比如手机热点再试。另外LLM request timed out多半是消息太长或模型响应慢把输入缩短到一两句话或者在配置里把超时时间调大。5.3 reading choices 报错与 OAuth 授权失败reading choices这个报错一般出现在返回体结构不符合预期时比如 Base URL 末尾多写了/v1导致路径变成/v1/v1/chat/completions。检查baseUrl是不是https://taotoken.net/api不要带/v1。OAuth 授权失败则常见于向导里误选了「Qwen OAuth」那个流程需要浏览器回调Windows 原生环境下容易卡住。解决办法是重新跑openclaw onboard在提供商选择那一步选「Custom OpenAI Compatible API」手动填 Base URL 和 Key跳过 OAuth。5.4 模型名带前缀导致的 Unknown model如果你在配置里把模型 ID 写成了dashscope/qwen-plus或taotoken/qwen3.5-plus这种带前缀的形式OpenClaw 会报Unknown model。模型 ID 只写简化名比如qwen3.5-plus前缀由primary字段里的提供商名/来体现。改完配置记得openclaw gateway restart让改动生效。6. 长期编码与 Agent 场景的 Key 管理建议跑通之后如果你打算把 OpenClaw 当日常编码助手或 Agent 网关长期用Key 管理就得讲究一点。我自己的做法是在 TaoToken 控制台按用途建多个 Key比如一个专门给 OpenClaw 用一个给 Cline 或 Claude Code 用这样某个 Key 出问题不影响其他工具。TaoToken 的 Coding Plan 适合长期高频调用的场景比按量付费更可控具体可以进控制台看套餐说明。另外OpenClaw 的定时任务模块Cron很适合做自动化比如每天早上自动拉一次 Qwen 生成日报草稿或者定时检查某个 API 的健康状态。配置入口在面板的「定时任务」页底层就是标准的 cron 表达式写起来和 Linux 上一样。代理模块Proxy则能让你把 OpenClaw 当成中间层转发请求到不同模型切换时只改配置不改代码。最后提醒一句openclaw.json里存的是明文 Key别把这个文件传到 Git 仓库或公开网盘。如果多人共用一台机器考虑用环境变量注入 KeyOpenClaw 支持在配置里写${TAOTOKEN_API_KEY}这种占位符启动时从系统环境变量读取。设置方法是在 PowerShell 里setx TAOTOKEN_API_KEY sk-你的密钥然后重启终端生效。这样配置文件本身就不含敏感信息分享起来也放心。
