国内网络环境下安装 OpenClaw 最头疼的就是下载慢、依赖拉不动。下面这个方案全程使用国内镜像源,保证安装速度。

📋 准备工作

在开始之前,先确认你的电脑满足以下要求:

项目 要求
操作系统 Windows 10 / Windows 11
Node.js 版本 ≥ 22
网络环境 能正常访问互联网(无需科学上网)

如果还没安装 Node.js 22,先往下看安装步骤,我会一并处理。


🛠️ 一键安装步骤

第一步:安装 Node.js 22

方法一(推荐):官网下载安装包

  1. 访问 Node.js 官网:https://nodejs.org/

  2. 下载 v22.x LTS 版本的 Windows 安装包(.msi 文件)

  3. 双击安装,一路点 Next 即可

安装完成后,打开 命令提示符(CMD) 或 PowerShell,输入以下命令验证:

powershell

node --version

如果显示 v22.x.x,说明安装成功。


第二步:配置 npm 国内镜像源

这一步是关键!不配置的话,下载速度可能只有几十 KB/s。

打开 命令提示符(CMD) 或 PowerShell,执行:

powershell

npm config set registry https://registry.npmmirror.com

验证是否配置成功:

powershell

npm config get registry

如果返回 https://registry.npmmirror.com,说明配置正确。


第三步:安装 OpenClaw 中文社区版

推荐安装 OpenClaw 中文社区版openclaw-cn),它的依赖包已经全部构建为国内可快速下载的 npm 包,避免了 GitHub 拉取超时的问题。

执行以下命令一键安装:

powershell

npm install -g openclaw-cn@latest

安装过程大约需要 1-3 分钟(取决于网络速度)。如果遇到权限报错,可以用管理员身份运行命令提示符。

💡 小提示:如果安装过程中卡住不动,按 Ctrl + C 终止后重新运行即可。


第四步:验证安装

安装完成后,执行以下命令检查是否安装成功:

powershell

openclaw-cn --version

如果显示版本号(如 0.1.8-fix.5),说明安装成功!


🎯 首次启动与配置

安装完成后,运行配置向导来初始化 OpenClaw:

powershell

openclaw-cn onboard

配置向导会依次询问以下内容:

配置项 建议选择
安全警告 Yes(确认授权)
安装模式 QuickStart
模型供应商 Qwen(通义千问,每日免费 2000 次调用)
渠道配置 Skip for now(稍后配置)
技能安装 Skip for now(稍后配置)

配置完成后,OpenClaw 会自动启动网关服务,默认监听 http://127.0.0.1:18789

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐