一、前言教程适配说明 工具准备大家好本文专为Windows 系统用户打造全网最细的OpenClaw本地化部署教程从环境配置到成功运行全程无死角哪怕你是零基础的编程新手跟着步骤走也能一次搞定。 教程适配范围系统要求Windows 10/11 64 位系统家庭版 / 专业版均可不支持 Windows 7 及以下版本硬件门槛最低 4 核 CPU 4GB 内存建议 8GB 以上部署过程更流畅避免内存不足导致安装中断前置工具必须提前安装 Git版本 2.30.0【可以直接安装最新版本本文如下演示的版本为2.53.0】和 Node.js建议 版本在 V22.22.1 LTS 长期支持版及以上本文如下演示使用的版本是 V24.14.0(LTS)。 为什么写这篇教程很多朋友反馈 OpenClaw 官方部署文档偏简略Windows 系统下容易到「环境不兼容」「依赖缺失」「权限报错」等问题踩坑后甚至从头重装系统。本文基于 2026 年最新版 OpenClaw 适配不仅拆解每一步操作还提前梳理了新手必踩的坑和解决方案帮你节省 90% 的排错时间。 前置约定本文所有操作均在管理员权限的 CMD/PowerShell 中完成避免权限不足导致文件写入失败所有命令和配置均经过实测复制粘贴即可使用无需手动修改路径若你已安装 Git/Node.js可跳过工具准备环节直接验证版本是否符合要求即可。接下来我们先完成基础工具的安装与验证为 OpenClaw 部署打好基础。二、Windows必备部署环境搭建本章节将手把手教你完成 Git 和 Node.js 的安装、版本验证彻底解决环境不兼容、版本不匹配的问题为 OpenClaw 部署扫清第一个障碍。 核心原则版本选对少踩 80% 的坑工具推荐版本不推荐版本原因Git2.30.064 位2.30.0 / 32 位低版本不支持部分克隆命令Node.js22 LTS64 位及以上22.x / 32 位低版本与 OpenClaw 依赖冲突直接报错2.1 Git 安装与验证步骤 1下载适配安装包官方下载地址国内可直达https://git-scm.com/install/windows自动识别 Windows 系统位数下载「64-bit Git for Windows Setup」安装包大小约 50MB如果觉得浏览器下载过慢可以直接把下载链接复制到迅雷进行下载会比较快。或者使用我已经下载好了的版本直接通过百度云网盘下载即可链接见最下方。步骤 2傻瓜式安装默认配置即可双击安装包在弹框中选择【是】允许此应用对你的设备进行更改其余步骤全部点击「Next」无需修改安装路径、默认编辑器等新手不用折腾安装完成后取消勾选「View Release Notes」点击「Finish」。步骤 3验证安装是否成功按下Win R输入cmd打开命令提示符务必以管理员身份运行输入以下命令回车后能显示版本号即代表成功2.2 Node.js 安装与验证步骤 1下载 LTS 版本安装包官方下载地址https://nodejs.org/en/download选择「Windows 安装包 (.msi)」64 位版本对应 V24.14.0( LTS)页面会标注「长期支持版」示例下载链接 V24.14.0( LTS)https://nodejs.org/dist/v24.14.0/node-v24.14.0-x64.msi。步骤 2安装 Node.js双击安装包勾选【I accept the terms in the License Agreement】然后点击「Next」后续所有选择都按默认选择「Next」即可。新手不用折腾安装完成后点击「Finish」无需重启电脑。步骤 3验证 Node.js 和 npm管理员身份打开 CMD输入以下两条命令均显示版本号即成功# 验证Node.js版本 node -v # 成功示例输出v24.14.0 # 验证npm版本Node.js自带 npm -v # 成功示例输出11.9.0关键提醒全程必须以管理员身份运行 CMD/PowerShell否则会出现「权限不足」「文件写入失败」等问题若已安装过 Git/Node.js先通过验证命令确认版本是否符合要求不符合则卸载重装环境搭建完成后不要关闭 CMD 窗口后续还需要在这个窗口进行 OpenClaw 安装配置。三、高能预警新手必踩 避坑清单报错根源 一键解决本节提前拦截 Windows 部署三大致命卡点90% 新手安装失败都源于此按顺序预处理直接规避报错回滚全程不翻车。❌ 避坑 1未修改系统执行策略 → 安装脚本直接拦截失败报错根源Windows 默认 PowerShell 安全策略禁止运行未签名本地脚本直接双击 / 执行 install 脚本会秒报错终止。✅ 一键根治方案必做前置右键桌面左下角「Win 开始图标」→ 选择Windows PowerShell (管理员)必须管理员权限复制粘贴以下强制修改策略命令回车运行powershellSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser弹出选择提示时输入Y回车确认修改即时生效⚠️ 关键提醒未改此策略后续所有一键安装命令必报错优先执行❌ 避坑 2默认国外镜像源 → 一键安装提示网络超时 / 连接异常报错根源官方默认 npm/Git 镜像服务器在海外国内网络丢包严重依赖下载中断、速度为 0判定网络异常。【可以先不修改镜像源先使用默认官方源尝试安装一般就等几分钟也能安装完毕就不用修改源了】✅ 极速修复方案国内专属管理员 CMD/PowerShell 执行命令一键切换阿里国内稳定镜像源# 永久切换npm为淘宝镜像秒连不卡顿 npm config set registry https://registry.npmmirror.com # 验证是否切换成功 npm config get registry后续部署完成如需恢复官方默认镜像执行还原脚本npm config set registry https://registry.npmjs.org❌ 避坑 3杀毒软件误判拦截 → 提示脚本含恶意内容 / 进程隔离报错根源OpenClaw 本地部署需读写本地文件、拉取开源依赖系统防火墙 / 第三方杀毒会误识别为可疑恶意程序直接拦截删除脚本。✅ 安全临时解决方案打开 Windows 设置 → 更新和安全 → Windows 安全中心依次关闭实时病毒防护、云提供保护、防火墙网络拦截若安装 360 / 火绒等第三方杀毒临时退出悬浮进程部署成功后立即重启开启防护 安全提示仅部署安装阶段临时关闭运行正常后务必恢复防护不影响本地项目使用。四、OpenClaw 本地化分步安装教程零基础逐行实操步骤1执行openclaw一键安装命令首先使用管理员权限进入Windows PowerShell命令行窗口然后输入如下安装命令。--openclaw官方一键安装命令 iwr -useb https://openclaw.ai/install.ps1 | iex然后等待安装如果没有更换镜像源安装会有点慢一般需要5-10分钟左右。【如果觉得慢了可以参考如上命令修改npm镜像源为国内淘宝镜像源】等待几分钟安装完毕后即可进入配置交互页面。步骤2 使用键盘左右箭头切换到Yes,然后按住Enter键确认。步骤3 使用上下方向键切换选择QuickStart,然后按Enter键确认继续下一步。新手直接快速配置后续个性化配置单独在网页进行设置步骤4 选择 Update values 进入交互式配置流程。步骤5 选择Custom Provider选项自定义API服务商然后按Enter键进入下一步。步骤6 配置自定义服务商的访问地址 复制如下地址到配置页面配置好API Base URL地址这个就是后续调用token进行对话的核心参数。然后点击enter键继续下一步。【这里以宙流API中转站为例该网站可以在国内使用一个API令牌密钥就可以访问国内外顶尖大模型,目前支持400以上模型调用注册网站就可以免费赠送0.4刀额度然后每天签到也可以免费获取不定数量的额度用来测试比较方便大家如果有其他模型也可以使用其他模型进行配置。】--宙流API中转站-openAI兼容格式配置地址 https://zhouliuai.online/v1步骤7 配置 API Key参数。选择第一个选项Paste API Key now,直接在对话框输入API密钥然后选择下一步。步骤 8 注册中转站账号获取免费API Key首先访问地址https://zhouliuai.online/register进行账号注册注册完毕后进入首页点击【API令牌】-【添加令牌】然后输入令牌名称可以直接输入【openclaw测试】随后选择分组就勾选【限时特价】【default】,【逆向】【纯ZA】即可。这些比较便宜适合测试使用下一步其他参数无需修改直接点击【提交】即可。然后选择刚才创建的API令牌复制密钥即可。下一步会使用这个密钥步骤 9 输入宙流API密钥直接把上一步复制的宙流API密钥粘贴到交互配置窗口里面即可然后下一步。步骤10 配置兼容接口类型直接选择 OpenAI-compatible 参数即可兼容 OpenAI 接口因为后面也是要使用open ai 模型然后进行下一步。步骤11 配置使用模型名称这里需要输入的就是第三方中转站里面定义的模型名称这里以宙流API中转站为例。进入中转站。选择【模型广场】然后在搜索框中搜索gpt-4o-mini模型后续会使用这个模型做测试下一步就复制这个模型名称然后填入配置页面。已填写模型名称如下然后下一步。步骤12 配置自定义API服务商名称这个是自定义API服务商名称可以使用默认带出的直接按Enter键继续下一步。步骤 13 配置模型别名这个是模型别名可以直接设置为gpt-4o-mini,然后继续下一步。步骤14 配置选择接入渠道快速开始直接选择 Skip for now,暂时不进行配置先把程序跑通然后下一步。步骤 15 配置搜索服务商参数直接选择 Skip for now,暂时不进行配置先把程序跑通然后下一步。步骤 16 配置技能参数直接选择 No ,技能后续通过网页配置继续下一步。步骤 17 配置扩展功能参数直接选择 Skip for now,暂时不进行配置先把程序跑通然后下一步。先按空格键再按enter键选择。步骤 19 配置机器人交互方式直接选择web ui网页交互即可然后下一步。出现这个网页证明部署成功了。五、部署成功实测效果全展示目前已经部署成功现在需要进行测试验证效果我会进行一个简单问答测试结果如下如上所示已经完成了全部的安装部署现在可以畅快的使用OpenClaw了。六、OpenClaw快速卸载如果需要卸载OpenClaw,a按照如下命令执行即可。使用管理员身份打开Windows PowerShell然后依次执行如下命令即可。# 以管理员身份运行此脚本 # 1. 停止并卸载网关服务 try { openclaw gateway stop *$null } catch { Write-Host ⚠️ 网关服务未运行无需停止 -ForegroundColor Yellow } try { openclaw gateway uninstall *$null } catch { Write-Host ⚠️ 网关服务未安装无需卸载 -ForegroundColor Yellow } # 2. 强制杀死残留进程 $process Get-Process -Name openclaw-gateway -ErrorAction SilentlyContinue if ($process) { Stop-Process -Id $process.Id -Force -ErrorAction SilentlyContinue Write-Host ✅ 已终止 openclaw-gateway 残留进程 -ForegroundColor Green } else { Write-Host ℹ️ 无 openclaw-gateway 残留进程 -ForegroundColor Cyan } # 3. 卸载 OpenClaw 全局包 npm uninstall -g openclaw if ($LASTEXITCODE -eq 0) { Write-Host ✅ OpenClaw 全局包已卸载 -ForegroundColor Green } else { Write-Host ❌ OpenClaw 全局包卸载失败 -ForegroundColor Red } # 4. 删除配置目录 $configPath $env:USERPROFILE\.openclaw if (Test-Path $configPath) { Remove-Item -Recurse -Force $configPath -ErrorAction SilentlyContinue Write-Host ✅ 配置目录 $configPath 已删除 -ForegroundColor Green } else { Write-Host ℹ️ 配置目录 $configPath 不存在 -ForegroundColor Cyan } # 5. 清理 npm 缓存 npm cache clean --force *$null Write-Host ✅ npm 缓存已清理 -ForegroundColor Green # 6. 验证卸载结果 if (Get-Command openclaw -ErrorAction SilentlyContinue) { Write-Host ❌ 卸载不彻底仍检测到 openclaw 命令 -ForegroundColor Red } else { Write-Host ✅ OpenClaw 已完全卸载完成 -ForegroundColor Green }七、附录 资源获取1.git以及node.js安装包百度云下载地址有需要可以直接下载通过网盘分享的文件OpenClaw部署环境包链接: https://pan.baidu.com/s/1vuwBF3sBMJ2fOUaOhf9QMw?pwd5389 提取码: 5389--来自百度网盘超级会员v6的分享
OpenClaw Windows 本地化部署｜保姆级教程 + 避坑指南（2026 最新最全）
一、前言教程适配说明 工具准备大家好本文专为Windows 系统用户打造全网最细的OpenClaw本地化部署教程从环境配置到成功运行全程无死角哪怕你是零基础的编程新手跟着步骤走也能一次搞定。 教程适配范围系统要求Windows 10/11 64 位系统家庭版 / 专业版均可不支持 Windows 7 及以下版本硬件门槛最低 4 核 CPU 4GB 内存建议 8GB 以上部署过程更流畅避免内存不足导致安装中断前置工具必须提前安装 Git版本 2.30.0【可以直接安装最新版本本文如下演示的版本为2.53.0】和 Node.js建议 版本在 V22.22.1 LTS 长期支持版及以上本文如下演示使用的版本是 V24.14.0(LTS)。 为什么写这篇教程很多朋友反馈 OpenClaw 官方部署文档偏简略Windows 系统下容易到「环境不兼容」「依赖缺失」「权限报错」等问题踩坑后甚至从头重装系统。本文基于 2026 年最新版 OpenClaw 适配不仅拆解每一步操作还提前梳理了新手必踩的坑和解决方案帮你节省 90% 的排错时间。 前置约定本文所有操作均在管理员权限的 CMD/PowerShell 中完成避免权限不足导致文件写入失败所有命令和配置均经过实测复制粘贴即可使用无需手动修改路径若你已安装 Git/Node.js可跳过工具准备环节直接验证版本是否符合要求即可。接下来我们先完成基础工具的安装与验证为 OpenClaw 部署打好基础。二、Windows必备部署环境搭建本章节将手把手教你完成 Git 和 Node.js 的安装、版本验证彻底解决环境不兼容、版本不匹配的问题为 OpenClaw 部署扫清第一个障碍。 核心原则版本选对少踩 80% 的坑工具推荐版本不推荐版本原因Git2.30.064 位2.30.0 / 32 位低版本不支持部分克隆命令Node.js22 LTS64 位及以上22.x / 32 位低版本与 OpenClaw 依赖冲突直接报错2.1 Git 安装与验证步骤 1下载适配安装包官方下载地址国内可直达https://git-scm.com/install/windows自动识别 Windows 系统位数下载「64-bit Git for Windows Setup」安装包大小约 50MB如果觉得浏览器下载过慢可以直接把下载链接复制到迅雷进行下载会比较快。或者使用我已经下载好了的版本直接通过百度云网盘下载即可链接见最下方。步骤 2傻瓜式安装默认配置即可双击安装包在弹框中选择【是】允许此应用对你的设备进行更改其余步骤全部点击「Next」无需修改安装路径、默认编辑器等新手不用折腾安装完成后取消勾选「View Release Notes」点击「Finish」。步骤 3验证安装是否成功按下Win R输入cmd打开命令提示符务必以管理员身份运行输入以下命令回车后能显示版本号即代表成功2.2 Node.js 安装与验证步骤 1下载 LTS 版本安装包官方下载地址https://nodejs.org/en/download选择「Windows 安装包 (.msi)」64 位版本对应 V24.14.0( LTS)页面会标注「长期支持版」示例下载链接 V24.14.0( LTS)https://nodejs.org/dist/v24.14.0/node-v24.14.0-x64.msi。步骤 2安装 Node.js双击安装包勾选【I accept the terms in the License Agreement】然后点击「Next」后续所有选择都按默认选择「Next」即可。新手不用折腾安装完成后点击「Finish」无需重启电脑。步骤 3验证 Node.js 和 npm管理员身份打开 CMD输入以下两条命令均显示版本号即成功# 验证Node.js版本 node -v # 成功示例输出v24.14.0 # 验证npm版本Node.js自带 npm -v # 成功示例输出11.9.0关键提醒全程必须以管理员身份运行 CMD/PowerShell否则会出现「权限不足」「文件写入失败」等问题若已安装过 Git/Node.js先通过验证命令确认版本是否符合要求不符合则卸载重装环境搭建完成后不要关闭 CMD 窗口后续还需要在这个窗口进行 OpenClaw 安装配置。三、高能预警新手必踩 避坑清单报错根源 一键解决本节提前拦截 Windows 部署三大致命卡点90% 新手安装失败都源于此按顺序预处理直接规避报错回滚全程不翻车。❌ 避坑 1未修改系统执行策略 → 安装脚本直接拦截失败报错根源Windows 默认 PowerShell 安全策略禁止运行未签名本地脚本直接双击 / 执行 install 脚本会秒报错终止。✅ 一键根治方案必做前置右键桌面左下角「Win 开始图标」→ 选择Windows PowerShell (管理员)必须管理员权限复制粘贴以下强制修改策略命令回车运行powershellSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser弹出选择提示时输入Y回车确认修改即时生效⚠️ 关键提醒未改此策略后续所有一键安装命令必报错优先执行❌ 避坑 2默认国外镜像源 → 一键安装提示网络超时 / 连接异常报错根源官方默认 npm/Git 镜像服务器在海外国内网络丢包严重依赖下载中断、速度为 0判定网络异常。【可以先不修改镜像源先使用默认官方源尝试安装一般就等几分钟也能安装完毕就不用修改源了】✅ 极速修复方案国内专属管理员 CMD/PowerShell 执行命令一键切换阿里国内稳定镜像源# 永久切换npm为淘宝镜像秒连不卡顿 npm config set registry https://registry.npmmirror.com # 验证是否切换成功 npm config get registry后续部署完成如需恢复官方默认镜像执行还原脚本npm config set registry https://registry.npmjs.org❌ 避坑 3杀毒软件误判拦截 → 提示脚本含恶意内容 / 进程隔离报错根源OpenClaw 本地部署需读写本地文件、拉取开源依赖系统防火墙 / 第三方杀毒会误识别为可疑恶意程序直接拦截删除脚本。✅ 安全临时解决方案打开 Windows 设置 → 更新和安全 → Windows 安全中心依次关闭实时病毒防护、云提供保护、防火墙网络拦截若安装 360 / 火绒等第三方杀毒临时退出悬浮进程部署成功后立即重启开启防护 安全提示仅部署安装阶段临时关闭运行正常后务必恢复防护不影响本地项目使用。四、OpenClaw 本地化分步安装教程零基础逐行实操步骤1执行openclaw一键安装命令首先使用管理员权限进入Windows PowerShell命令行窗口然后输入如下安装命令。--openclaw官方一键安装命令 iwr -useb https://openclaw.ai/install.ps1 | iex然后等待安装如果没有更换镜像源安装会有点慢一般需要5-10分钟左右。【如果觉得慢了可以参考如上命令修改npm镜像源为国内淘宝镜像源】等待几分钟安装完毕后即可进入配置交互页面。步骤2 使用键盘左右箭头切换到Yes,然后按住Enter键确认。步骤3 使用上下方向键切换选择QuickStart,然后按Enter键确认继续下一步。新手直接快速配置后续个性化配置单独在网页进行设置步骤4 选择 Update values 进入交互式配置流程。步骤5 选择Custom Provider选项自定义API服务商然后按Enter键进入下一步。步骤6 配置自定义服务商的访问地址 复制如下地址到配置页面配置好API Base URL地址这个就是后续调用token进行对话的核心参数。然后点击enter键继续下一步。【这里以宙流API中转站为例该网站可以在国内使用一个API令牌密钥就可以访问国内外顶尖大模型,目前支持400以上模型调用注册网站就可以免费赠送0.4刀额度然后每天签到也可以免费获取不定数量的额度用来测试比较方便大家如果有其他模型也可以使用其他模型进行配置。】--宙流API中转站-openAI兼容格式配置地址 https://zhouliuai.online/v1步骤7 配置 API Key参数。选择第一个选项Paste API Key now,直接在对话框输入API密钥然后选择下一步。步骤 8 注册中转站账号获取免费API Key首先访问地址https://zhouliuai.online/register进行账号注册注册完毕后进入首页点击【API令牌】-【添加令牌】然后输入令牌名称可以直接输入【openclaw测试】随后选择分组就勾选【限时特价】【default】,【逆向】【纯ZA】即可。这些比较便宜适合测试使用下一步其他参数无需修改直接点击【提交】即可。然后选择刚才创建的API令牌复制密钥即可。下一步会使用这个密钥步骤 9 输入宙流API密钥直接把上一步复制的宙流API密钥粘贴到交互配置窗口里面即可然后下一步。步骤10 配置兼容接口类型直接选择 OpenAI-compatible 参数即可兼容 OpenAI 接口因为后面也是要使用open ai 模型然后进行下一步。步骤11 配置使用模型名称这里需要输入的就是第三方中转站里面定义的模型名称这里以宙流API中转站为例。进入中转站。选择【模型广场】然后在搜索框中搜索gpt-4o-mini模型后续会使用这个模型做测试下一步就复制这个模型名称然后填入配置页面。已填写模型名称如下然后下一步。步骤12 配置自定义API服务商名称这个是自定义API服务商名称可以使用默认带出的直接按Enter键继续下一步。步骤 13 配置模型别名这个是模型别名可以直接设置为gpt-4o-mini,然后继续下一步。步骤14 配置选择接入渠道快速开始直接选择 Skip for now,暂时不进行配置先把程序跑通然后下一步。步骤 15 配置搜索服务商参数直接选择 Skip for now,暂时不进行配置先把程序跑通然后下一步。步骤 16 配置技能参数直接选择 No ,技能后续通过网页配置继续下一步。步骤 17 配置扩展功能参数直接选择 Skip for now,暂时不进行配置先把程序跑通然后下一步。先按空格键再按enter键选择。步骤 19 配置机器人交互方式直接选择web ui网页交互即可然后下一步。出现这个网页证明部署成功了。五、部署成功实测效果全展示目前已经部署成功现在需要进行测试验证效果我会进行一个简单问答测试结果如下如上所示已经完成了全部的安装部署现在可以畅快的使用OpenClaw了。六、OpenClaw快速卸载如果需要卸载OpenClaw,a按照如下命令执行即可。使用管理员身份打开Windows PowerShell然后依次执行如下命令即可。# 以管理员身份运行此脚本 # 1. 停止并卸载网关服务 try { openclaw gateway stop *$null } catch { Write-Host ⚠️ 网关服务未运行无需停止 -ForegroundColor Yellow } try { openclaw gateway uninstall *$null } catch { Write-Host ⚠️ 网关服务未安装无需卸载 -ForegroundColor Yellow } # 2. 强制杀死残留进程 $process Get-Process -Name openclaw-gateway -ErrorAction SilentlyContinue if ($process) { Stop-Process -Id $process.Id -Force -ErrorAction SilentlyContinue Write-Host ✅ 已终止 openclaw-gateway 残留进程 -ForegroundColor Green } else { Write-Host ℹ️ 无 openclaw-gateway 残留进程 -ForegroundColor Cyan } # 3. 卸载 OpenClaw 全局包 npm uninstall -g openclaw if ($LASTEXITCODE -eq 0) { Write-Host ✅ OpenClaw 全局包已卸载 -ForegroundColor Green } else { Write-Host ❌ OpenClaw 全局包卸载失败 -ForegroundColor Red } # 4. 删除配置目录 $configPath $env:USERPROFILE\.openclaw if (Test-Path $configPath) { Remove-Item -Recurse -Force $configPath -ErrorAction SilentlyContinue Write-Host ✅ 配置目录 $configPath 已删除 -ForegroundColor Green } else { Write-Host ℹ️ 配置目录 $configPath 不存在 -ForegroundColor Cyan } # 5. 清理 npm 缓存 npm cache clean --force *$null Write-Host ✅ npm 缓存已清理 -ForegroundColor Green # 6. 验证卸载结果 if (Get-Command openclaw -ErrorAction SilentlyContinue) { Write-Host ❌ 卸载不彻底仍检测到 openclaw 命令 -ForegroundColor Red } else { Write-Host ✅ OpenClaw 已完全卸载完成 -ForegroundColor Green }七、附录 资源获取1.git以及node.js安装包百度云下载地址有需要可以直接下载通过网盘分享的文件OpenClaw部署环境包链接: https://pan.baidu.com/s/1vuwBF3sBMJ2fOUaOhf9QMw?pwd5389 提取码: 5389--来自百度网盘超级会员v6的分享
