1. Windows 原生跑 OpenClaw 到底卡在哪如果你在 Windows 上搜 OpenClaw 的部署教程大概率会看到两种结局一种是让你装 WSL 再折腾一遍 Linux 环境另一种是照着步骤走完openclaw gateway run一敲终端刷出一行model not found或者401然后就没有然后了。这篇要解决的就是这件事不装 WSL、不碰 Docker纯 Windows 原生 PowerShell Node.js把 OpenClaw 跑起来并且让它稳定对接 DeepSeek-V4。同时把 API Key 的配置方式统一到 TaoToken 上避免你一会儿 DeepSeek 官方 Key、一会儿别家 Key配置目录里塞了三四份密钥自己都记不清哪个是哪个。先说清楚 OpenClaw 是什么。它是一个基于 Node.js 的本地 AI 网关跑起来之后会在本机开一个 Web 面板默认http://localhost:18789你可以把它理解成一个「AI 调度台」左边接各种模型提供商右边接聊天、定时任务、代理这些功能模块。它本身不产生智能智能来自你接进去的模型。所以部署 OpenClaw 的核心工作量其实不在装软件而在「把模型接对」。适合谁看手上有 Windows 10 21H2 以上或 Windows 11 的笔记本/台式机内存 8GB 以上想用 DeepSeek-V4 做日常问答或代码辅助但不想为了一个工具去学 Linux 命令的人。整篇的节奏是先备好 Key再装环境然后写配置最后用 PowerShell 验证连通性中间穿插我实际踩过的报错。DeepSeek-V4 在 OpenClaw 里是通过 OpenAI 兼容协议接入的也就是说 OpenClaw 把它当成一个「自定义 OpenAI 接口」来调用。这一点很关键后面配置文件里所有字段都是围绕这个协议来的。而 TaoToken 在这里的角色是给你一个统一的 Key 和统一的 Base URL让你不用在多个平台之间来回切换密钥。2. 前置准备TaoToken 统一 Key 与 Windows 环境2.1 为什么用 TaoToken 统一 Key直接拿 DeepSeek 官方 Key 也能跑通但有个现实问题你后面可能还会接别的模型或者换模型测试。每换一次就要回配置文件改apiKey和baseURL改多了容易漏。TaoToken 提供的是 OpenAI 兼容的统一入口一个 Key 对应多个模型Base URL 固定切换模型只需要改model字段。TaoToken 的 API 地址是https://taotoken.net/api注意这个地址不带任何查询参数配置时直接填这个。官网在https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册和查看文档都在这里。拿 Key 的路径进官网后进控制台找到 API Keys 页面新建一个 Key。这个 Key 就是后面配置文件里ANTHROPIC_AUTH_TOKEN要填的值。建议新建后立刻复制存到记事本页面刷新后有些平台不再完整显示。注意TaoToken 的 Key 和 DeepSeek 官方 Key 不是一回事不要混用。如果你之前配过 DeepSeek 官方 Key先把配置文件里的旧值清掉避免两个 Key 打架导致 401。2.2 Windows 环境三件套OpenClaw 依赖 Node.js 运行依赖 Git 拉取部分依赖包依赖 PowerShell 执行脚本。三样都要装顺序无所谓但 PowerShell 执行权限必须放开否则npm install -g那一步就会报「无法加载文件因为在此系统上禁止运行脚本」。Node.js 选 22.x LTS 版本去官网下.msi安装包安装时勾选「Add to PATH」。装完开一个新的 PowerShell 窗口不要用装之前就开着的旧窗口环境变量不会刷新执行node -v npm -v正常输出应该是v22.x.x和10.x.x以上。如果node命令找不到说明 PATH 没生效重启一次 PowerShell 或者注销重登。Git 去 Git for Windows 官网下安装包同样勾选「Add Git to PATH」。装完验证git --version然后放开 PowerShell 执行权限。这一步要用管理员身份打开 PowerShell右键开始菜单选「终端(管理员)」或「Windows PowerShell(管理员)」执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force这条命令只对当前用户生效不会影响系统其他账户相对安全。执行完不会有明显提示直接进入下一步即可。2.3 安装 OpenClaw保持管理员 PowerShell先配国内 npm 镜像加速再全局安装npm config set registry https://registry.npmmirror.com npm install -g openclawlatest安装过程大概一到三分钟取决于网络。装完验证openclaw --version能打印出版本号就说明 CLI 装好了。如果这一步报openclaw 不是内部或外部命令八成是 npm 全局路径没进 PATH执行npm config get prefix看下路径手动加进系统环境变量。3. 可复制配置config.toml 骨架与 Key 片段3.1 配置文件在哪OpenClaw 的用户级配置目录在%USERPROFILE%\.openclaw。在文件资源管理器地址栏直接粘贴这个路径回车就能进去。目录里通常有settings.json或config.toml取决于版本。新版更推荐用config.toml结构清晰注释友好。如果目录不存在先跑一次openclaw onboard让它生成初始文件然后再改。不要手动新建空文件字段缺失会导致启动时报一堆默认值错误。3.2 config.toml 骨架下面这份骨架是我实测能跑通 DeepSeek-V4 的最小配置你可以直接复制把api_key换成你自己的 TaoToken Key# OpenClaw 主配置 [gateway] mode local port 18789 [model] provider custom-openai model deepseek-v4 base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 timeout_ms 300000 [model.params] temperature 0.7 max_tokens 4096 [logging] level info几个字段解释一下。provider填custom-openai因为 DeepSeek-V4 走的是 OpenAI 兼容协议。base_url填 TaoToken 的 API 地址注意结尾不要多加/v1OpenClaw 内部会自己拼路径多写了会变成/v1/v1/chat/completions直接 404。model字段填deepseek-v4这是 TaoToken 侧的模型标识不要写成deepseek-v4-pro或带前缀的形式模型名对不上会报model not found。timeout_ms给到 300000 是 5 分钟DeepSeek-V4 在长上下文场景下响应会慢一些超时设短了容易在生成到一半时断掉。3.3 如果你用的是 settings.json 版本部分旧版 OpenClaw 读的是settings.json结构是嵌套 JSON。等价配置如下{ gateway: { mode: local, port: 18789 }, env: { OPENAI_BASE_URL: https://taotoken.net/api, OPENAI_API_KEY: sk-你的TaoToken密钥, OPENAI_MODEL: deepseek-v4, API_TIMEOUT_MS: 300000 }, model: deepseek-v4 }注意 JSON 版本里环境变量名是OPENAI_前缀不是ANTHROPIC_。如果你从别的教程抄了ANTHROPIC_BASE_URL那套在 TaoToken 的 OpenAI 兼容入口下是不生效的会一直报认证失败。这一点是新手最容易踩的坑两个前缀对应两套协议别混。改完文件保存关掉记事本。如果之前启动过 OpenClaw先停掉再改配置否则改完不生效openclaw gateway stop4. PowerShell 验证请求与成功结果4.1 启动网关配置写好后在 PowerShell 里前台启动方便看实时日志openclaw gateway run --allow-unconfigured--allow-unconfigured这个参数是给首次启动用的跳过一些交互式检查。启动成功的标志是终端打印出监听端口和模型加载信息类似[gateway] listening on http://localhost:18789 [model] loaded providercustom-openai modeldeepseek-v4如果看到model not found回去检查model字段拼写。如果看到401 Unauthorized检查api_key是不是复制完整了有没有多余空格。4.2 用 PowerShell 直接打接口验证不想开浏览器的话可以直接在 PowerShell 里用Invoke-RestMethod打一次对话接口这是最快的连通性验证方式$headers { Authorization Bearer sk-你的TaoToken密钥 Content-Type application/json } $body { model deepseek-v4 messages ( { role user; content 用一句话说明你是什么模型 } ) max_tokens 100 } | ConvertTo-Json -Depth 5 Invoke-RestMethod -Uri https://taotoken.net/api/chat/completions -Method Post -Headers $headers -Body $body如果返回里choices[0].message.content有内容说明 Key、Base URL、模型名三者全部正确。这一步过了OpenClaw 里基本不会再有认证类问题。4.3 在 Web 面板里验证浏览器打开http://localhost:18789进左侧「聊天」页面发一条测试消息。能收到回复就说明整条链路通了。面板里还能看到 token 消耗统计方便你估算成本。如果面板打不开先确认openclaw gateway run那个窗口还开着关掉窗口服务就停了。长期使用建议用后台模式openclaw gateway install openclaw gateway startinstall会把它注册成 Windows 计划任务start启动后台服务关掉终端也不影响。5. 本篇常见报错排查5.1 401 认证失败最常见。三个检查点Key 是否复制完整有没有漏掉尾部字符、Authorization头是不是Bearer开头加空格、Base URL 是不是https://taotoken.net/api而不是别的。如果之前配过 DeepSeek 官方 Key确认配置文件里没有残留旧值。5.2 model not found模型名写错。TaoToken 侧的模型标识是deepseek-v4不要加-pro、-flash后缀也不要加deepseek/前缀。改完配置记得openclaw gateway restart。5.3 404 Not FoundBase URL 多写了/v1。OpenClaw 内部会拼/chat/completions你写https://taotoken.net/api/v1就变成/api/v1/chat/completions路径不对。改成https://taotoken.net/api即可。5.4 PowerShell 脚本被禁止运行npm install -g时报「禁止运行脚本」。回到 2.2 节用管理员 PowerShell 执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force。如果公司电脑有组策略限制这条命令可能被拦那就只能找 IT 放开没有别的绕法。5.5 启动后端口被占用18789被别的程序占了。改config.toml里的port字段换一个比如18790然后重启网关。改完记得浏览器地址也跟着换。5.6 响应中途断开超时设太短。把timeout_ms调到300000以上。DeepSeek-V4 在长文本生成时首 token 延迟可能到十几秒超时设 30 秒很容易断。6. 后续怎么用从验证到日常跑通之后日常使用就是openclaw gateway start启动后台服务浏览器开面板用。要换模型的时候只改config.toml里的model字段Key 和 Base URL 不用动这就是统一 Key 的好处。如果你打算长期用 OpenClaw 做编码辅助或者跑定时任务建议看一下 TaoToken 的 Coding Plan它针对高频调用场景有更合适的额度方案地址在https://taotoken.net/api对应的控制台里能找到入口。模型对话的调试可以直接在面板里做接入文档在官网的 doc 页面API Keys 管理在 console 的 api-keys 页面。最后留一个实用习惯每次改完配置先跑一遍 4.2 节那段 PowerShell 验证脚本确认接口通了再启动网关。这样能把「配置错误」和「网关错误」分开定位省掉一半排查时间。
