1. Win10 装完 OpenClaw 却连不上模型先把通道这件事捋清楚OpenClaw 是一个可以跑在本地、通过命令行和 Web 控制台驱动的 AI 智能体框架能接多种模型提供商适合想在 Win10 上搭一套自己的编码/自动化助手的开发者。它的核心检索词就三个Win10、OpenClaw、settings 配置。很多人卡住不是因为装不上而是装完之后模型通道没配对openclaw gateway start起来了一发请求就报 401 或者local proxy failed。我自己在 Win10 22H2 上从零走了一遍一键脚本装依赖、npm install -g openclawlatest、openclaw onboard初始化最后把模型通道统一改到 TaoToken 的 API 地址上。整个过程最花时间的不是安装而是搞清楚 settings 文件里baseUrl、apiKey、model这三个字段到底写在哪、写成什么格式。这篇就把这份配置记录完整摊开包括可复制的 settings 片段、启动日志怎么读、模型列表怎么拉、最小对话请求怎么发以及几个我实际撞到的报错。适合谁看已经在 Win10 上装好 OpenClaw、但模型通道还没跑通的人或者正准备装、想一次性把通道配好的人。如果你还没装第 2 节会把前置动作补齐装和配连起来做。先说结论性的东西省得你翻到最后OpenClaw 的模型通道配置集中在用户目录下的 settings 文件里Win10 路径通常是C:\Users\你的用户名\.openclaw\settings.json。把里面的 provider 指向 TaoToken 的 API 地址https://taotoken.net/api填上统一 Key再指定一个 Model ID重启 gateway 就能生效。下面按顺序拆。2. 前置准备Win10 环境依赖与 TaoToken 统一 Key 获取这一节解决两件事把 OpenClaw 装到能跑以及拿到一个能用的 API Key。装的部分参考官方一键脚本配的部分走 TaoToken。2.1 Win10 依赖清单与一键安装Win10 家庭版和专业版都能装。硬件上 4GB 内存起步留 10GB 左右硬盘空间网络能正常访问 GitHub 和 npm 就行。右键开始菜单选“Windows PowerShell (管理员)”先放开脚本执行策略Set-ExecutionPolicy RemoteSigned -Scope CurrentUser然后跑官方安装脚本iwr -useb https://openclaw.ai/install.ps1 | iex脚本会自动把 Node.js、Git 这些依赖拉下来配好。如果你更想手动控制也可以自己装 Node.js LTS22.x 或 24.x安装时勾选 Add to PATH、Git同样勾 Add to PATH、最新版 Visual C Redistributable x64。手动装完再全局装 OpenClawnpm install -g openclawlatest国内网络拉包慢的话可以先切镜像再装npm config set registry https://registry.npmmirror.com/装完验证一下版本能打印出版本号就说明 PATH 没问题openclaw --version如果提示openclaw 不是内部或外部命令多半是 npm 全局路径没进 PATH。用npm prefix -g看全局目录把它加到系统环境变量里重开终端再试。2.2 拿 TaoToken 统一 KeyOpenClaw 支持多家模型提供商但一家家配 Key、记不同 Base URL 很烦。TaoToken 的做法是给一个统一入口一个 Key、一个 API 地址背后可以切不同模型。对 OpenClaw 这种要在 settings 里写死 provider 的工具来说统一通道省事很多。获取步骤不复杂打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册登录后进控制台在 API Keys 页面创建一个新 Key。创建时给它起个能认出来的名字比如openclaw-win10方便以后在 OpenClaw 里对号入座。Key 只在创建时完整显示一次复制下来存好后面 settings 里要用。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API Keys 页面是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。API 的基础地址是https://taotoken.net/api注意这个地址后面不加任何路径后缀OpenClaw 的 settings 里就填这个。注意Key 属于敏感凭据别写进会提交到 Git 的公开文件里。settings.json 在用户目录下一般不会被仓库跟踪但如果你手动复制配置到项目里记得排除。拿到 Key 之后先别急着改 OpenClaw可以用一条 curl 确认 Key 本身是通的。Win10 的 PowerShell 里 curl 是 Invoke-WebRequest 的别名建议直接用curl.execurl.exe https://taotoken.net/api/models -H Authorization: Bearer 你的Key能返回模型列表 JSON说明 Key 和网络都没问题再往下配 OpenClaw 就少一个变量。这一步很多人跳过结果后面报 401 时分不清是 Key 错还是 OpenClaw 配置错。3. 可复制配置把 OpenClaw 的 settings 改到 TaoToken这一节是全文核心。OpenClaw 的模型通道配置写在 settings 文件里改对它通道就通了。3.1 找到 settings 文件Win10 上 OpenClaw 的用户级配置默认在C:\Users\你的用户名\.openclaw\settings.json如果你跑过openclaw onboard这个文件应该已经生成了里面可能有向导写入的默认 provider。用记事本或 VS Code 打开它。如果文件不存在手动建一个也行OpenClaw 启动时会读。先备份一份改坏了能回退copy $env:USERPROFILE\.openclaw\settings.json $env:USERPROFILE\.openclaw\settings.json.bak3.2 settings.json 完整片段下面这份是实测能跑通的配置把 provider 指向 TaoToken字段名和路径都按 OpenClaw 的实际结构来。你可以整段替换也可以只改对应字段{ providers: { taotoken: { type: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: 你的TaoToken Key, models: { default: { id: claude-sonnet-4-5, name: Claude Sonnet 4.5 } } } }, defaultProvider: taotoken, gateway: { port: 18789, host: 127.0.0.1 } }几个字段逐个说清楚免得你改错type写openai-compatible因为 TaoToken 的 API 走的是 OpenAI 兼容协议OpenClaw 用这个类型去发请求。baseUrl就是https://taotoken.net/api不要加/v1也不要加斜杠结尾加了容易拼出双斜杠导致 404。apiKey填你刚才创建的那串 Key。models.default.id是 Model ID这个值要和你实际想用的模型对上写错了会在拉模型或发请求时报model not found。defaultProvider指向taotoken这样 OpenClaw 默认走这个通道。gateway那段是本地网关的监听地址默认127.0.0.1:18789一般不用动除非端口被占。提示如果你在 OpenClaw 里同时配了多家 providerdefaultProvider决定默认用哪家。想临时切模型改models.default.id再重启 gateway 即可不用动 Key。3.3 三件套对照Base URL、Key、Model ID不管你是用 OpenClaw 原生 settings还是通过 CC Switch、Cline MCP、Codex 的 auth.json 这类工具接入模型通道永远就三件套缺一不可项目值说明Base URLhttps://taotoken.net/api统一 API 入口不加路径后缀API Key控制台创建的 Key形如创建时复制的那串字符Model ID如claude-sonnet-4-5必须与通道支持的模型名一致这三样在 OpenClaw 的 settings 里分别对应baseUrl、apiKey、models.default.id。如果你用的是 Codex它的auth.json里对应的是base_url、api_key和模型字段字段名不同但含义一样。Cline 的 MCP 配置里则是baseUrl、apiKey、model。记住这三件套换任何工具都是同一套逻辑。改完保存别急着启动先确认 JSON 没语法错误。PowerShell 里可以快速校验Get-Content $env:USERPROFILE\.openclaw\settings.json | ConvertFrom-Json没报错就说明 JSON 结构合法。报Invalid JSON的话多半是多了逗号、少了引号或者中文引号混进去了。4. 验证请求启动日志、模型列表与最小对话配置写完不算完得逐项验证。这一节按启动日志、模型列表、最小对话三步走每步都有明确的成功标志。4.1 启动 gateway 并读日志先停掉可能还在跑的旧服务再启动openclaw gateway stop openclaw gateway start openclaw gateway statusstatus显示 running 就说明进程起来了。但进程起来不代表通道通关键看启动日志。日志里会打印它加载了哪个 provider、baseUrl 是什么。如果看到类似provider taotoken loaded, baseUrlhttps://taotoken.net/api的行说明 settings 被正确读取了。如果日志里还是旧的 provider 名字说明你改的文件不是它实际读的那个检查路径和文件名。日志里如果出现local proxy failed通常是 gateway 想连本地某个代理端口但没连上。检查 settings 里有没有残留的 proxy 字段或者系统环境变量里有没有指向本地端口的代理设置清掉再重启。4.2 拉取模型列表通道通不通拉一次模型列表最直接openclaw models list成功的话会打印一列可用模型。如果这一步报 401说明 Key 没被正确带上回去检查 settings 里apiKey字段有没有拼错、有没有多余空格。如果报reading choices之类的解析错误多半是 baseUrl 写成了带/v1的地址导致返回结构和预期对不上改回https://taotoken.net/api再试。也可以直接用 curl 对照确认是 OpenClaw 的问题还是通道本身的问题curl.exe https://taotoken.net/api/models -H Authorization: Bearer 你的Keycurl 能出结果、OpenClaw 出不来那就是 settings 的问题两个都出不来那就是 Key 或网络的问题。4.3 发一次最小对话请求最后一步发一条最短的对话确认端到端能跑openclaw chat 用一句话说明什么是递归能返回一句正常的中文回答就说明从 OpenClaw 到 TaoToken 再到模型这条链路全通了。如果返回空、或者报超时先看 gateway 日志里这次请求的状态码。200 但内容空可能是 Model ID 写错导致路由到了不存在的模型4xx 则是鉴权或参数问题。想更直观地验证模型行为也可以直接在模型对话页面手动发一条对照 OpenClaw 的输出是否一致https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。两边都能出结果基本可以确定配置没问题。如果你打算长期用 OpenClaw 跑编码或 Agent 任务而不是偶尔试一下可以考虑 Coding Plan 这类长期方案省得每次手动管额度https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。5. 本篇常见报错排查401、local proxy failed、reading choices配置过程中撞到的报错就那么几个逐个对照着排比盲改快得多。5.1 401 Unauthorized最常见。含义是请求没带上有效凭据或者凭据不对。排查顺序先确认 settings 里apiKey字段的值和你控制台创建的那串完全一致注意有没有复制时带上首尾空格再确认baseUrl没写错写错地址会导致请求发到别处自然 401最后确认 Key 没过期或被删。用 curl 单独测一次 Key能区分是 Key 的问题还是 OpenClaw 读取的问题。5.2 local proxy failed这个报错说明 gateway 尝试走本地代理但失败了。Win10 上常见原因是系统里设了本地代理端口或者 settings 里残留了 proxy 配置。检查settings.json里有没有proxy相关字段有就删掉再检查系统环境变量HTTP_PROXY、HTTPS_PROXY有没有指向本地端口有就临时清掉再重启 gateway。清掉后如果恢复正常说明就是代理配置在捣乱。5.3 reading choices 解析错误报错里带reading choices或类似字段解析失败通常是返回的 JSON 结构和 OpenClaw 预期的不一致。头号原因是 baseUrl 写成了https://taotoken.net/api/v1这种带后缀的形式导致请求路径拼错、返回了非预期内容。把 baseUrl 改回https://taotoken.net/api重启 gateway 再试。另一个可能是 Model ID 写错通道把请求路由到了不存在的模型返回了错误结构。5.4 OAuth 相关报错如果你在 onboard 阶段选了需要 OAuth 的 provider后面又改成 TaoToken可能会残留 OAuth 配置导致冲突。表现是启动时提示 OAuth token 无效或找不到。解决办法是检查 settings 里有没有oauth字段删掉或者干脆重新跑一次openclaw onboard在选 provider 时直接选 OpenAI 兼容类型填 TaoToken 的三件套。5.5 命令找不到 / PATH 问题openclaw命令找不到或者npm全局装的包调不起来基本都是 PATH 没配好。用npm prefix -g看全局安装目录把那个目录加到系统环境变量的 Path 里重开终端。Win10 上改完环境变量一定要新开一个 PowerShell 窗口旧窗口不会自动刷新。排障时如果拿不准是通道问题还是工具问题接入文档里有更细的字段说明可以对照https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。需要重新生成或管理 Key 就去 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。6. 把通道固定下来后续维护与统一入口配置跑通之后日常维护其实就几件事。模型想换改models.default.id重启 gatewayKey 想轮换去控制台新建一个替换 settings 里的apiKey重启端口冲突改gateway.port。每次改完都用Get-Content ... | ConvertFrom-Json校验一下 JSON能省掉很多“改了没生效”的困惑。我自己的习惯是把 settings.json 的备份和当前版本放一起改之前先 copy 一份带日期的备份出问题直接回退比逐行找错快。另外OpenClaw 的 gateway 日志建议留着排障时它是唯一能告诉你“请求到底发去哪了”的地方。如果你后面要在多台机器、多个工具之间共用同一套模型通道统一入口的价值会更明显——一个 Key、一个 Base URLOpenClaw、Codex、Cline 都填同一套三件套不用每家单独记。控制台里可以随时看 Key 的使用情况需要新建或吊销也在同一处https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。Claude Code 这类工具的接入配置文档里有对应章节https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后留一个实操建议每次改完 settings别只跑openclaw chat把openclaw models list也跑一遍。前者验证端到端后者验证通道鉴权两个都过才算真的配好了。