1. OpenClaw 在 Windows 上到底装的是什么，为什么 settings 才是关键
OpenClaw 是一款跑在你自己电脑上的本地 AI 助手，它不是一个网页服务，而是一个常驻进程：你通过 Web UI、Telegram、Discord 等入口给它发指令，它在本地执行文件操作、终端命令、浏览器控制这类自动化任务。换句话说，模型负责“想”，OpenClaw 负责“动手”，而两者之间的连接点就是配置文件里的接口地址和鉴权项。
很多人第一次在 Windows 上装 OpenClaw，卡住的地方不是安装本身，而是装完之后模型调不通。原因通常有两个：一是 Node.js 版本不够，二是 settings 里还留着默认的 provider 地址，没有改到自己的统一通道。这篇就按“下载 → 依赖检查 → 安装 → 改 settings → 发一次最小请求验证”的顺序走一遍，重点放在 settings 文件的完整改法和验证动作上。
适合谁看：手上是 Windows 10/11、想用 OpenClaw 做本地自动化、并且希望把模型请求统一走一个入口的人。你需要准备的东西不多：一台能装软件的 Windows 电脑、Node.js 22 或更高版本、以及一个可用的 API Key。下面所有命令都在 PowerShell 里执行，遇到权限提示就用管理员身份重开一个窗口。
先明确一个概念，OpenClaw 的配置是 JSON 格式，默认落在%USERPROFILE%\.openclaw\openclaw.json。这个文件里models.providers决定了请求发往哪里，agents.defaults.model.primary决定了默认用哪个模型。把这两块改对，通道就通了。后面我会给出可直接复制的片段，你只需要替换 Key。
2. 装 OpenClaw 前的 Node.js 依赖检查与 TaoToken 通道准备
OpenClaw 对运行时版本有硬要求：Node.js 22 或更高。版本低了会在启动阶段直接报错，所以第一步不是装 OpenClaw，而是确认 Node 版本。打开 PowerShell，输入：
node --version npm --version如果node --version输出的是 v22.x.x 及以上，就可以跳过安装。如果低于 22 或者提示“不是内部或外部命令”，说明没装或没进 PATH。推荐用 winget 装，省去手动配环境变量：
winget install OpenJS.NodeJS.LTS装完关掉当前 PowerShell，重新开一个窗口再跑一次node --version确认。这里有个容易忽略的点：Windows 上装完 Node 后，旧窗口的 PATH 不会刷新，必须重开窗口，否则你会以为装失败了。
依赖确认后，准备通道侧的东西。TaoToken 提供统一的接口入口，你需要在控制台创建一个 API Key，后面填进 settings 的apiKey字段。创建入口在 API Keys 页面，建议单独建一个给 OpenClaw 用的 Key，方便后续排查和轮换。相关地址：
- 控制台：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite
- API Keys：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite
- 接入文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite
API 的基础地址是https://taotoken.net/api，注意这个地址不带任何查询参数，直接写进配置即可。不同模型系列对应的路径后缀不一样，Claude 系列走/anthropic，GPT 系列走/openai，Gemini 系列走/openai/v1，这一点在下一节的配置片段里会体现。先把 Key 复制到记事本备用，别直接贴在聊天窗口里。
3. 安装 OpenClaw 并改写 settings 到 TaoToken 的完整配置
安装命令只有一行，全局装：
npm install -g openclaw装完验证：
openclaw --version能打印版本号就说明二进制已经就位。如果提示找不到命令，八成是 npm 全局目录没进 PATH，重开 PowerShell 或检查 npm 的 prefix 配置。接下来跑一次引导，让它生成默认配置文件：
openclaw onboard --install-daemon引导过程中，Model/auth provider 这一步选Skip for now，我们稍后手动改 settings，比在向导里填更可控。其余步骤按提示走，Gateway service 选 Install，最后选 Hatch in TUI 体验一下交互界面即可。引导结束后，配置文件就生成在%USERPROFILE%\.openclaw\openclaw.json。
现在打开它。用记事本或 VS Code 都行：
notepad $env:USERPROFILE\.openclaw\openclaw.json把agents和models两块改成下面这样。注意baseUrl全部指向 TaoToken，apiKey换成你自己的 Key，模型 ID 按需保留：
{ "agents": { "defaults": { "model": { "primary": "taotoken-gpt/gpt-5.4" }, "maxConcurrent": 4, "subagents": { "maxConcurrent": 8 }, "compaction": { "mode": "safeguard" } } }, "gateway": { "mode": "local", "port": 18789, "bind": "loopback" }, "models": { "providers": { "taotoken-claude": { "baseUrl": "https://taotoken.net/api/anthropic", "apiKey": "你的API密钥", "api": "anthropic-messages", "models": [ { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }, { "id": "claude-opus-4-6", "name": "Claude Opus 4.6" } ] }, "taotoken-gpt": { "baseUrl": "https://taotoken.net/api/openai", "apiKey": "你的API密钥", "api": "openai-responses", "models": [ { "id": "gpt-5.4", "name": "GPT-5.4" }, { "id": "gpt-5.3-codex", "name": "GPT-5.3 Codex" } ] }, "taotoken-gemini": { "baseUrl": "https://taotoken.net/api/openai/v1", "apiKey": "你的API密钥", "api": "openai-completions", "models": [ { "id": "gemini-3-pro-preview", "name": "Gemini 3 Pro" }, { "id": "gemini-3-flash-preview", "name": "Gemini 3 Flash" } ] } } } }三件套对照一下：Base URL 是https://taotoken.net/api加系列后缀，Key 是你在控制台建的那个，Model ID 是provider名/模型id的组合，比如taotoken-gpt/gpt-5.4。如果你原来的配置文件里已经有gateway、skills、wizard这些字段，保留它们，只替换agents和models两块，别整文件覆盖。
改完保存，重启 Gateway 让配置生效：
openclaw gateway restart如果你更习惯图形界面，也可以打开http://127.0.0.1:18789，进 Config → Models → Providers 手动添加，字段和上面 JSON 一一对应。但文件改法更利于版本管理和备份，推荐优先用文件。
4. 发起一次最小请求验证通道是否真的生效
配置改完不代表通了，必须发一次真实请求。最直接的方式是用 Web UI：先启动 dashboard：
openclaw dashboard浏览器会打开http://127.0.0.1:18789/，在聊天窗口里发一句最简单的：
你好，请回复“通道正常”四个字如果几秒内返回了内容，说明 settings 里的 baseUrl、apiKey、model 三件套都对上了。如果没返回，先别急着改配置，用命令行再验证一次，排除是 UI 层的问题：
openclaw status openclaw doctoropenclaw status看 Gateway 是否在跑，openclaw doctor会检查配置项是否合法。想看得更细，跟一下日志：
openclaw logs --follow然后在 UI 里再发一次消息，观察日志里请求发往的地址和返回状态码。正常情况你会看到请求命中taotoken.net，返回 200。这一步很关键，因为日志能直接告诉你请求到底发去了哪里，比猜配置有效得多。
再补一个切换模型的验证：在聊天窗口输入：
/model taotoken-claude/claude-sonnet-4-6再发一句话，确认 Claude 系列也能通。如果 GPT 通而 Claude 不通，多半是api字段写错了，Claude 必须是anthropic-messages，不能写成openai-responses。这个细节在排障一节还会展开。
5. 安装与配置阶段最常见的报错排查
401 Unauthorized：Key 不对或没生效。先确认apiKey字段里没有多余空格，再确认这个 Key 在控制台是启用状态。改完 Key 一定要openclaw gateway restart，否则进程还在用旧配置。
local proxy failed / 连接被拒绝：这类报错通常出现在 baseUrl 写错的情况下。检查是不是把https://taotoken.net/api写成了别的路径，或者系列后缀漏了。Claude 用/anthropic，GPT 用/openai，Gemini 用/openai/v1，三者不能混。
reading choices 相关报错：一般出现在api字段和模型系列不匹配时。GPT 系列用openai-responses，Gemini 系列用openai-completions，Claude 用anthropic-messages。写反了就会在解析响应时报字段缺失。
OAuth 相关提示：如果你在引导里误选了需要 OAuth 的 provider，配置里会残留无效的鉴权块。回到openclaw.json，确认models.providers下只有你手动写的taotoken-*三个 provider，把向导生成的旧 provider 删掉。
端口 18789 被占用：Gateway 起不来时先查端口：
netstat -ano | findstr "18789"有占用就改gateway.port为别的值，比如 18790，然后重启。
找不到配置文件：确认路径是%USERPROFILE%\.openclaw\openclaw.json，注意.openclaw前面有个点。用explorer $env:USERPROFILE\.openclaw直接打开目录确认文件存在。
Node 版本过低：openclaw --version能跑但启动报错，多半是 Node 低于 22。重新用 winget 装 LTS 版本，重开窗口再试。
排查顺序建议固定下来：先openclaw doctor看配置合法性，再openclaw logs --follow看请求实际发往哪里，最后才动配置文件。这样能避免反复改配置却找不到根因。
6. 把通道固定下来之后，OpenClaw 还能怎么用
通道打通只是起点。配置稳定后，你可以把 OpenClaw 接到 Telegram 或 Discord，让它在你不在电脑前时也能执行任务；也可以在models.providers里继续加模型，按任务类型切换。日常编码或跑 Agent 类长任务时，用 Coding Plan 会更省心，入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。想先对话验证模型效果，用模型对话页 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=chat&utm_campaign=rewrite 发几条消息即可。
我自己的习惯是：每次改完openclaw.json先备份一份带日期的副本，再openclaw gateway restart，然后用openclaw logs --follow盯一次真实请求。这样即使改错，回滚也就是复制文件的事。配置文件里agents.defaults.model.primary建议固定一个最常用的模型，切换用/model命令临时改，避免每次都要动文件。
