OpenClaw（二）| 安装 OpenClaw（windows）

OpenClaw二| 安装 OpenClawwindows一、安装方案总览与选型二、前置依赖安装必做2.1 安装 Node.js2.2 安装 Git三、OpenClaw 原生 npm 安装核心步骤3.1 终端准备支持cmd/PowerShell3.2 切换 npm 国内镜像3.3 安装命令支持指定版本3.4 安装验证3.5 核心目录说明四、安装常见错误与解决4.1 错误码 128GitHub 权限拒绝publickey4.2 错误码 3221225477node-llama-cpp 编译失败五、配置1. 初始化配置Onboarding—仅首次安装2.选择模式Setup mode3.选择模型厂商Model/auth provider4.选择通道Select channel(QuickStart)5.搜索提供商6.安装skills7.钩子配置8.网关服务8.启动控制面板小龙虾正式诞生一、安装方案总览与选型OpenClaw 在 Windows 有两种部署路径优先推荐原生 npm 手动安装安装方式优点缺点推荐度WSL2 子系统官方推荐环境一致、兼容性好跨系统文件操控受限、操作繁琐⭐⭐⭐原生 Windows 一键脚本全自动、零配置失败无日志、版本/路径不可控、依赖缺失⭐⭐原生 Windows npm 手动全程可控、易排错、适配日常使用需手动配置依赖⭐⭐⭐⭐⭐核心结论日常使用选原生 npm 手动安装兼顾稳定性与控制权。二、前置依赖安装必做OpenClaw 基于 Node.js 开发依赖 Git 拉取组件需先配置两大基础环境。2.1 安装 Node.js版本要求推荐 v24我用的是v24.14.1最低 v22.14下载地址Node.js 官网安装步骤下载 Windows 安装包自定义路径后一路下一步安装完成重启终端执行验证命令node--versionnpm--version输出版本号即安装成功。2.2 安装 Git作用安装 OpenClaw 依赖时拉取仓库资源下载加速官方源慢 → 前往腾讯软件中心搜索 Git选择 64 位直接下载避开捆绑软件安装步骤自定义路径→一路下一步→重启终端验证git--version国内访问 GitHub 不稳定后续会配置协议替换加速。三、OpenClaw 原生 npm 安装核心步骤3.1 终端准备支持cmd/PowerShell用管理员身份打开 cmd/PowerShell如果是使用PowerShell 则需要通过以下命令解除执行策略cmd 无需Set-ExecutionPolicy-ScopeCurrentUser-ExecutionPolicyRemoteSigned3.2 切换 npm 国内镜像解决官方源下载慢npmconfigsetregistry https://registry.npmmirror.com/3.3 安装命令支持指定版本建议安装历史版本v2026.3.13 是目前使用人群最广的版本其次是 v2026.4.2 。如果追求稳定和可靠建议选择 v2026.3.13如果需要新功能且能接受轻微风险可以考虑 v2026.4.2。# 查看 OpenClaw 的所有版本npmshow openclaw versions# 安装指定历史版推荐npminstall-gopenclaw2026.3.13--verbose# 安装最新版新版本极不稳定npminstall-gopenclawlatest--verbose-g全局安装系统任意目录可调用openclaw命令-verbose实时日志输出查看安装过程。3.4 安装验证# 方法1直接查版本openclaw--version# 方法2npm 查全局包npmls-gopenclaw3.5 核心目录说明以下地址和你安装的npm位置相关命令路径~\AppData\Roaming\npm程序本体~\AppData\Roaming\npm\node_modules\openclaw内置技能安装目录\skills内置插件安装目录\dist\extensions四、安装常见错误与解决4.1 错误码 128GitHub 权限拒绝publickey原因依赖拉取用 SSH 协议未配置密钥解决全局替换为 HTTPS加速地址gitconfig--globalurl.https://gh-proxy.org/https://github.com/.insteadOfssh://gitgithub.com/安装完成后可取消配置gitconfig--global--unseturl.https://gh-proxy.org/https://github.com/.insteadOf4.2 错误码 3221225477node-llama-cpp 编译失败原因缺少 C 构建工具解决安装Visual Studio Build Tools≥2026.3.13 版本已修复此问题五、配置1. 初始化配置Onboarding—仅首次安装首次配置时触发这个即可我们在「以管理员身份运行的 cmd」中运行openclaw onboard --install-daemonopenclaw onboard --install-daemon在安全提醒这里选择 Yes可以通过左箭头选择然后回车也可以直接按键盘 Y2.选择模式Setup mode设置模式这里选择QuickStart该模式配置项更少无需手动设置 Workspace 目录、Gateway 端口号等均沿用默认配置反之选择 Manual 的话除了 QuickStart 的设置项之外像是 Workspace 目录、Gateway 的端口号这些都会让我们设置。3.选择模型厂商Model/auth providerMiniMax 国内用户首选国内站点https://www.minimaxi.com/海外站点https://www.minimax.io/进入官网进行实名认证送15.00 元的代金券后然后呢再创建一个key专门给这个openclaw用国内用户选择带 CN 的API Key 方式推荐需要我们去控制台复制 API Key再粘贴过来。OAuth 方式会自动弹出 MiniMax 授权页面你只要点同意授权就行不用手动复制粘贴密钥()注意API Key方式既支持 Token Plan 套餐的 API Key也支持按量计费的 API Key。OAuth 方式只针对 Token Plan 套餐接下来会提示我们输入 API Key把刚才复制好的内容粘贴进来就可以了。粘贴时注意一下复制完成回到终端后直接鼠标右键就能粘贴。过程中不要用鼠标左键点击终端的黑屏区域不然粘贴内容会被覆盖掉。如果真出现这种情况重新回去复制一遍再回来粘贴就可以了。默认模型选择第一个即可如果这个 Onboarding 过程某些步骤失误了CtrlC 退出引导然后执行openclaw uninstall基本上就能回到 Onboarding 之前的状态也就是 OpenClaw 刚装好的状态。如果这个过程中 clawhub 命令被安装了那就再加个卸载 clawhub 的命令npm rm -g clawhub。然后你再重新执行openclaw onboard --install-daemon4.选择通道Select channel(QuickStart)可跳过5.搜索提供商可跳过6.安装skills在技能列表中我们暂时只勾选这个 clawhub这样会帮我们安装 clawhub 命令clawhub 是后期用来安装技能要用的命令。这里要注意方向键选择之后还要按空格键确认左边显示号才表示选中了再按空格键盘表示取消勾选。7.钩子配置跳过8.网关服务选择完毕以后就会自动打开网页链接类似如下http://127.0.0.1:18789/#token0593af18eb6ed9c337eeeeb5beb0fd044edbc774289f09e4当如果出现说明还需要 安装 Gateway 服务# 强制安装 Gateway 服务openclaw gatewayinstall--force# 启动 Gateway 服务openclaw gateway startopenclaw gateway start执行后会在新窗口启动Gateway脚本进程不要关闭这个新窗口关闭的话Gateway 也就关闭了。请求http://127.0.0.1:18789/你会发现还是没有成功打开因为没有 认证令牌8.启动控制面板小龙虾正式诞生# 打开控制面板openclaw dashboard最终成功进入小龙虾界面和你的专属小龙虾说一说话吧参考文章【1】你知道怎么安装OpenClaw历史版本吗超系统的本地安装教程基于2026.3.24最新版【2】OpenClaw 安装补丁篇新版本Qwen (OAuth) 选项缺失WebUI 不自动弹出Git 下载太慢【3】新2026年一键安装 OpenClawWindows 中文版配置飞书和配置个人微信