Windows10 本地部署 OpenClaw：把 endpoint 改到 TaoToken 的完整配置

1. Windows10 本地部署 OpenClaw 踩坑实录从 Invalid URL 到网关跑通OpenClaw 是一个可以在本地跑起来的 AI Agent 网关它把模型调用、技能插件、工作流编排都收在一个本地服务里你通过浏览器就能操作。适合谁适合那些不想把 API Key 散落在各种脚本里、希望本地统一管理模型通道的开发者。而 TaoToken 在这里扮演的角色就是给 OpenClaw 提供一个统一的模型出口——你不需要在 OpenClaw 里分别配置 OpenAI、Anthropic 各家 Key只要把 endpoint 指向 TaoToken用一把 Key 就能调度多个模型。我在 Windows10 上第一次装 OpenClaw 的时候装完直接报了一串Invalid URL的错堆栈里全是undici和proxy-agent的路径。当时以为是 Node 版本问题重装了两遍才发现是环境变量里残留的代理配置被 undici 读到了空字符串也能触发 URL 解析失败。这个坑后面会详细讲怎么排。这篇内容聚焦的是「本地部署 endpoint 改到 TaoToken」这个环节。Node.js 安装、OpenClaw 全局安装这些步骤我会给命令但不会展开讲原理重点放在配置文件怎么写、endpoint 怎么改、启动参数怎么加、请求怎么验证连通性。你跟着做应该能在半小时内把本地 OpenClaw 跑通并走 TaoToken 通道。先明确几个关键路径后面配置会反复用到项目Windows10 路径OpenClaw 全局安装目录C:\Users\用户名\AppData\Roaming\npm\node_modules\openclaw工作空间目录C:\Users\用户名\OpenClaw-Workspace配置文件工作空间下的config.json或settings.json默认网关端口18789dev 模式 19001控制台端口18788TaoToken 的 API 地址是https://taotoken.net/api这个地址在配置里会作为 base URL 出现。注意不要带 UTM 参数API 调用只需要干净的域名路径。2. TaoToken 前置准备Key、模型 ID 与 OpenClaw 的对接逻辑在改 OpenClaw 配置之前你得先把 TaoToken 这边的三件套准备好Base URL、API Key、Model ID。这三样东西在 OpenClaw 的配置里是绑在一起的缺一个请求就会失败。Base URL 固定是https://taotoken.net/api。API Key 需要你去控制台生成地址是https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite。生成的时候给它起个名字比如openclaw-local方便后面在用量页面区分是哪个客户端在调。Model ID 这块要注意TaoToken 支持的模型列表在文档里有地址是https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite。你选一个常用的比如claude-sonnet-4-20250514或者gpt-4o记下准确的模型 ID 字符串。OpenClaw 配置里填错一个字符请求就会返回模型不存在的错误。OpenClaw 的模型调用逻辑是这样的它在本地起一个网关服务网关收到你的对话请求后根据配置里的 provider 信息把请求转发到对应的 base URL。默认情况下 OpenClaw 可能内置了一些 provider 模板但我们要做的是自定义一个 provider把 base URL 指向 TaoToken把 apiKey 填成你生成的那把 Key。这里有个容易混淆的点OpenClaw 的配置里可能同时存在providers和models两个层级。provider 定义的是「往哪里发请求」model 定义的是「用哪个模型、走哪个 provider」。你需要两边都改只改一边请求会找不到路由。如果你之前已经在环境变量里设过OPENAI_API_KEY或ANTHROPIC_API_KEY建议先清掉避免 OpenClaw 优先读了环境变量而忽略配置文件。Windows10 下用 PowerShell 检查Get-ChildItem Env: | Where-Object { $_.Name -match API_KEY|PROXY }看到有代理相关的变量先记下来后面排障会用到。TaoToken 的 Key 不要写进系统环境变量直接写在 OpenClaw 的配置文件里就行这样换 Key 的时候只改一个地方。另外提一句如果你打算长期在本地跑 OpenClaw 做编码或 Agent 任务可以考虑用 Coding Plan地址是https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite。它和按量计费的 Key 是分开的额度体系适合高频调用场景。不过这篇教程里我们用普通 API Key 就能跑通你先按下面的步骤配。3. 可复制配置OpenClaw 的 endpoint 与鉴权片段这一节是核心你直接复制下面的配置片段改掉 Key 和模型 ID 就能用。OpenClaw 的配置文件通常在工作空间目录下文件名可能是config.json或settings.json。如果你还没初始化工作空间先执行mkdir $HOME\OpenClaw-Workspace cd $HOME\OpenClaw-Workspace openclaw init初始化完成后找到配置文件。用记事本或 VS Code 打开把 provider 和 model 部分改成下面这样。这是一个 JSON 格式的配置片段{ providers: { taotoken: { type: openai-compatible, baseURL: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, models: [ { id: claude-sonnet-4-20250514, name: Claude Sonnet 4 via TaoToken } ] } }, defaultModel: taotoken/claude-sonnet-4-20250514, gateway: { port: 18789, host: 127.0.0.1 } }几个关键字段说明type填openai-compatible因为 TaoToken 的 API 兼容 OpenAI 的请求格式。baseURL就是https://taotoken.net/api注意结尾不要加/v1OpenClaw 会自己拼路径。apiKey填你生成的那把 Key以sk-开头。models数组里可以放多个模型每个模型一个对象id是 TaoToken 文档里的模型 ID。defaultModel的格式是provider名/模型ID这里就是taotoken/claude-sonnet-4-20250514。如果你配了多个 provider这个字段决定默认走哪个。如果你的 OpenClaw 版本用的是 TOML 格式配置等价写法如下[providers.taotoken] type openai-compatible baseURL https://taotoken.net/api apiKey sk-你的TaoToken密钥 [[providers.taotoken.models]] id claude-sonnet-4-20250514 name Claude Sonnet 4 via TaoToken [gateway] port 18789 host 127.0.0.1 defaultModel taotoken/claude-sonnet-4-20250514改完配置后先别急着启动。检查一下 JSON 有没有语法错误可以用 PowerShell 验证Get-Content .\config.json -Raw | ConvertFrom-Json如果没有报错说明 JSON 格式没问题。如果报Invalid JSON primitive检查是不是有多余的逗号或引号没闭合。还有一个细节Windows10 下路径分隔符是反斜杠但配置文件里如果涉及路径字段建议用正斜杠/或双反斜杠\\避免转义问题。不过我们上面的配置里没有路径字段所以不用管。配置改完后如果你之前启动过 OpenClaw需要先停掉再重启配置才会生效。停掉的命令后面排障章节会讲。4. 启动与验证从 gateway start 到请求连通性测试配置写好后启动 OpenClaw 网关。前台启动适合测试你能直接看到日志输出openclaw gateway start如果看到类似Gateway listening on 127.0.0.1:18789的输出说明网关起来了。这时候打开浏览器访问http://localhost:18788应该能看到控制台界面。但控制台能打开不代表模型通道通了。你需要发一个实际请求来验证 TaoToken 的 endpoint 是否配置正确。有两种验证方式。第一种在 OpenClaw 控制台里新建一个对话发一句「你好请回复你的模型名称」。如果配置正确你会看到模型返回的内容。如果报错控制台通常会显示错误信息记下错误码。第二种直接用 PowerShell 发 HTTP 请求测试 TaoToken 的连通性绕过 OpenClaw 先确认 Key 和 endpoint 没问题$headers { Authorization Bearer sk-你的TaoToken密钥 Content-Type application/json } $body { model claude-sonnet-4-20250514 messages ({ role user; content 回复OK两个字母 }) max_tokens 10 } | ConvertTo-Json -Depth 5 Invoke-RestMethod -Uri https://taotoken.net/api/v1/chat/completions -Method Post -Headers $headers -Body $body如果返回里有choices字段和内容说明 TaoToken 这边完全正常。如果这一步就报 401那是 Key 的问题如果报连接超时那是网络或代理的问题。先把这个测试跑通再回去看 OpenClaw 的配置。OpenClaw 网关启动后你也可以用 curl 测试本地网关是否在转发请求curl -X POST http://127.0.0.1:18789/v1/chat/completions -H Content-Type: application/json -d {\model\:\taotoken/claude-sonnet-4-20250514\,\messages\:[{\role\:\user\,\content\:\test\}]}注意 Windows10 的 PowerShell 里 curl 是Invoke-WebRequest的别名参数格式和 Linux 的 curl 不一样。如果上面的命令报参数错误改用Invoke-RestMethodInvoke-RestMethod -Uri http://127.0.0.1:18789/v1/chat/completions -Method Post -ContentType application/json -Body {model:taotoken/claude-sonnet-4-20250514,messages:[{role:user,content:test}]}如果本地网关返回了模型响应说明 OpenClaw 到 TaoToken 的整条链路都通了。这时候你可以把启动方式改成后台避免关掉终端服务就停Start-Job -ScriptBlock { openclaw gateway start }用Get-Job可以看到后台任务状态。需要停止的时候用Stop-Job加任务 ID。验证通过后建议把控制台地址http://localhost:18788存个书签。日常使用就是打开这个页面在对话框里选模型、发指令。模型列表里应该能看到你配置的Claude Sonnet 4 via TaoToken。5. 常见报错排查Invalid URL、401 与网关拒绝连接这一节对照真实报错来排。我在 Windows10 上踩过的坑基本都在这里了。报错一TypeError: Invalid URL at new URL完整堆栈类似[openclaw] Unhandled promise rejection: TypeError: Invalid URL at new URL (node:internal/url:826:25) at #getUrl (.../undici/lib/dispatcher/proxy-agent.js:231:14) at new ProxyAgent (.../undici/lib/dispatcher/proxy-agent.js:109:29) at new EnvHttpProxyAgent (.../undici/lib/dispatcher/env-http-proxy-agent.js:28:31)这个报错的根源是环境变量里有HTTP_PROXY或HTTPS_PROXY而且值可能是空字符串或者格式不对。undici 在构造 ProxyAgent 的时候会尝试解析这个值空字符串也会触发new URL()直接抛异常。解决办法是在启动 OpenClaw 之前清掉这两个变量$env:HTTP_PROXY $env:HTTPS_PROXY $env:http_proxy $env:https_proxy 注意大小写都要清Windows 下环境变量不区分大小写但 undici 读的时候可能两种都查。清完之后再启动网关这个报错就消失了。如果你确实需要走代理才能访问外网那要把代理地址写成完整格式比如http://127.0.0.1:端口不能留空。但 TaoToken 的 API 地址在国内可以直接访问不需要代理所以直接清掉最省事。报错二401 Unauthorized或invalid api key这个通常是 Key 的问题。检查三个地方配置文件里的apiKey是不是完整复制了有没有多余空格Key 是不是已经过期或被删除请求头里的Bearer前缀有没有漏掉。用第 4 节的 PowerShell 测试命令直接打 TaoToken 的 API如果也报 401那就是 Key 本身的问题去控制台重新生成一把。如果直接打 API 正常但 OpenClaw 报 401那是 OpenClaw 配置里 Key 写错了重新检查配置文件。报错三connect ECONNREFUSED 127.0.0.1:18789网关没起来或者端口被占用。先确认openclaw gateway start有没有在运行。如果终端里没有输出Gateway listening说明启动失败了看前面的报错信息。端口被占用的情况用这个命令查netstat -ano | findstr :18789如果有其他进程占着这个端口要么停掉那个进程要么改 OpenClaw 的端口配置。改端口在配置文件的gateway.port字段改成 18790 之类的空闲端口然后重启网关。报错四reading choices或Cannot read properties of undefined这个报错说明 OpenClaw 收到了响应但响应结构里没有choices字段。常见原因是 base URL 配错了比如多加了/v1或者少加了路径导致请求打到了错误的端点返回了一个非预期格式的响应。检查配置里的baseURL是不是严格的https://taotoken.net/api。OpenClaw 会在这个基础上拼/v1/chat/completions如果你自己加了/v1最终路径就变成了/api/v1/v1/chat/completions肯定不对。报错五OAuth 相关错误如果你在 OpenClaw 里启用了某些需要 OAuth 的 provider但没配对应的 token会报 OAuth 错误。我们的配置用的是openai-compatible类型加 API Key不涉及 OAuth。如果你看到 OAuth 报错检查是不是type字段写错了或者配置文件里残留了其他 provider 的配置。排障的基本思路是先用 PowerShell 直接测 TaoToken API确认 Key 和 endpoint 没问题再测本地网关端口是否在监听最后看 OpenClaw 日志里的具体错误。一层一层往下查不要跳步。6. 把本地 OpenClaw 用起来模型对话与长期编码的入口配置跑通之后日常使用就是打开http://localhost:18788在控制台里选模型、发指令。如果你想快速验证某个模型的效果可以直接用模型对话页面地址是https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite在网页上直接试不用改本地配置。如果你打算把 OpenClaw 当成长期的编码助手或 Agent 运行环境建议把网关设成开机自启。Windows10 下可以用任务计划程序创建一个登录时触发的任务执行openclaw gateway start。这样每次开机网关自动起来你打开浏览器就能用。还有一个实用技巧OpenClaw 的工作空间目录里可以放技能插件和自定义脚本。你可以在$HOME\OpenClaw-Workspace\skills下建自己的技能目录OpenClaw 启动时会自动加载。具体格式参考官方文档这里不展开。Key 的管理方面如果你有多台机器或者多个项目建议在 TaoToken 控制台给每个用途生成独立的 Key比如openclaw-desktop、openclaw-laptop。这样在用量页面能清楚看到每个 Key 的消耗某个 Key 泄露了也能单独吊销不影响其他的。最后提醒一点配置文件里的 API Key 是明文存储的不要把工作空间目录提交到 Git 仓库。如果确实需要版本管理把config.json加到.gitignore里或者用环境变量引用 Key 的方式。不过前面说了环境变量方式在 Windows10 下容易和代理变量混淆所以本地个人使用直接写配置文件最省事注意别外传就行。整套流程走下来核心就是三件事Node 版本要 v24 以上、代理变量要清干净、endpoint 要精确指向https://taotoken.net/api。这三件事做对了Windows10 本地跑 OpenClaw 基本不会遇到大问题。