安装:把 settings 改到 TaoToken 的完整配置)
1. Windows10 装 Openclaw 到底卡在哪本地 Agent 运行时的真实门槛Openclaw 是一个本地 Agent 运行时框架简单说就是让大模型从「只会聊天」变成「能动手操作你电脑」的那层壳。你在对话框里说一句「帮我把 F 盘那堆截图按日期归档」它真的会去调文件系统、执行脚本、跑命令。适合谁适合想在 Windows10 上跑本地自动化、又不想把数据全丢给云端的人也适合手里已经有一堆模型 Key、想统一收口到一个配置文件里的开发者。但 Windows10 这个环境装 Openclaw 的坑比 Linux 和 macOS 多得多。我自己在 Win10 上折腾的时候最先撞上的不是模型问题而是三件事PowerShell 脚本执行策略拦路、实时防护把安装脚本当可疑文件删掉、以及最关键的——openclaw.json里models.providers那段配置写错一个字段网关就起不来日志里只给你一句gateway closed (1006 abnormal closure)连个像样的报错都不给。这篇就聚焦一个核心动作把 Openclaw 的 settings也就是openclaw.json改到统一 Key / API 通道上让本地安装真正跑通到「能调用」的闭环。所谓统一通道就是把模型请求的 Base URL、API Key、Model ID 三件套收敛到一处而不是东一个阿里云、西一个别家。我实测下来用 TaoToken 做这个统一入口比较省心因为它兼容 OpenAI 的openai-completions协议Openclaw 的 provider 配置直接照抄格式就行。搜索「Window10 Openclaw 安装」的人多半已经卡在配置那一步了。所以这篇不会只讲「点下一步」而是把可复制的 JSON 片段、验证请求的命令、以及 401 / local proxy failed / reading choices 这些真实报错逐个拆开。你跟着做最后应该能拿到一个能正常对话、能触发工具调用的本地网关。先说清楚版本前提本文环境是 Windows10Openclaw 版本 2026.3.2Node.js 由安装脚本自动装。如果你版本差太多字段名可能对不上建议先对齐版本再往下走。2. 装 Openclaw 前把 TaoToken 通道准备好Key、Base URL、Model ID 三件套在动openclaw.json之前得先把「统一通道」这一端准备好。Openclaw 的 provider 配置本质就是告诉它请求发到哪个 Base URL、带哪个 Key、默认用哪个模型。这三样东西缺一不可而且必须严格对应否则就是 401 或者reading choices这类解析错误。我用的统一入口是 TaoToken。它的 API 地址是https://taotoken.net/api注意这个地址不带任何查询参数直接作为 Base URL 填进配置。Key 的获取走控制台登录后在 API Keys 页面创建复制出来的那串就是你要填进apiKey字段的值。模型 ID 则取决于你在通道里开通了哪些模型填的时候要和通道侧的名称一致比如claude-sonnet-4-5这种。这里有个容易踩的坑很多人把 Base URL 写成带/v1或者带斜杠结尾的形式结果请求路径拼出来变成/v1/v1/chat/completions直接 404。TaoToken 的 API 根就是https://taotoken.net/apiOpenclaw 的openai-completions适配器会自己补/v1/chat/completions所以你别手动加。这一点我在配置里反复验证过写对了才能通。三件套准备好之后先别急着改 Openclaw用一条 curl 命令单独验证通道是否可用。Windows10 的 PowerShell 里curl是Invoke-WebRequest的别名行为不一样建议直接用curl.execurl.exe https://taotoken.net/api/v1/chat/completions -H Content-Type: application/json -H Authorization: Bearer 你的Key -d {\model\:\你的ModelID\,\messages\:[{\role\:\user\,\content\:\ping\}]}如果返回里能看到choices数组和一段回复内容说明通道这一端是通的问题就只剩 Openclaw 的配置了。如果这里就报 401那先别碰 Openclaw回去检查 Key 有没有复制全、有没有多余空格。如果报模型不存在说明 Model ID 写错了去通道的模型列表里核对。这一步单独验证的价值在于「隔离变量」。很多人一上来就改openclaw.json结果网关起不来分不清是通道问题还是配置问题。先把通道用 curl 跑通后面排障就只剩一半的搜索空间。另外提醒一句Key 属于敏感信息别直接提交到 Git 仓库。本地配置文件自己留着就行真要分享配置片段把apiKey那行替换成占位符。3. 把 settings 改到 TaoTokenopenclaw.json 完整可复制配置Openclaw 的主配置文件在C:\Users\你的用户名\.openclaw\openclaw.json。这个路径是固定的安装脚本初始化后就会生成。你要做的核心改动是把models.providers里的 provider 换成指向 TaoToken 的配置同时把agents.defaults.model.primary指到对应的模型上。下面是我实测可用的完整片段你可以直接对照着改。注意 JSON 里不能有注释我下面为了讲解会单独说明每个字段但复制进文件时要去掉注释{ meta: { lastTouchedVersion: 2026.3.2, lastTouchedAt: 2026-03-11T02:37:30.029Z }, models: { providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: 你的TaoToken Key, api: openai-completions, models: [ { id: 你的ModelID, name: TaoToken 统一通道模型, contextWindow: 200000, maxTokens: 8192 } ] } } }, agents: { defaults: { model: { primary: taotoken/你的ModelID }, workspace: F:\\programer\\openclaw, compaction: { mode: safeguard }, maxConcurrent: 4, subagents: { maxConcurrent: 8 } } }, tools: { profile: full }, gateway: { port: 18789, mode: local, bind: loopback, auth: { mode: token, token: 你的访问令牌 }, tailscale: { mode: off, resetOnExit: false } } }几个关键点必须说透。第一baseUrl就是https://taotoken.net/api不要加/v1不要加结尾斜杠。第二api字段必须是openai-completions这是 Openclaw 里对应 OpenAI 兼容协议的适配器名写错了会走错解析逻辑。第三agents.defaults.model.primary的格式是provider名/模型ID也就是taotoken/你的ModelID这里的 provider 名要和上面providers里的键名完全一致大小写敏感。workspace建议放在 C 盘之外比如F:\programer\openclaw。Windows10 的 C 盘权限管得严Agent 执行文件操作时容易撞权限墙换个盘省很多事。注意 JSON 里反斜杠要转义成\\。gateway.auth.mode保持tokentoken字段是本地访问 Web UI 用的和模型 Key 是两码事别搞混。tailscale.mode设成off本地用不需要暴露到公网。改完保存然后重启网关让配置生效openclaw gateway restart openclaw gateway statusstatus里如果显示 gateway 在127.0.0.1:18789上监听就说明配置被正确加载了。如果起不来先看日志里有没有reading choices或者local proxy failed这两个报错在下一节展开。4. 验证请求从 Web UI 到命令行确认调用闭环配置改完、网关重启之后别急着庆祝得做连通性验证。验证分两层一层是网关本身活着另一层是模型调用真的能返回内容。第一层浏览器打开http://127.0.0.1:18789/#token你的访问令牌。这个 token 就是gateway.auth.token那个值。页面能正常加载出聊天界面说明网关进程和 Web UI 都正常。如果页面打不开先openclaw gateway status看进程在不在再看端口有没有被占用。第二层在 Web UI 的对话框里发一句最简单的「你好」。如果模型正常返回说明从 Openclaw 到 TaoToken 通道的整条链路是通的。这一步返回的内容会经过openai-completions适配器解析如果配置里api字段写错这里就会报reading choices之类的解析错误。命令行验证更直接用 Openclaw 自带的 doctor 或者直接发一条测试请求openclaw doctordoctor会检查配置文件语法、provider 可达性、模型 ID 是否匹配。如果它输出里 provider 那一项是绿色通过基本就稳了。我实测下来doctor能提前抓出大部分字段拼写错误比直接看网关日志高效。再进一步可以触发一次工具调用验证 Agent 能力。在 Web UI 里输入「列出当前工作目录下的文件」如果 Openclaw 真的去执行了文件系统操作并返回结果说明tools.profile设成full生效了Agent 运行时是完整的。这一步能跑通才算真正完成了「从安装到可用调用」的闭环。如果 Web UI 能打开但发消息没反应八成是模型调用超时或者 Key 无效。这时候回到第 2 节的 curl 命令用同样的 Key 和 Model ID 再测一次通道。通道通、Openclaw 不通问题就在openclaw.json通道也不通问题在 Key 或模型权限。验证通过后建议把openclaw gateway status和一次成功对话的截图留个记录。以后配置漂移了有个对照基线。5. 常见报错逐个拆401、local proxy failed、reading choices、OAuth这一节是排障核心我把 Windows10 装 Openclaw 改 TaoToken 配置时最常撞的四个报错拆开讲。每个都给你「现象 原因 动作」。401 Unauthorized。现象是 Web UI 发消息后返回鉴权失败或者 curl 测试直接 401。原因基本是apiKey字段的值不对要么复制时带了空格要么 Key 已经失效要么把gateway.auth.token误填到了apiKey里。动作回到 TaoToken 控制台的 API Keys 页面重新复制一次粘贴进openclaw.json的apiKey注意 JSON 字符串里不能有换行。改完openclaw gateway restart。local proxy failed。现象是网关日志里出现local proxy failed或者连接被拒绝。这个通常不是 Key 的问题而是baseUrl写错了比如写成了https://taotoken.net/api/v1导致路径重复或者网络层面对该域名解析异常。动作确认baseUrl严格是https://taotoken.net/api然后用第 2 节的 curl 命令单独测通道。如果 curl 通、Openclaw 不通检查是不是系统代理设置干扰了本地请求。reading choices 报错。现象是模型返回了内容但 Openclaw 解析时报reading choices或类似字段缺失。原因是api字段没设成openai-completions适配器用错了协议去解析响应。动作检查models.providers.taotoken.api的值必须是openai-completions。这个字段名很容易被忽略但它是解析逻辑的开关。OAuth 相关报错。现象是日志里出现 OAuth 认证失败或者 token 刷新错误。这是因为配置里残留了旧的auth.profiles段指向了某个 OAuth provider。动作如果你只用 TaoToken 的 Key 认证把auth.profiles整段删掉或者确保它不指向已废弃的 provider。Openclaw 在启动时会尝试加载 profiles 里的认证方式残留配置会干扰。再补一个 Windows10 特有的坑实时防护。安装阶段如果没临时关掉安装脚本可能被拦截导致 Node.js 或 Openclaw 二进制没装全。表现是openclaw命令找不到。动作确认安装时脚本完整跑完openclaw --version能输出版本号。如果命令不存在重跑安装脚本过程中把安全提示都选「允许」。排障的通用思路是「分层隔离」先用 curl 测通道再用openclaw doctor测配置最后用 Web UI 测端到端。哪一层断了就修哪一层别一上来就乱改配置。6. 配置收口之后把统一通道用顺的几个实操建议配置跑通只是开始真正用起来还有几个细节值得注意。第一模型 ID 和primary字段要成对维护。你以后在 TaoToken 通道里换了模型openclaw.json里models.providers.taotoken.models[].id和agents.defaults.model.primary两处都要改漏一处就会报模型不存在。建议改完统一跑一次openclaw doctor。第二workspace目录别放在系统盘根目录或者带空格的路径里。Windows10 下路径带空格有时会让 Agent 执行命令时参数解析出错。用F:\programer\openclaw这种干净路径最稳。第三Key 轮换的时候改完openclaw.json记得openclaw gateway restart光保存文件不会热加载。我试过改完不重启结果一直用旧 Key 报 401排查了半天才发现是没重启。第四如果你后面要接更多模型可以在providers里加多个 provider每个指向不同的 Base URL 和 Key然后在agents.defaults.models里做别名映射。这样切换模型不用改primary改别名就行。第五长期跑 Agent 任务的话maxConcurrent和subagents.maxConcurrent别设太大。Windows10 本地机器的资源有限并发太高反而容易卡死。我一般保持 4 和 8 这个量级。需要长期编码或者跑 Agent 任务的可以考虑用 Coding Plan 把额度固定下来比按量计费更可控。配置文档在接入文档里有更细的字段说明遇到拿不准的字段先去那里核对。模型本身的行为想快速验证直接开模型对话发几条测试消息最直观。Key 的管理和创建都在 API Keys 页面轮换的时候从那里操作。最后说个真实经验Openclaw 的配置文件字段名在不同版本间偶有调整升级版本后如果网关起不来第一件事是对照新版本文档检查openclaw.json的字段结构而不是怀疑通道。通道那端只要 curl 能通基本就是稳的。把配置收口到统一通道之后你换机器、换模型、换 Key改的都只是这一个文件里的几行维护成本会低很多。