1. Windows 上跑 OpenClaw卡住的多半不是安装本身OpenClaw 是一个把大模型能力接到本地工作流的开源网关型工具装好之后你能在浏览器控制面板里对话、挂载 Skills、跑自动化任务适合想在 Windows 上自建 AI 助手的开发者。但 2026 年在 Windows 端从零部署 OpenClaw真正让人卡住的往往不是npm install那一步而是三件事PowerShell 执行策略拦脚本、npm 全局目录没进 PATH、网关起来了但控制面板连不上。我见过太多人在这三个坑里反复重装最后误以为是 OpenClaw 本身有问题。这篇按「环境准备 → npm 全局安装 → 初始化向导 → 网关配置 → 连通性验证 → 排障」的顺序走一遍命令全部可以直接复制到 PowerShell 里执行。模型通道部分我会用 TaoToken 的统一 Key 接入这样你不需要在多个平台之间来回切换 API Key一个通道就能覆盖 Claude、GPT、GLM 等常用模型配置骨架也会一并给出。先说清楚适用人群如果你只是想体验一下对话网页版就够了但如果你需要本地网关、需要把模型接进自己的脚本或 Agent 流程、需要统一管理 Key那 OpenClaw 这套架构值得花半小时搭起来。下面开始。2. 装之前先把 TaoToken 通道准备好OpenClaw 本身只是「壳」它需要一个大模型 API 才能干活。传统做法是去各家平台分别注册、分别拿 Key、分别配 base_url模型一多配置就乱。TaoToken 的思路是提供一个统一的 API 通道你只拿一个 Key通过改模型名就能切换后端模型对 OpenClaw 这种需要在 config 里写模型配置的工具来说省事很多。具体操作打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册账号然后进控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 创建 API Key。Key 形如sk-开头的一串字符创建后只显示一次建议立刻复制到记事本暂存。拿到 Key 之后OpenClaw 里要填的两个核心参数是参数值说明base_urlhttps://taotoken.net/api统一 API 入口不加任何 UTM 参数api_key你创建的sk-xxx控制台可随时吊销重建model如claude-sonnet-4-5/gpt-4.1/glm-4.6按需切换无需换 Key注意base_url 一定用https://taotoken.net/api这个裸地址不要在后面拼/v1之类的路径OpenClaw 的 provider 配置会自己补全。这一点和某些直连 SDK 的习惯不同写错了会报 404。如果你后面打算长期跑编码类 Agent 任务可以顺带看一下 Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它针对高频调用场景做了额度优化比按量计费更适合天天挂着跑的用户。这一步不是必须的先把基础通道跑通再说。3. 环境准备PowerShell 策略、Node 与 npm 镜像3.1 放开 PowerShell 执行策略Windows 默认禁止运行未签名脚本OpenClaw 的安装脚本和部分构建脚本会被拦。以管理员身份打开 PowerShell执行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass第一条让当前用户可以运行本地脚本第二条只对当前这个 PowerShell 会话生效适合临时安装。装完之后如果你在意安全可以把 CurrentUser 那条改回Restricted但那样每次跑脚本都要重新放开自己权衡。3.2 安装 Node.js 与 GitOpenClaw 要求 Node.js 20 以上建议直接装 LTS 版。去 nodejs.org 下载 msi 安装包安装时勾选「Add to PATH」。Git 同理装完记得勾选「Git from the command line」。装完新开一个 PowerShell 窗口验证node --version npm --version git --version三条都能输出版本号才算过。如果node提示不是内部命令八成是 PATH 没刷新关掉窗口重开一次。3.3 配置 npm 镜像与 Git 拉取方式国内直连 npm 官方源经常超时换成镜像npm config set registry https://registry.npmmirror.comGit 这边把 SSH 拉取统一改成 HTTPS避免没配 SSH Key 时 clone 失败git config --global url.https://github.com/.insteadOf ssh://gitgithub.com/如果你之前配过 Git 代理导致拉取异常可以清掉git config --global --unset https.proxy4. npm 全局安装 OpenClaw 与初始化向导4.1 全局安装环境就绪后一条命令装本体npm install -g openclaw装完验证openclaw --version能打印版本号就说明全局 bin 目录已经进 PATH。如果提示openclaw不是内部命令执行npm config get prefix看输出路径把那个路径手动加进系统环境变量 PATH然后重开终端。4.2 跑初始化向导openclaw onboard向导会依次问你几件事按下面选第一风险提示页用方向键选Yes回车继续。第二初始化模式选QuickStart。第三配置 AI 模型 API Key 时这里就是接入 TaoToken 的入口——把第 2 节拿到的sk-xxx填进去base_url 填https://taotoken.net/api模型名按你要用的填比如claude-sonnet-4-5。第四通讯平台问你要连哪个先选skip for now本地跑通再说。第五Skills 选NoHooks 选skip for now这两个后面随时能加首次部署越简单越好。向导跑完OpenClaw 的配置文件就落在用户目录下了Windows 上一般在C:\Users\你的用户名\.openclaw\下面。5. 可复制的 config.toml 与 settings.json 骨架向导生成的配置可能不完整尤其是模型通道部分。下面给一份可以直接改的骨架路径在C:\Users\你的用户名\.openclaw\config.toml[gateway] port 18789 host 127.0.0.1 [gateway.auth] token 换成你自己的token [provider.taotoken] type openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 [model.default] provider taotoken name claude-sonnet-4-5对应的settings.json同目录控制界面与运行时行为{ ui: { theme: dark, language: zh-CN }, runtime: { defaultModel: claude-sonnet-4-5, provider: taotoken, timeoutMs: 60000 }, gateway: { autoStart: true, dashboardPort: 18789 } }注意type写openai-compatible是因为 TaoToken 的/api入口兼容 OpenAI 风格的请求格式OpenClaw 会按这个协议发请求。模型名换成gpt-4.1或glm-4.6都能直接用不用改 base_url 和 Key。改完配置后重启网关让配置生效openclaw gateway restart6. 网关安装、启动与连通性验证6.1 安装并启动网关openclaw gateway install openclaw gateway startinstall是把网关注册成后台服务start是立刻拉起来。启动后拿控制面板链接openclaw dashboard --no-open输出类似Dashboard URL: http://127.0.0.1:18789/#tokenxxxxxxxxxxxxx把这个完整链接复制到浏览器打开就能进控制面板。注意一定要带#token那一段直接访问http://127.0.0.1:18789会因为缺 token 被拒。6.2 验证模型通道是否真的通了进面板后新建一个对话随便问一句「你好报一下你当前的模型名」。如果返回正常说明 TaoToken 通道打通了。如果报 401是 Key 错了或没生效报 404多半是 base_url 写成了带/v1的地址报超时检查本机网络能不能访问taotoken.net。命令行侧也可以直接验证网关状态openclaw gateway status返回running且端口是 18789 就对了。想快速试模型对话也可以直接用模型对话页面 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 发一条消息确认 Key 本身没问题这样能把「Key 问题」和「OpenClaw 配置问题」分开定位。7. 本篇常见报错排查7.1 提示「禁止运行脚本」这是 PowerShell 执行策略没放开回到 3.1 节那两条命令重跑一遍。注意要用管理员身份开 PowerShell普通窗口改不了 CurrentUser 策略。7.2 npm 装到一半卡死或超时先确认镜像源生效npm config get registry应该输出https://registry.npmmirror.com。如果还是慢清一下缓存重来npm cache clean --force npm install -g openclaw7.3 控制面板打不开或提示连不上网关按顺序查三件事openclaw gateway status是不是 running浏览器地址是不是带了#tokenconfig.toml 里的gateway.auth.token和 dashboard 输出的 token 是不是同一个。三者对不上就会连不上。7.4 构建时报 bash 或 WSL 相关错误Windows 上如果系统优先调用了 WSL 的 bash.exe而你没装 Linux 发行版就会报这个错。解决办法是确保 Git Bash 的路径优先级高于 WindowsApps检查系统环境变量 Path 里这两条靠前C:\Program Files\Git\bin C:\Program Files\Git\cmd调整后重开终端再构建。7.5 模型返回 401 / 403基本是 Key 的问题。去控制台 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 确认 Key 状态是否正常、有没有被吊销然后重新复制一次填进 config.toml。Key 前后不要带空格这是最常见的低级错误。8. 后续接入与文档入口基础跑通之后下一步通常是接通讯平台、加 Skills、或者把 OpenClaw 接进自己的编码流程。这几块配置项比较多建议直接对着官方接入文档改比盲试快得多https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。文档里有各语言 SDK 的调用示例和参数说明OpenClaw 的 provider 配置也能在里面找到对应字段的解释。如果你主要用途是长期跑编码类 Agent比如让 OpenClaw 挂着自动改代码、跑测试那 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 的额度模型会比按量计费划算配置方式不变只是 Key 的计费策略不同。Claude Code 相关的接入细节可以看 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-code-anthropicutm_campaignrewrite 里面讲了 Anthropic 协议下的特殊参数。最后提醒一句首次部署别急着开 Skills 和 Hooks先把「网关 模型通道 控制面板」这条最小链路跑通确认对话正常返回再往上叠功能。这样出问题时排查范围小不会一上来就被一堆配置项淹没。
