1. Windows 下 OpenClaw 本地安装到底卡在哪Node.js、Git 与 PowerShell 环境全流程OpenClaw 是一个可以在本地跑起来的 AI 网关与 Agent 运行环境它把模型调用、工具执行、会话管理这些能力收拢到一个本地服务里再通过 Web 控制台或命令行去驱动。适合谁适合想在 Windows 上自己搭一套可控 AI 工作流的人比如你希望本地保存会话、自己决定模型通道、又不想每次都手动拼请求。它的安装脚本本身不复杂真正让人卡住的往往是前置环境Node.js 版本不够、Git 没装导致 PowerShell 窗口一闪而过、执行策略拦住了脚本、装完之后网关起不来或者控制台报 unauthorized。这篇就按 Windows 11 的实际操作顺序把 Node.js、Git、PowerShell 检查、依赖安装以及用 TaoToken 统一 Key 接入的 config.toml 配置骨架一次讲清楚最后给出可复制的连通性测试动作。我试过在一台干净的 Win11 上从零走一遍最容易忽略的是 Node 版本。OpenClaw 要求 Node ≥ v22如果你机器上是 v18 或者更早安装脚本可能跑到一半就报语法错误看起来像是脚本坏了其实是运行时太旧。另一个高频坑是 Git安装过程里需要拉取依赖或镜像没有 Git 时 PowerShell 窗口会直接闪退你连报错都看不到。所以顺序应该是先验环境再装本体最后配通道。下面所有命令都在 PowerShell 里执行。建议用管理员身份打开开始菜单搜 PowerShell右键选择“以管理员身份运行”。普通窗口也能装但涉及计划任务和全局命令时管理员更省事。先做三件事看 Node 版本、看 Git 版本、看当前执行策略。这三条命令输出正常后面基本就顺了。node -v git --version Get-ExecutionPolicy -Scope Processnode -v期望看到v22.x.x或更高git --version期望看到git version 2.x执行策略如果是Restricted脚本会被拦需要临时放开。注意这里用-Scope Process只影响当前窗口关掉就恢复比改全局策略安全。如果你已经装了 Node 但版本低去 Node 官网下 LTS 或 Current 的 22 安装包覆盖安装即可装完重开一个 PowerShell 窗口再验一次因为环境变量刷新需要新进程。Git 的安装没什么特别官网下载 Windows 版一路默认即可唯一建议是在“Adjusting your PATH environment”那一步选默认的 “Git from the command line and also from 3rd-party software”这样 PowerShell 里能直接调用 git。装完同样要重开窗口。很多人装完不重开然后git --version报找不到命令以为装失败了其实只是当前会话没刷新 PATH。环境确认后先放开当前进程的执行权限Set-ExecutionPolicy Bypass -Scope Process -Force这条不是必须但能避免安装脚本被策略挡住。做完这三步前置环境就算齐了接下来才是 OpenClaw 本体安装和 TaoToken 通道配置。整篇的重点会放在配置骨架和排障上因为安装脚本本身是一行命令的事真正决定你能不能长期用的是通道配置对不对。2. TaoToken 前置准备统一 Key 与 API 通道在 OpenClaw 里的定位在装 OpenClaw 之前先把模型通道这件事想清楚否则装完你会卡在“选哪个提供商、Key 填哪里”。OpenClaw 支持多种模型来源配置方式是在本地配置文件里声明 provider、base URL、API Key 和默认模型。TaoToken 在这里的角色是一个统一的 API 通道你拿到一个 Key配一个 Base URL就能在 OpenClaw 里调用多种模型不用为每个模型单独维护一套密钥和地址。对本地部署来说这能明显减少配置文件里的重复项。你需要提前准备两样东西一个可用的 API Key以及对应的 Base URL。TaoToken 的 API 地址是https://taotoken.net/api注意这个地址在配置文件里作为 base URL 使用不要额外拼多余的路径。Key 的获取入口在控制台的 API Keys 页面登录后创建即可。这里提醒一句API Key 是有额度的超出会产生费用免费额度适合先跑通流程别一上来就拿它压测大量请求避免扣费超出心理预期。先小流量验证连通再逐步加量。为什么要在 OpenClaw 里用统一通道而不是逐个配原生提供商因为本地部署的配置文件是你要长期维护的东西。每多一个 provider就多一段 base URL、Key、模型名映射改起来容易漏。统一通道的好处是Base URL 固定、Key 固定切换模型只改 Model ID 这一项。对刚上手的人这降低了配置出错的面。你可以把它理解成“一个入口多个模型出口”。在 OpenClaw 的配置体系里通常涉及这几个字段provider 名称、base_url、api_key、以及默认模型标识。不同版本的字段命名可能略有差异但结构一致。下面给的是一个通用骨架实际以你安装版本的文档为准。配置文件的常见位置在用户目录下的.openclaw文件夹里文件名多为config.toml。如果你不确定路径装完后用openclaw config path之类的命令查一下或者直接看安装日志里提示的配置目录。这里要强调一个顺序问题先拿到 Key再装 OpenClaw安装脚本在交互环节会让你选提供商并填 Key。如果你提前准备好了安装过程会顺很多如果没准备中途退出再重来也可以但体验会断。所以建议在跑安装脚本前把 Key 复制到剪贴板或记事本里备用。Key 属于敏感信息别贴到公开的聊天记录或截图里配置文件也不要提交到 Git 仓库。关于模型选择OpenClaw 里通常需要指定一个 Model ID。这个 ID 要和通道支持的模型名对应写错了会在请求时报模型不存在。建议先用一个你确定可用的模型跑通再换其他模型。TaoToken 的模型对话页面可以帮你确认当前可用的模型标识验证阶段用它对照一下更稳妥。准备好 Key 和 Base URL 之后就可以进入安装和配置环节了。3. 可复制配置OpenClaw 安装命令与 config.toml 接入骨架这一节是整篇最需要你动手照做的地方。先装 OpenClaw再写配置文件最后启动服务。安装用官方脚本一行命令iwr -useb https://openclaw.ai/install.ps1 | iex如果这条拉取慢或失败可以用国内镜像脚本iwr -useb https://clawd.org.cn/install.ps1 | iex执行后会进入交互流程脚本会问你选择模型提供商和填 API Key。这里你可以先选一个占位选项把安装跑完因为真正的通道配置我们会在config.toml里统一改。安装过程中如果 PowerShell 窗口闪退八成是 Git 没装好回到第 1 节确认git --version能正常输出。安装完成后验证版本openclaw --version期望输出类似0.1.8-fix.3这样的版本号。如果提示openclaw不是可识别的命令说明安装目录没进 PATH重开一个 PowerShell 窗口再试还不行就检查安装日志里的 bin 目录手动加进 PATH。接下来是配置文件。先确认配置目录一般在C:\Users\你的用户名\.openclaw\下文件名为config.toml。如果文件不存在就新建一个。下面是一个接入 TaoToken 统一通道的骨架字段结构清晰你可以直接复制后替换 Key# OpenClaw 本地配置骨架 # 配置文件路径C:\Users\你的用户名\.openclaw\config.toml [gateway] mode local port 18789 [provider.taotoken] type openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 default_model 你的模型ID [agent] default_provider taotoken几个关键点说明。type用openai-compatible是因为 TaoToken 的 API 走的是兼容 OpenAI 的请求格式这样 OpenClaw 能直接用现成的适配器。base_url固定为https://taotoken.net/api不要在后面加/v1之类的后缀除非文档明确要求多加路径会导致 404。api_key填你在控制台创建的 Key注意别把引号漏了。default_model填你要用的模型标识这个要和通道支持的模型名一致写错会在请求时报模型不存在。default_provider指向taotoken这样 Agent 默认走这个通道。如果你更习惯用 JSON 结构部分版本支持等价写法如下字段名保持一致{ gateway: { mode: local, port: 18789 }, provider: { taotoken: { type: openai-compatible, base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, default_model: 你的模型ID } }, agent: { default_provider: taotoken } }配置写完后设置网关为本地模式并启动服务openclaw config set gateway.mode local openclaw gateway install openclaw gateway start openclaw gateway statusgateway install会把服务注册成 Windows 计划任务实现开机自启gateway start立即启动gateway status应显示Running。如果状态不是 Running先看日志常见原因是端口 18789 被占用或者配置文件语法错误导致启动失败。TOML 对引号和括号比较敏感少一个引号就会解析失败改完配置后建议先跑一次openclaw config validate如果你的版本支持再启动。这里再强调一次三件套的完整性Base URL、Key、Model ID 缺一不可。Base URL 决定请求发到哪Key 决定能不能通过鉴权Model ID 决定调用哪个模型。三者任何一个写错表现都不一样Base URL 错通常是连接失败或 404Key 错是 401Model ID 错是模型不存在。记住这个对应关系排障时能快速定位。4. 验证请求与成功结果从命令行到 Web 控制台的连通性测试配置写完、服务起来之后别急着用先做连通性验证。第一步看服务状态openclaw gateway status输出里应该能看到Running和监听端口18789。如果显示Stopped或Failed先解决启动问题别往下走。第二步打开 Web 控制台浏览器访问http://127.0.0.1:18789正常情况下会看到控制台界面。如果你看到的是disconnected (1008): unauthorized: gateway token missing说明控制台需要带 token 的链接才能连上这是安全机制不是配置错误。解决办法是运行openclaw dashboard这条命令会生成一个带 token 的 URL 并自动打开浏览器用这个链接访问就正常了。如果你还看到event gap detected (expected seq 400, got 404); refresh recommended这通常是页面状态和网关不同步刷新页面或重新用 dashboard 链接打开即可。第三步做一次真实的模型请求验证。最直接的方式是在控制台里发一条测试消息比如“你好请回复一句话”。如果通道配置正确你会看到模型返回内容。如果控制台不方便也可以用命令行触发一次请求具体命令随版本不同常见的是openclaw chat或openclaw run之类的子命令你可以用openclaw --help查看当前版本支持哪些。请求成功时返回里会包含模型输出的文本并且没有报错字段。验证阶段要观察三个信号。第一请求有没有发出去如果连请求都没发出说明 provider 配置没被加载检查default_provider是否指向了taotoken。第二鉴权有没有过如果返回 401检查 Key 是否正确、有没有多余空格、有没有过期。第三模型有没有命中如果返回模型不存在检查default_model的拼写去模型对话页面核对可用标识。这三个信号对应三层问题逐层排查效率最高。成功的结果长什么样控制台里能看到对话正常往返命令行请求返回带内容的响应gateway status保持 Running日志里没有反复重连的记录。到这一步本地部署和 TaoToken 接入就算跑通了。接下来你可以把默认模型换成其他可用模型只改default_model一项即可Base URL 和 Key 不用动这就是统一通道的便利之处。如果你打算长期用建议把这次验证用的请求量控制在小范围先确认稳定再逐步加量。API Key 有额度限制超出会计费验证阶段用几条消息足够不要拿它跑批量任务。等确认通道稳定、模型可用之后再根据实际需求调整使用强度。5. 本篇常见报错排查401、local proxy failed、reading choices 与 OAuth 对照装和配的过程中报错基本集中在几类。下面按真实错误信息对照排查你可以直接搜关键词定位。第一类401 unauthorized。这是鉴权失败最常见的原因是 Key 写错或过期。检查config.toml里api_key的值确认没有多余空格、没有漏掉引号、没有把 Key 截断。如果你是从网页复制的注意别把前后空白也复制进去。还有一种情况是 Key 本身有效但额度用尽这时也可能返回鉴权类错误去控制台确认 Key 状态和余额。改完配置后要重启网关openclaw gateway restart否则旧配置还在内存里。第二类local proxy failed或连接被拒绝。这通常表示 OpenClaw 尝试请求 Base URL 时连不上。先确认base_url写的是https://taotoken.net/api没有多余路径、没有拼错域名。再确认本机网络能正常访问外网 HTTPS可以用curl https://taotoken.net/api之类的命令测一下连通性返回什么不重要能建立连接就说明网络通。如果公司网络有出口限制可能需要换网络环境再试。注意不要使用任何非正规的网络访问方式保持直连即可。第三类reading choices相关报错比如解析响应时读不到choices字段。这说明请求发出去了、也返回了但返回结构不符合预期。常见原因是type配错了比如把兼容 OpenAI 的通道配成了别的类型导致解析器按错误的格式去读。确认type openai-compatible。另一个原因是 Base URL 多加了/v1之类的后缀请求打到了错误的路由返回了非预期内容。把base_url改回https://taotoken.net/api再试。第四类OAuth 相关报错。如果你在配置里误开了需要 OAuth 的 provider或者安装时选了需要浏览器授权的选项可能会卡在授权环节。本地部署用 API Key 通道时不需要 OAuth检查配置里有没有多余的 auth 字段删掉后重启。如果你确实需要 OAuth 类通道按对应文档单独配置不要和 API Key 通道混在一起。第五类gateway token missing和event gap detected。这两个在第 4 节提过不是配置错误是控制台访问方式问题。用openclaw dashboard生成带 token 的链接访问即可。event gap刷新页面通常就好。如果反复出现检查网关是否在稳定运行gateway status是否一直 Running。第六类PowerShell 窗口闪退。这几乎都是 Git 没装或没进 PATH 导致的。回到第 1 节确认git --version能输出重开窗口再跑安装脚本。如果 Git 装了还是闪退检查是不是执行策略拦住了脚本先跑Set-ExecutionPolicy Bypass -Scope Process -Force。第七类端口占用。gateway start失败日志提示端口 18789 被占用。用netstat -ano | findstr 18789找到占用进程要么结束它要么在配置里改port换一个。改端口后记得同步更新你访问控制台的地址。排查的核心思路是分层先看服务起没起再看请求发没发出去再看鉴权过没过最后看模型命中没命中。每一层对应不同的配置项按这个顺序走基本不会绕远路。改完任何配置都要重启网关这一步别省。6. 接入完成后的下一步用统一通道跑通你的第一个本地 Agent 任务服务跑通、连通性验证通过之后你可以开始用 OpenClaw 做实际的事了。第一步建议是跑一个最简单的本地任务确认整条链路在真实使用下也稳定。比如在控制台里让它执行一个多轮对话或者触发一个带工具调用的流程观察请求是否正常往返、会话是否被本地保存。这一步的目的是把“能连上”变成“能干活”。如果你要长期用建议把配置固定下来Base URL 用https://taotoken.net/apiKey 用你创建的那个Model ID 按需切换。这样你以后换模型只改一行不用动其他配置。对于需要长期编码或跑 Agent 的场景可以关注 Coding Plan 这类方案它更适合持续性的调用需求如果只是偶尔验证模型效果用模型对话页面确认可用模型就够了。接入过程中遇到配置问题接入文档里有字段说明对照着改比盲试快。还有一个实用技巧把config.toml备份一份改坏了能快速回滚。TOML 语法对格式敏感手改容易出错备份能省很多时间。另外Key 不要写进任何会公开的文件配置文件本身也别提交到代码仓库。本地部署的好处就是数据和控制权都在你手里前提是敏感信息管理到位。最后回到安装本身。整个流程的关键节点其实就三个Node ≥ v22、Git 可用、配置文件三件套Base URL、Key、Model ID写对。这三个对了剩下的都是顺水推舟。装完之后先用小流量验证确认稳定再逐步加量避免额度超出预期。到这一步你的 Windows 本地 OpenClaw 就已经接入了统一通道可以开始按自己的需求去用了。