1. Windows 装 openclaw 到底卡在哪从 npm 到 onboard 的真实报错现场openclaw 是一个把 AI 能力工程化封装的命令行工具你可以把它理解成一辆车——发动机是各家大模型而 openclaw 负责方向盘、油门和仪表盘。它适合愿意把工作拆成步骤、习惯在终端里推进任务的人尤其是需要长期跑编码、Agent 流程的开发者。但很多人第一次在 Windows 上装它卡住的地方根本不是模型而是 PowerShell 的执行策略、npm 源、git 依赖和 onboard 初始化这几道坎。我见过太多人打开 PowerShell 敲下npm install -g openclawlatest结果第一行就红字报错无法加载文件 ... 因为在此系统上禁止运行脚本。这不是 openclaw 的问题是 Windows 默认的Restricted执行策略把 npm 生成的.ps1启动脚本拦住了。紧接着还有 npm 源太慢导致安装超时、git 没装导致依赖拉取失败、openclaw onboard跑一半卡在模型配置环节。这篇就按真实排障顺序把每一步的可复制命令和配置骨架给你最后用 TaoToken 统一 Key 通道把模型接入串起来一次跑通。2. 装 openclaw 前先把 TaoToken 通道准备好openclaw 本身不生产 token它只是个调度壳。你 onboard 时要填模型提供方的 API Key 和 Base URL如果每个工具都单独去申请、单独配 Key后面换模型、加工具会非常乱。我自己的做法是先用 TaoToken 把统一通道建好openclaw、Claude Code、其他编码工具都走同一个入口Key 管理和额度查看都在一个地方。TaoToken 在这里的角色是统一 Key 与 API 通道你拿到一个 Key配一个 Base URL就能在多个 AI 工具里复用。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 这条不带 UTM 参数配置时直接填这个。具体动作分两步。第一步进控制台创建 API Key地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 创建后复制那串sk-开头的 Key先存到记事本。第二步如果你后面要跑长期编码或 Agent 任务建议直接看 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它比按量计费更适合高频调用场景。Key 的详细管理说明在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到字段不确定就翻这两个页面。注意Key 只在创建时完整显示一次关掉页面就看不到了务必先复制保存。不要把它写进会提交到 git 的配置文件里。3. 可复制配置PowerShell 策略、npm 源与 openclaw 安装这一节是全文的核心操作区按顺序执行别跳步。前置条件是电脑已经装了 git没装的话先去 git 官网下 Windows 版装上装完在 PowerShell 里敲git --version能出版本号才算过。3.1 解除执行策略限制Windows 默认禁止运行脚本npm 全局包的启动脚本会被拦。用下面这条把当前用户的策略改成RemoteSigned它只影响你自己不需要管理员权限Set-ExecutionPolicy RemoteSigned -Scope CurrentUser执行后会问你确认输入Y回车。验证一下Get-ExecutionPolicy -Scope CurrentUser输出RemoteSigned就对了。这一步解决的就是那个禁止运行脚本的经典报错。3.2 切换 npm 源并安装 openclaw默认 npm 源在国内拉包经常超时先永久切到国内镜像npm config set registry https://registry.npmmirror.com npm config get registry第二条命令应该回显https://registry.npmmirror.com/。然后安装npm install -g openclawlatest装完验证openclaw --version能输出版本号说明二进制已经进 PATH。如果提示openclaw 不是内部或外部命令多半是 npm 全局目录没进环境变量用npm config get prefix看路径把它加到系统 PATH 里再重开终端。3.3 openclaw 配置文件骨架openclaw 的配置一般放在用户目录下的配置文件夹里onboard 会引导生成但你可以先手动建一个骨架把 TaoToken 通道填进去。下面是一个settings.json示例字段名以你实际版本为准核心是baseUrl和apiKey两处{ provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: claude-sonnet, timeout: 60000, retry: { maxAttempts: 3, backoffMs: 1000 } }provider填openai-compatible是因为 TaoToken 走的是兼容 OpenAI 协议的接口openclaw 这类工具基本都支持自定义 Base URL。model按你实际要用的模型名填不确定就先去模型对话页试一下地址是 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 在网页里选模型发一句话能正常回再写进配置。3.4 启动 onboard 初始化配置骨架放好后跑初始化向导openclaw onboard向导会依次问 provider、Base URL、API Key、默认模型。Base URL 填https://taotoken.net/apiKey 填你复制的那个。如果 onboard 中途卡住或报fetch failed先别急着重装往下看第 5 节的排查。4. 验证请求确认 openclaw 真的连上了模型装完不代表通了必须发一次真实请求验证。openclaw 一般有 gateway 模式先起服务openclaw gateway start另开一个 PowerShell 窗口发一条测试请求。如果你用的是兼容 OpenAI 的接口可以直接用 curl 验证通道本身通不通curl https://taotoken.net/api/v1/chat/completions -H Authorization: Bearer sk-你的TaoToken密钥 -H Content-Type: application/json -d {\model\:\claude-sonnet\,\messages\:[{\role\:\user\,\content\:\回复ok\}]}返回 JSON 里choices数组有内容说明 Key 和 Base URL 都没问题。然后再回到 openclaw 里跑一个最小任务比如让它读一个本地文件并总结。成功的结果是终端里能看到流式输出gateway 日志没有 401 或 429。401 是 Key 错429 是额度或频率问题这两个错误码要分清。如果你更想先在网页端确认模型可用性用模型对话页发一条同样的测试消息地址还是 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 网页能通、命令行不通问题就锁定在本地配置而不是通道。5. 本篇常见错排查openclaw onboard 失败与权限拦截把踩过的坑按现象列出来对着查。报错一无法加载文件因为在此系统上禁止运行脚本。原因就是执行策略没改。回到 3.1 那条Set-ExecutionPolicy RemoteSigned -Scope CurrentUser改完重开终端。如果公司电脑有组策略锁死-Scope CurrentUser也改不动那就换用npm的.cmd入口或者找 IT 放开。报错二npm install卡住或ETIMEDOUT。源没切成功。重新执行npm config set registry https://registry.npmmirror.com然后npm cache clean --force清缓存再装。如果公司网络有代理npm 的代理配置和系统代理不一致也会超时用npm config get proxy检查。报错三openclaw onboard跑到模型配置就失败。九成是 Base URL 或 Key 填错。Base URL 必须是https://taotoken.net/api不要多加/v1也不要少斜杠具体以接入文档为准https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。Key 注意前后不要有空格复制时容易带上换行。报错四git相关依赖拉取失败。openclaw 某些插件依赖 git 克隆仓库没装 git 或 git 不在 PATH 就会报git: command not found。装完 git 后重开终端git --version验证。报错五gateway 起来了但请求 401。Key 失效或额度用尽。去控制台看 Key 状态和余额地址 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 必要时重新生成 Key 并更新settings.json。报错六模型名不识别。model字段填了通道不支持的名称。先去模型对话页确认可用模型列表再回填配置。6. 长期跑编码和 Agent通道怎么选如果你只是偶尔用 openclaw 问几个问题按量计费的 Key 就够了。但如果你打算让它长期跑编码任务、挂 Agent 流程调用频率会很高这时候按量计费的成本和额度管理都会变得麻烦。我自己的做法是这类高频场景直接上 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它更适合持续调用的工作流。另外提一句 Claude Code 这类工具如果你同时也在用它的接入配置和 openclaw 可以共用同一个 TaoToken Key入口在 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentClaudeCodeAnthropicutm_campaignrewrite 配一次通道多个工具复用省得每个都单独折腾。装 openclaw 这件事本身不难难的是把执行策略、源、git、onboard、模型通道这几环一次对齐。按上面的顺序走一遍把settings.json骨架填好用 curl 验证通道再回 openclaw 跑最小任务基本就能稳定用起来。真正决定它有没有价值的还是你有没有持续的任务要交给它——工具装上了场景得自己长出来。