Windows 安装部署 OpenClaw：用 PowerShell 配好 Node.js 与 Git 后把 Base URL 改到 TaoToken

1. Windows 上第一次跑 OpenClaw为什么总卡在 PowerShell 和 Node.jsOpenClaw 是一个可以在本地跑起来的 AI 智能体框架能接大模型、跑工具调用、开 Web UI适合想在 Windows 上折腾本地 Agent 的开发者。但很多人第一次装的时候卡点根本不在 OpenClaw 本身而是在前置环境PowerShell 执行策略没放开、Node.js 版本不对、Git 没装导致依赖拉不下来。我见过太多人iwr | iex一敲就报红字然后以为是 OpenClaw 的问题其实是环境没准备好。这篇就按真实部署顺序走一遍先用 PowerShell 把 Node.js 和 Git 装好并校验再装 OpenClaw最后把 Base URL 改到 TaoToken用一次最小请求验证整条链路通不通。全程命令可以直接复制路径和参数都按 Windows 默认环境写。先说清楚适合谁如果你在 Windows 10/11 上想用 OpenClaw 接一个 OpenAI 兼容的大模型接口又不想在环境配置上反复试错这篇就是给你写的。核心检索词就三个Windows 安装 OpenClaw、PowerShell 配 Node.js、OpenClaw 改 Base URL。下面每一步我都会给出「命令 预期结果」你照着比对就行。在开始之前先确认你的 PowerShell 是 5.1 还是 7.x。Win10/11 自带的 Windows PowerShell 是 5.1够用如果你装了 PowerShell 7 更好命令基本兼容。打开方式按Win X选「Windows PowerShell」或「终端」。后面所有命令都在这个窗口里跑。2. 前置环境准备PowerShell 执行策略、Node.js 与 Git 安装校验2.1 放开 PowerShell 执行策略Windows 默认禁止运行脚本OpenClaw 的安装脚本是.ps1不放开会直接报「无法加载文件因为在此系统上禁止运行脚本」。执行下面这条作用域选当前用户不需要管理员权限Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser回车后会问你是否确认输入Y再回车。RemoteSigned的意思是本地写的脚本可以直接跑从网上下载的脚本需要有签名。这是比较平衡的安全策略比Unrestricted稳妥。验证一下Get-ExecutionPolicy -Scope CurrentUser预期输出RemoteSigned。如果还是Restricted说明你改的是别的作用域重跑上面那条命令。2.2 安装 Node.jsOpenClaw 依赖 Node.js建议用 LTS 版本18 或 20 都行。有两种装法我推荐用 winget省得手动下安装包winget install OpenJS.NodeJS.LTS如果 winget 不可用老版本系统就去 Node.js 官网下 LTS 的.msi安装包一路下一步即可。装完后必须重开一个 PowerShell 窗口否则 PATH 不生效。校验node -v npm -v预期输出类似v20.11.1和10.2.4。如果提示「不是内部或外部命令」八成是没重开窗口或者安装时没勾选「Add to PATH」。2.3 安装 GitOpenClaw 初始化时可能要拉取依赖或模板Git 是刚需winget install Git.Git同样装完重开窗口然后校验git --version预期输出git version 2.43.0.windows.1这类。如果git命令找不到手动把C:\Program Files\Git\cmd加到系统环境变量 PATH 里再重开窗口。到这里三件套PowerShell 策略、Node.js、Git就齐了。你可以用一条命令一次性确认Write-Host Node: $(node -v); Write-Host npm: $(npm -v); Write-Host Git: $(git --version)三个都有版本号输出才继续往下走。3. 安装 OpenClaw 并配置 Base URL 到 TaoToken3.1 用官方脚本安装 OpenClaw环境 OK 后安装本身很快iwr -useb https://openclaw.ai/install.ps1 | iex这条命令下载安装脚本并直接执行。跑完后OpenClaw 会被装到用户目录下命令行里应该能识别openclaw命令。校验openclaw --version有版本号输出就说明装好了。3.2 初始化并进入配置向导直接运行openclaw第一次运行会进入 onboarding 向导。第一步会问你I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?这是说默认个人使用多人共用需要额外限制。选Yes继续。接着Onboarding mode选QuickStart快速起步。3.3 把 Model/auth provider 指向 TaoToken关键一步来了。向导会问Model/auth provider因为 TaoToken 不在 OpenClaw 内置的厂商列表里所以选Custom Provider。然后会依次问你三个东西这就是所谓的「三件套」缺一不可API Base URL填 TaoToken 的接口地址https://taotoken.net/apiAPI Key在 TaoToken 控制台创建见下方链接Model ID填你要用的模型名比如claude-sonnet-4-5或你在控制台看到的模型标识How do you want to provide this API key?选Paste API key now然后把 Key 粘进去。Endpoint compatibility选OpenAI-compatible因为 TaoToken 走的是 OpenAI 兼容协议。Search provider直接Skip for now。最后How do you want to hatch your bot?选Open the Web UI。如果你更想手动写配置文件OpenClaw 的配置一般落在用户目录下的配置文件中Windows 通常是%USERPROFILE%\.openclaw\下的 JSON。对应的片段长这样路径和字段名按你实际安装版本为准{ provider: custom, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: claude-sonnet-4-5, endpointCompatibility: openai }注意baseUrl结尾不要多加/v1OpenClaw 会按 OpenAI 兼容规则自己拼路径。如果你填成https://taotoken.net/api/v1很可能出现 404 或路径重复。创建 Key 和查文档的入口API Keys 管理https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapikeys接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc3.4 环境变量方式可选如果你不想把 Key 写进配置文件也可以用环境变量。在 PowerShell 里临时设置$env:TAOTOKEN_API_KEYsk-你的TaoToken密钥 $env:TAOTOKEN_BASE_URLhttps://taotoken.net/api想永久生效就写进用户环境变量[Environment]::SetEnvironmentVariable(TAOTOKEN_API_KEY,sk-你的TaoToken密钥,User) [Environment]::SetEnvironmentVariable(TAOTOKEN_BASE_URL,https://taotoken.net/api,User)设完重开窗口。OpenClaw 启动时会优先读环境变量这样配置文件里就不用放明文 Key。4. 验证请求用一次最小调用确认安装成功配置完别急着开 Web UI先用一次最小请求确认链路通。最直接的方式是让 OpenClaw 跑一个最简单的对话。在 PowerShell 里openclaw run 用一句话介绍你自己如果配置正确你会看到模型返回的一句话。这一步能同时验证三件事Node.js 运行时正常、OpenClaw 加载配置正常、TaoToken 的 Base URL 和 Key 能通。如果你想更底层地验证接口本身可以绕过 OpenClaw直接用 PowerShell 打一次 HTTP 请求$headers { Authorization Bearer sk-你的TaoToken密钥 Content-Type application/json } $body { model claude-sonnet-4-5 messages ({ role user; content ping }) } | ConvertTo-Json -Depth 5 Invoke-RestMethod -Uri https://taotoken.net/api/chat/completions -Method Post -Headers $headers -Body $body预期返回一个 JSON里面有choices字段和模型回复内容。这一步通了说明 Base URL、Key、Model ID 三件套全对。如果这一步就报错问题一定在配置不在 OpenClaw。验证成功后再启动 Web UIopenclaw选Open the Web UI浏览器会自动打开本地地址你就能在图形界面里对话了。5. 本篇常见报错排查401、local proxy failed、reading choices、OAuth部署过程中最容易撞上的几个报错我按真实报错信息列出来对照处理。401 Unauthorized / invalid api keyKey 错了、过期了或者复制时带了空格。去 TaoToken 控制台重新创建一个 Key粘贴时注意别把首尾空格带进去。另外确认Authorization头是Bearer sk-xxx格式少个Bearer也会 401。local proxy failed / connection refused这种一般是 Base URL 写错或者网络到不了。先确认baseUrl是https://taotoken.net/api没有多余斜杠或/v1。再用上面的Invoke-RestMethod单独测一次接口能通就说明是 OpenClaw 配置里 URL 写错了。Error reading choices / choices is undefined返回体里没有choices字段通常是 Model ID 填错了或者端点兼容性没选OpenAI-compatible。回配置里检查model字段确认模型名和控制台里一致。有些模型名带版本号少一段就匹配不上。OAuth / authentication flow 相关报错如果你在向导里误选了需要 OAuth 的 provider会卡在授权跳转。回到配置把 provider 改成Custom Provider用 API Key 方式不要走 OAuth。OpenClaw 的 OAuth 流程主要给内置厂商用自定义 provider 用不上。Set-ExecutionPolicy 报「拒绝访问」说明你没加-Scope CurrentUser或者当前窗口不是用户权限。加上作用域参数重跑不需要管理员。node 不是内部或外部命令装完 Node.js 没重开 PowerShell 窗口。关掉所有终端重新开一个再试。还不行就检查 PATH 里有没有 Node.js 的安装目录。排查顺序建议先单独测接口Invoke-RestMethod再测 OpenClawopenclaw run最后开 Web UI。哪一层报错就修哪一层别一上来就重装。6. 接下来怎么用模型对话、Coding Plan 与文档入口环境通了之后日常使用其实就三件事验证模型、长期编码、查文档。想快速试不同模型的效果直接用模型对话页面最省事不用改本地配置https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmodelchat如果你打算把 OpenClaw 当长期编码助手或 Agent 底座用Coding Plan 更适合额度和调用方式都按持续使用设计https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcodingplan配置过程中遇到字段不确定的直接翻接入文档Base URL、鉴权头、请求体格式都写得很清楚https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdocKey 管理和新建入口再放一次方便你回头找https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapikeys最后给个实用建议把openclaw run ping这条命令存成一个快捷脚本每次改完配置先跑一次比开 Web UI 快得多。配置文件的备份也留一份改坏了直接还原比重装省时间。