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_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteAPI 的基础地址是https://taotoken.net/api注意这个地址不带任何查询参数直接写进配置即可。不同模型系列对应的路径后缀不一样Claude 系列走/anthropicGPT 系列走/openaiGemini 系列走/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全部指向 TaoTokenapiKey换成你自己的 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先启动 dashboardopenclaw 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 UnauthorizedKey 不对或没生效。先确认apiKey字段里没有多余空格再确认这个 Key 在控制台是启用状态。改完 Key 一定要openclaw gateway restart否则进程还在用旧配置。local proxy failed / 连接被拒绝这类报错通常出现在 baseUrl 写错的情况下。检查是不是把https://taotoken.net/api写成了别的路径或者系列后缀漏了。Claude 用/anthropicGPT 用/openaiGemini 用/openai/v1三者不能混。reading choices 相关报错一般出现在api字段和模型系列不匹配时。GPT 系列用openai-responsesGemini 系列用openai-completionsClaude 用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_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。想先对话验证模型效果用模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 发几条消息即可。我自己的习惯是每次改完openclaw.json先备份一份带日期的副本再openclaw gateway restart然后用openclaw logs --follow盯一次真实请求。这样即使改错回滚也就是复制文件的事。配置文件里agents.defaults.model.primary建议固定一个最常用的模型切换用/model命令临时改避免每次都要动文件。 
长河君 · 2026/10/10 2:07:53 · 阅读 1.2k OpenClaw Windows 安装指南：把 settings 改到 TaoToken 的完整配置流程
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_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteAPI 的基础地址是https://taotoken.net/api注意这个地址不带任何查询参数直接写进配置即可。不同模型系列对应的路径后缀不一样Claude 系列走/anthropicGPT 系列走/openaiGemini 系列走/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全部指向 TaoTokenapiKey换成你自己的 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先启动 dashboardopenclaw 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 UnauthorizedKey 不对或没生效。先确认apiKey字段里没有多余空格再确认这个 Key 在控制台是启用状态。改完 Key 一定要openclaw gateway restart否则进程还在用旧配置。local proxy failed / 连接被拒绝这类报错通常出现在 baseUrl 写错的情况下。检查是不是把https://taotoken.net/api写成了别的路径或者系列后缀漏了。Claude 用/anthropicGPT 用/openaiGemini 用/openai/v1三者不能混。reading choices 相关报错一般出现在api字段和模型系列不匹配时。GPT 系列用openai-responsesGemini 系列用openai-completionsClaude 用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_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。想先对话验证模型效果用模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 发几条消息即可。我自己的习惯是每次改完openclaw.json先备份一份带日期的副本再openclaw gateway restart然后用openclaw logs --follow盯一次真实请求。这样即使改错回滚也就是复制文件的事。配置文件里agents.defaults.model.primary建议固定一个最常用的模型切换用/model命令临时改避免每次都要动文件。