1. Windows 上养龙虾先把 PowerShell 这关过了OpenClaw 是一个能在本地跑起来、直接操作你电脑的数字员工整理文件、写代码、跑定时任务都能干圈里管部署它叫“养龙虾”。它本身不绑定某一家模型你可以把它理解成一个“调度中枢”真正干活的是背后接的大模型而 OpenClaw 负责把指令翻译成对文件、命令、浏览器的实际操作。问题在于Windows 上第一次部署的人十有八九卡在环境这一层——Node.js 版本不对、npm 全局目录没进 PATH、PowerShell 执行策略拦脚本报错还都是英文看着就头大。这篇是《上》篇只干一件事把 Node.js/npm/PowerShell 环境校验干净再给出一份 OpenClaw 接入 TaoToken 统一 Key/API 通道的 config.toml 与 settings.json 骨架。目标不是让你马上跑通完整对话而是让环境自检和最小配置验证先过。适合第一次在 Windows 上碰 OpenClaw、对 PowerShell 命令不算熟的人。全程命令可直接复制每一步都有验证动作跑完你会得到一份能继续往下接的配置底子。我试过在一台没装过任何开发工具的 Win11 上从零走一遍最容易翻车的不是安装本身而是装完 Node 后没重开终端导致node命令找不到。所以下面每个环节都配了“验证”动作别跳。2. 环境自检Node.js、npm、PowerShell 三件套2.1 用 winget 装 Node.js LTSWindows 10 1809 以后自带 winget直接用它装最省事。以管理员身份打开 PowerShell执行winget install OpenJS.NodeJS.LTS装完必须重开一个新的 PowerShell 窗口因为 PATH 是启动时读取的旧窗口不会刷新。然后验证node --version npm --version正常会看到v22.x.x和10.x.x这样的输出。如果node提示“不是内部或外部命令”八成是没重开窗口或者安装时没勾选加入 PATH重装一遍并确认勾选即可。2.2 校验 npm 全局目录是否在 PATHOpenClaw 是全局安装的npm 的全局 bin 目录必须在 PATH 里否则装完openclaw命令照样找不到。先查目录npm config get prefix假设输出是C:\Users\你的用户名\AppData\Roaming\npm检查它是否在 PATH$env:Path -split ; | Select-String npm没有输出就手动加永久生效[Environment]::SetEnvironmentVariable( Path, $env:Path ;C:\Users\你的用户名\AppData\Roaming\npm, User )加完同样要重开窗口。这一步很多人忽略结果npm install -g成功、openclaw --version却报找不到命令。2.3 PowerShell 执行策略OpenClaw 后续会跑脚本默认策略可能直接拦下来。先看当前策略Get-ExecutionPolicy如果是Restricted临时放开只对当前窗口生效最安全Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process想一劳永逸就永久改需要管理员窗口Set-ExecutionPolicy RemoteSigned注意永久修改会放宽脚本运行限制。如果你平时不跑来源不明的脚本问题不大只是临时用一次优先用-Scope Process那个。2.4 可选npm 镜像加速国内直连 npm 官方源偶尔慢可以换镜像npm config set registry https://registry.npmmirror.com验证npm config get registry输出镜像地址即生效。这一步纯加速不影响功能网络正常也可以跳过。3. TaoToken 前置拿到统一 Key 和 API 通道OpenClaw 支持自定义 Provider也就是说你可以把模型请求指向任意兼容 OpenAI 格式的接口。TaoToken 在这里扮演的角色就是“统一 Key/API 通道”一个 Key、一个 Base URL后面换模型只改 Model ID不用来回折腾各家 SDK 和鉴权。先去官网注册并进控制台在 API Keys 页面创建一个 Key复制保存。这个 Key 就是后面 config.toml 里要填的凭证。Base URL 用https://taotoken.net/api注意不要带任何多余路径后缀OpenClaw 会自己拼接/v1/chat/completions这类端点。需要提前确认两件事一是你的 Key 有可用额度二是你打算用哪个 Model ID。Model ID 填错是后面最常见的报错来源建议先在模型对话页面确认一下目标模型能正常出结果再写进配置。这样排障时就能把“模型本身不可用”和“OpenClaw 配置错”两件事分开。相关入口我放在这里按需取用模型对话用来验证模型可用性API Keys 用来管理凭证接入文档用来核对参数格式。4. 可复制配置config.toml 与 settings.json 骨架OpenClaw 的配置分两层config.toml管网关和 Providersettings.json管运行时行为。下面给的是最小骨架先跑通再扩展。4.1 config.toml 骨架工作目录建议放非系统盘比如D:\openclaw\workspace。配置文件一般位于%USERPROFILE%\.openclaw\config.toml没有就手动建[gateway] host 127.0.0.1 port 18789 auth_mode token [provider.taotoken] type openai-compatible base_url https://taotoken.net/api api_key 你的_TaoToken_Key model 你的_Model_ID [agent] workspace D:\\openclaw\\workspace tool_executor local几个关键点type必须是openai-compatible这是 OpenClaw 识别接口格式的依据base_url不要带/v1让它自己拼api_key直接填明文本地自用够用介意的话后续可以换成环境变量引用。4.2 settings.json 骨架同目录下建settings.json控制运行时行为{ gateway: { bind: loopback, log_level: info }, provider: { default: taotoken }, tools: { enabled: [file, shell], confirm_dangerous: true } }bind设成loopback表示只允许本机访问安全优先confirm_dangerous打开后危险操作会先问你避免它自作主张删文件。这两个骨架先照抄跑通后再按需加技能和钩子。5. 验证请求从环境自检到最小配置跑通配置写完别急着开聊先做三层验证一层层排除问题。第一层环境自检node --version npm --version Get-ExecutionPolicy三个都有正常输出说明基础环境没问题。第二层配置语法校验。OpenClaw 一般带校验命令openclaw config validate如果提示 TOML 解析错误多半是引号或反斜杠转义问题。Windows 路径在 TOML 里要用双反斜杠\\或者改用正斜杠/两种都行。第三层最小请求验证。启动网关openclaw gateway窗口保持打开另开一个 PowerShell 发一条测试请求curl.exe -X POST http://127.0.0.1:18789/v1/chat/completions -H Content-Type: application/json -H Authorization: Bearer 你的网关Token -d {\model\:\你的_Model_ID\,\messages\:[{\role\:\user\,\content\:\你好\}]}注意 Windows 上要用curl.exe而不是curl后者在 PowerShell 里是Invoke-WebRequest的别名参数格式不一样。返回里出现正常的choices结构说明从 OpenClaw 到 TaoToken 再到模型的整条链路通了。这一步过了后面接 Web 界面、加技能都是顺水推舟。6. 本篇常见错排查node不是内部或外部命令没重开终端或安装时没勾选加入 PATH。重开窗口还不行就重装并确认勾选。openclaw找不到命令npm 全局 bin 目录没进 PATH回到 2.2 节处理。无法加载文件因为在此系统上禁止运行脚本执行策略没放开回到 2.3 节。EADDRINUSE端口被占用查占用进程再结束netstat -ano | findstr :18789 taskkill /PID 进程ID /FModel not foundModel ID 写错或该模型在你的 Key 下不可用。先去模型对话页面确认。Authentication failedKey 无效或过期去 API Keys 页面重新生成注意别把 Key 前后的空格复制进去。Insufficient quota额度用尽检查账户余额或换模型。TOML 解析报错路径反斜杠没转义改成\\或/。排障时优先看网关窗口的日志log_level设成debug能看到完整请求体定位问题快很多。接入参数细节可以对照接入文档核对凭证问题去 API Keys 页面处理。7. 下一步把骨架接上真实对话环境自检和最小配置验证跑通后你已经有了一个能继续扩展的底子。接下来要做的是把网关 Token 配好、登录 Web 界面发第一条真实消息确认 OpenClaw 能正常调用你配置的模型。如果你打算长期跑编码类任务或接 Agent 流程可以了解下 Coding Plan它在长会话和工具调用场景下更省心只是先验证模型通不通模型对话页面就够用。《下》篇会在这个骨架上继续加东西把工作目录、技能、钩子按需补全再处理后台常驻和日志轮转。现在先把这篇的验证动作走完环境干净了后面每一步都省事。