1. Windows 部署 OpenClaw 到底卡在哪OpenClaw 是一个可以在本地跑起来的 AI 网关与对话面板装好之后你能在浏览器里直接和模型聊天也能把它当成统一的 API 入口把请求转发到不同的模型服务上。它适合两类人一类是想在 Windows 本机快速体验多模型对话的开发者另一类是手里有多个模型 Key、想用一个统一通道管理请求的人。整个部署链路其实就四件事Node.js 运行时、npm 包管理、Git 版本工具以及 OpenClaw 本体加配置。真正让人卡住的从来不是「装不上」而是装到一半冒出来的一堆报错。我实测下来Windows 上部署 OpenClaw 最常见的三个坑分别是Git 走 SSH 协议拉包时权限校验失败、npm 安装过程中 SSL 证书验证不通过、以及默认源访问超时。这三个问题会连着出现一个没解决下一个就跟着来很多人就是在这一步放弃的。这篇内容按「从零到跑通」的顺序走一遍先把 Node.js、npm、Git 三个基础环境装好并校验版本再装 OpenClaw然后处理上面那三类报错最后给出配置文件骨架、启动命令和连通性验证步骤。跑通之后我会把模型通道接到 TaoToken 的统一 API 上这样你本地这套 OpenClaw 就能用一个 Key 访问多个模型不用来回切换配置。需要提前说明的是下面所有命令都在 Windows 自带的 CMD 里执行不需要额外装终端工具。如果你用的是 PowerShell大部分命令一样能用但个别路径写法要注意引号。整个过程大概 15 到 20 分钟取决于你的网络情况。2. 装 OpenClaw 之前先把 Node.js、npm、Git 配好2.1 Node.js 安装与版本校验OpenClaw 依赖 Node.js 运行建议用 22.x 的 LTS 版本兼容性最稳。去 Node.js 官网下载 Windows 的 msi 安装包双击一路下一步即可安装时记得勾选「Add to PATH」这样 CMD 里才能直接调用 node 和 npm。装完之后一定要校验别跳过这步。打开一个新的 CMD 窗口注意是新的旧窗口读不到刚写入的环境变量执行node --version npm --version正常会输出类似v22.13.1和10.9.2这样的版本号。如果提示「不是内部或外部命令」说明 PATH 没生效关掉 CMD 重开一次还不行就重启电脑。npm 是随 Node.js 一起装的不需要单独安装这点很多人会搞混。2.2 Git 安装与关键配置Git 在 OpenClaw 安装过程中会被 npm 用来拉取依赖所以必须先装。去 Git 官网下载 Windows 版安装包安装选项保持默认即可其中「Adjusting your PATH environment」选默认的「Git from the command line and also from 3rd-party software」。装完校验git --version输出git version 2.47.x之类就对了。接下来是重点npm 拉包时默认可能走 SSH 协议而 SSH 需要配置密钥没配就会报权限错误。我们直接强制它走 HTTPS执行下面这条全局配置git config --global url.https://github.com/.insteadOf ssh://gitgithub.com/这条命令的意思是以后凡是遇到ssh://gitgithub.com/开头的地址自动替换成https://github.com/。这样就不需要 SSH 密钥了能省掉一大半的权限报错。注意这条配置是全局的会影响你机器上所有 Git 操作。如果你本身有在用 SSH 密钥管理私有仓库执行前先确认不会冲突。2.3 环境变量与镜像源准备国内网络环境下npm 默认源访问经常超时。提前把源换成国内镜像能避免后面安装到一半卡死npm config set registry https://registry.npmmirror.com设置完可以查一下确认npm config get registry输出https://registry.npmmirror.com就说明生效了。这一步做完基础环境就算齐了接下来装 OpenClaw 会顺畅很多。3. 安装 OpenClaw 并处理三类典型报错3.1 标准安装命令基础环境就绪后用全局安装的方式装 OpenClawnpm install -g openclaw如果一切顺利几十秒到几分钟就能装完。但 Windows 上大概率会遇到下面几种报错我按出现顺序逐个说。3.2 报错一Git SSH 权限问题如果你在第 2.2 步已经配了 HTTPS 替换这个错基本不会出现。但如果之前没配会看到类似Permission denied (publickey)的提示。补上那条git config --global url.https://github.com/.insteadOf ...配置即可。3.3 报错二SSL 证书验证失败有时候会报unable to verify the first certificate或SELF_SIGNED_CERT_IN_CHAIN。这通常是本地证书链或代理环境导致的。临时处理方式是关闭 Git 的 SSL 校验git config --global http.sslverify false然后重新安装并加上--unsafe-perm参数避免权限相关的安装脚本被拦截npm install -g openclaw --unsafe-perm注意http.sslverify false会降低安全性仅建议在本地开发环境临时使用。装完之后如果你在意安全可以再执行git config --global http.sslverify true恢复。3.4 报错三网络超时如果报错是ETIMEDOUT或request to https://registry.npmjs.org failed说明源没换成功或者镜像源也不稳定。确认镜像源已设置后用强制重装的方式再试npm config set registry https://registry.npmmirror.com npm install -g openclaw --force--force会强制重新拉取忽略本地缓存。实测下来换源加--force能解决绝大多数超时问题。装完后校验一下openclaw --version能输出版本号说明 OpenClaw 本体已经装好了。4. 配置文件骨架与 Gateway 启动验证4.1 启动 Gateway 服务OpenClaw 的核心是一个本地 Gateway 服务先启动它openclaw gateway这个命令会占用当前 CMD 窗口服务会一直跑着。不要按 CtrlC按了服务就停了。正确做法是保持这个窗口不动另外新开一个 CMD 窗口做后续操作。4.2 设置访问 Token在新开的 CMD 窗口里先确认服务状态openclaw gateway status然后设置一个访问 Token这个 Token 是浏览器访问 Dashboard 时要输入的openclaw config set gateway.auth.token my-token-12345 openclaw gateway restart把my-token-12345换成你自己的字符串记好它等下要用。4.3 浏览器访问与连通性测试打开浏览器访问http://127.0.0.1:18789/在页面里输入刚才设置的 Token就能进入 OpenClaw Dashboard。到这里本地服务已经跑通了你可以在 Dashboard 里看到对话界面。4.4 配置文件骨架参考OpenClaw 的配置集中在用户目录下的配置文件中核心结构大致如下你可以对照检查自己的配置是否完整{ gateway: { auth: { token: my-token-12345 }, port: 18789 }, model: { provider: taotoken, baseUrl: https://taotoken.net/api, apiKey: 你的TaoToken密钥, defaultModel: kimi-k2.5 } }其中baseUrl指向 TaoToken 的统一 API 地址apiKey填你在 TaoToken 控制台创建的密钥。这样配置之后OpenClaw 的所有模型请求都会走 TaoToken 通道一个 Key 就能切换多个模型。5. 本篇常见报错排查清单部署过程中报错信息五花八门我把高频问题整理成一张对照表方便你按现象定位报错现象可能原因处理方式Permission denied (publickey)Git 走 SSH 协议无密钥配置 HTTPS 替换见 2.2unable to verify the first certificateSSL 证书链校验失败临时关闭http.sslverifyETIMEDOUT/registry.npmjs.org failed默认源访问超时换国内镜像源加--forceopenclaw 不是内部或外部命令全局安装路径未进 PATH重开 CMD或检查 npm 全局路径Dashboard 打不开Gateway 未启动或端口占用确认gateway status检查 18789 端口提示找不到模型 API Key模型通道未配置在配置里补apiKey与baseUrl关于模型 Key 的配置如果你用的是 Moonshot 的 Kimi需要在对应平台创建 API Key然后在 OpenClaw 的配置向导里选择对应的模型提供商填入 Key。但更省事的方式是直接接 TaoToken 的统一通道这样不用为每个模型单独申请和配置 Key。配置模型通道时如果你更习惯用命令行交互式配置可以执行openclaw configure按提示选择本地运行、选择模型提供商、填入 API Key 即可。配置完成后重启 Gatewayopenclaw gateway restart回到 Dashboard 测试对话能正常返回内容就说明整条链路通了。6. 把 OpenClaw 接到 TaoToken 统一 API 通道本地 OpenClaw 跑通之后最后一步是让它接入一个稳定的模型通道。前面配置里出现的baseUrl就是干这个的。TaoToken 提供统一的 API 入口你只需要在控制台创建一个密钥然后把它填到 OpenClaw 的配置里就能用一个 Key 访问多个模型省去为每个模型单独配置的麻烦。具体操作路径是这样先到 TaoToken 控制台创建 API Key地址是 https://taotoken.net/api-keys 创建后复制密钥。然后回到 OpenClaw 配置把baseUrl设为https://taotoken.net/apiapiKey填刚复制的密钥。配置保存后重启 Gateway在 Dashboard 里发一条消息测试能正常返回就说明通道接好了。如果你在配置过程中遇到接入报错或者想确认请求参数怎么写可以对照接入文档排查https://taotoken.net/doc 。文档里有完整的请求示例和参数说明比对着改配置效率高很多。对于需要长期跑编码任务或者 Agent 场景的用户可以考虑用 Coding Plan它更适合高频、持续的调用需求配置方式和普通 API 一致只是计费和额度策略不同具体可以在 https://taotoken.net/coding-plan 查看。配置完成后建议做一次完整的连通性验证在 Dashboard 里发一条测试消息观察是否正常返回如果报错先检查baseUrl和apiKey是否填对再确认 Gateway 是否已重启。这套流程走下来你本地就有一个能统一调度多模型的 OpenClaw 环境了。
Windows 部署 OpenClaw 实战：Node.js、npm 与 Git 环境配置全流程
1. Windows 部署 OpenClaw 到底卡在哪OpenClaw 是一个可以在本地跑起来的 AI 网关与对话面板装好之后你能在浏览器里直接和模型聊天也能把它当成统一的 API 入口把请求转发到不同的模型服务上。它适合两类人一类是想在 Windows 本机快速体验多模型对话的开发者另一类是手里有多个模型 Key、想用一个统一通道管理请求的人。整个部署链路其实就四件事Node.js 运行时、npm 包管理、Git 版本工具以及 OpenClaw 本体加配置。真正让人卡住的从来不是「装不上」而是装到一半冒出来的一堆报错。我实测下来Windows 上部署 OpenClaw 最常见的三个坑分别是Git 走 SSH 协议拉包时权限校验失败、npm 安装过程中 SSL 证书验证不通过、以及默认源访问超时。这三个问题会连着出现一个没解决下一个就跟着来很多人就是在这一步放弃的。这篇内容按「从零到跑通」的顺序走一遍先把 Node.js、npm、Git 三个基础环境装好并校验版本再装 OpenClaw然后处理上面那三类报错最后给出配置文件骨架、启动命令和连通性验证步骤。跑通之后我会把模型通道接到 TaoToken 的统一 API 上这样你本地这套 OpenClaw 就能用一个 Key 访问多个模型不用来回切换配置。需要提前说明的是下面所有命令都在 Windows 自带的 CMD 里执行不需要额外装终端工具。如果你用的是 PowerShell大部分命令一样能用但个别路径写法要注意引号。整个过程大概 15 到 20 分钟取决于你的网络情况。2. 装 OpenClaw 之前先把 Node.js、npm、Git 配好2.1 Node.js 安装与版本校验OpenClaw 依赖 Node.js 运行建议用 22.x 的 LTS 版本兼容性最稳。去 Node.js 官网下载 Windows 的 msi 安装包双击一路下一步即可安装时记得勾选「Add to PATH」这样 CMD 里才能直接调用 node 和 npm。装完之后一定要校验别跳过这步。打开一个新的 CMD 窗口注意是新的旧窗口读不到刚写入的环境变量执行node --version npm --version正常会输出类似v22.13.1和10.9.2这样的版本号。如果提示「不是内部或外部命令」说明 PATH 没生效关掉 CMD 重开一次还不行就重启电脑。npm 是随 Node.js 一起装的不需要单独安装这点很多人会搞混。2.2 Git 安装与关键配置Git 在 OpenClaw 安装过程中会被 npm 用来拉取依赖所以必须先装。去 Git 官网下载 Windows 版安装包安装选项保持默认即可其中「Adjusting your PATH environment」选默认的「Git from the command line and also from 3rd-party software」。装完校验git --version输出git version 2.47.x之类就对了。接下来是重点npm 拉包时默认可能走 SSH 协议而 SSH 需要配置密钥没配就会报权限错误。我们直接强制它走 HTTPS执行下面这条全局配置git config --global url.https://github.com/.insteadOf ssh://gitgithub.com/这条命令的意思是以后凡是遇到ssh://gitgithub.com/开头的地址自动替换成https://github.com/。这样就不需要 SSH 密钥了能省掉一大半的权限报错。注意这条配置是全局的会影响你机器上所有 Git 操作。如果你本身有在用 SSH 密钥管理私有仓库执行前先确认不会冲突。2.3 环境变量与镜像源准备国内网络环境下npm 默认源访问经常超时。提前把源换成国内镜像能避免后面安装到一半卡死npm config set registry https://registry.npmmirror.com设置完可以查一下确认npm config get registry输出https://registry.npmmirror.com就说明生效了。这一步做完基础环境就算齐了接下来装 OpenClaw 会顺畅很多。3. 安装 OpenClaw 并处理三类典型报错3.1 标准安装命令基础环境就绪后用全局安装的方式装 OpenClawnpm install -g openclaw如果一切顺利几十秒到几分钟就能装完。但 Windows 上大概率会遇到下面几种报错我按出现顺序逐个说。3.2 报错一Git SSH 权限问题如果你在第 2.2 步已经配了 HTTPS 替换这个错基本不会出现。但如果之前没配会看到类似Permission denied (publickey)的提示。补上那条git config --global url.https://github.com/.insteadOf ...配置即可。3.3 报错二SSL 证书验证失败有时候会报unable to verify the first certificate或SELF_SIGNED_CERT_IN_CHAIN。这通常是本地证书链或代理环境导致的。临时处理方式是关闭 Git 的 SSL 校验git config --global http.sslverify false然后重新安装并加上--unsafe-perm参数避免权限相关的安装脚本被拦截npm install -g openclaw --unsafe-perm注意http.sslverify false会降低安全性仅建议在本地开发环境临时使用。装完之后如果你在意安全可以再执行git config --global http.sslverify true恢复。3.4 报错三网络超时如果报错是ETIMEDOUT或request to https://registry.npmjs.org failed说明源没换成功或者镜像源也不稳定。确认镜像源已设置后用强制重装的方式再试npm config set registry https://registry.npmmirror.com npm install -g openclaw --force--force会强制重新拉取忽略本地缓存。实测下来换源加--force能解决绝大多数超时问题。装完后校验一下openclaw --version能输出版本号说明 OpenClaw 本体已经装好了。4. 配置文件骨架与 Gateway 启动验证4.1 启动 Gateway 服务OpenClaw 的核心是一个本地 Gateway 服务先启动它openclaw gateway这个命令会占用当前 CMD 窗口服务会一直跑着。不要按 CtrlC按了服务就停了。正确做法是保持这个窗口不动另外新开一个 CMD 窗口做后续操作。4.2 设置访问 Token在新开的 CMD 窗口里先确认服务状态openclaw gateway status然后设置一个访问 Token这个 Token 是浏览器访问 Dashboard 时要输入的openclaw config set gateway.auth.token my-token-12345 openclaw gateway restart把my-token-12345换成你自己的字符串记好它等下要用。4.3 浏览器访问与连通性测试打开浏览器访问http://127.0.0.1:18789/在页面里输入刚才设置的 Token就能进入 OpenClaw Dashboard。到这里本地服务已经跑通了你可以在 Dashboard 里看到对话界面。4.4 配置文件骨架参考OpenClaw 的配置集中在用户目录下的配置文件中核心结构大致如下你可以对照检查自己的配置是否完整{ gateway: { auth: { token: my-token-12345 }, port: 18789 }, model: { provider: taotoken, baseUrl: https://taotoken.net/api, apiKey: 你的TaoToken密钥, defaultModel: kimi-k2.5 } }其中baseUrl指向 TaoToken 的统一 API 地址apiKey填你在 TaoToken 控制台创建的密钥。这样配置之后OpenClaw 的所有模型请求都会走 TaoToken 通道一个 Key 就能切换多个模型。5. 本篇常见报错排查清单部署过程中报错信息五花八门我把高频问题整理成一张对照表方便你按现象定位报错现象可能原因处理方式Permission denied (publickey)Git 走 SSH 协议无密钥配置 HTTPS 替换见 2.2unable to verify the first certificateSSL 证书链校验失败临时关闭http.sslverifyETIMEDOUT/registry.npmjs.org failed默认源访问超时换国内镜像源加--forceopenclaw 不是内部或外部命令全局安装路径未进 PATH重开 CMD或检查 npm 全局路径Dashboard 打不开Gateway 未启动或端口占用确认gateway status检查 18789 端口提示找不到模型 API Key模型通道未配置在配置里补apiKey与baseUrl关于模型 Key 的配置如果你用的是 Moonshot 的 Kimi需要在对应平台创建 API Key然后在 OpenClaw 的配置向导里选择对应的模型提供商填入 Key。但更省事的方式是直接接 TaoToken 的统一通道这样不用为每个模型单独申请和配置 Key。配置模型通道时如果你更习惯用命令行交互式配置可以执行openclaw configure按提示选择本地运行、选择模型提供商、填入 API Key 即可。配置完成后重启 Gatewayopenclaw gateway restart回到 Dashboard 测试对话能正常返回内容就说明整条链路通了。6. 把 OpenClaw 接到 TaoToken 统一 API 通道本地 OpenClaw 跑通之后最后一步是让它接入一个稳定的模型通道。前面配置里出现的baseUrl就是干这个的。TaoToken 提供统一的 API 入口你只需要在控制台创建一个密钥然后把它填到 OpenClaw 的配置里就能用一个 Key 访问多个模型省去为每个模型单独配置的麻烦。具体操作路径是这样先到 TaoToken 控制台创建 API Key地址是 https://taotoken.net/api-keys 创建后复制密钥。然后回到 OpenClaw 配置把baseUrl设为https://taotoken.net/apiapiKey填刚复制的密钥。配置保存后重启 Gateway在 Dashboard 里发一条消息测试能正常返回就说明通道接好了。如果你在配置过程中遇到接入报错或者想确认请求参数怎么写可以对照接入文档排查https://taotoken.net/doc 。文档里有完整的请求示例和参数说明比对着改配置效率高很多。对于需要长期跑编码任务或者 Agent 场景的用户可以考虑用 Coding Plan它更适合高频、持续的调用需求配置方式和普通 API 一致只是计费和额度策略不同具体可以在 https://taotoken.net/coding-plan 查看。配置完成后建议做一次完整的连通性验证在 Dashboard 里发一条测试消息观察是否正常返回如果报错先检查baseUrl和apiKey是否填对再确认 Gateway 是否已重启。这套流程走下来你本地就有一个能统一调度多模型的 OpenClaw 环境了。
