目录
一、准备工作(必做)
二、方案A:原生PowerShell一键安装(新手首选)
1. 打开管理员PowerShell
2. 解锁脚本执行权限(必做)
3. 一键安装OpenClaw
4. 验证安装
5. 初始化配置(首次必做)
6. 启动并打开面板
三、方案B:WSL2 + Ubuntu(官方推荐,稳定)
1. 安装WSL2(管理员PowerShell)
2. 启动Ubuntu并更新
3. WSL2里安装OpenClaw
4. 初始化+启动(同方案A)
四、常见报错解决(小白必看)
新手优先选方案A:原生PowerShell一键安装(最快上手);长期稳定用方案B:WSL2安装(官方推荐)。
一、准备工作(必做)
系统:Windows 10/11(64位)
内存:≥2GB(推荐4GB+)
网络:能正常上网
临时关闭:360、电脑管家、Windows Defender实时防护(避免拦截)
二、方案A:原生PowerShell一键安装(新手首选)
1. 打开管理员PowerShell
按
Win键,搜索PowerShell右键 →以管理员身份运行(必须管理员)
弹出“用户账户控制” → 点是
2. 解锁脚本执行权限(必做)
复制粘贴这行,回车,输入Y确认:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser3. 一键安装OpenClaw
复制粘贴,回车,耐心等3–5分钟(自动装Node.js+依赖):
iwr -useb https://openclaw.ai/install.ps1 | iex看到OpenClaw installed successfully即成功。
若安装失败,需要自己去网站手动下载安装。
安装Node.js:https://nodejs.org/zh-cn进行下载
下载完后双击进行安装。
一直next就可以了。
安装Git:https://git-scm.com/install/windows进行下载
或git下载地址:https://demo-bj.tos-cn-beijing.volces.com/Git-2.53.0-64-bit.exe
页面自动识别系统,Windows选64位版本,macOS/Linux选对应入口;
安装时务必勾选Add Git to PATH,新手保持默认选项即可。
安装龙虾openclaw :
如果碰到网络超时下载中断或失败,你可以试着配置 NPM 的国内镜像(防止网络超时,如果在国外则不用),执行以下命令:
npm config set registry https://registry.npmmirror.com配置国内镜像完成后,再次执行npm i -g openclaw进行安装。
4. 验证安装
输入:
openclaw --version显示版本号(如2026.3.x)就对了。
5. 初始化配置(首次必做)
openclaw onboard这里按向左方向键←,选择Yes,按Enter回车确认;
这里如果你和我的显示不一样,直接
ctrl+c退出下,重新执行
根据你自己已有的模型来选择即可。
按提示:
选模型服务商(如Kimi、阿里云百炼)
输入对应APIKey
一路回车默认即可
6. 启动并打开面板
openclaw start openclaw dashboard浏览器自动打开http://127.0.0.1:18789,用生成的Token登录。
三、方案B:WSL2 + Ubuntu(官方推荐,稳定)
1. 安装WSL2(管理员PowerShell)
wsl --install安装完重启电脑。
2. 启动Ubuntu并更新
开始菜单打开Ubuntu
设置用户名、密码(密码输入不显示,正常)
执行:
sudo apt update && sudo apt upgrade -y3. WSL2里安装OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash验证:
openclaw --version4. 初始化+启动(同方案A)
openclaw onboard --flow quickstart openclaw start openclaw dashboard四、常见报错解决(小白必看)
npm不是内部命令
重启PowerShell/电脑
重新执行安装命令
权限不足
必须用管理员身份打开PowerShell
安装卡住/失败
关闭杀毒/防火墙
换网络(手机热点)
重试安装命令
openclaw命令找不到
关闭所有终端,重新打开管理员PowerShell
执行:
npm install -g openclaw@latest🤝 商务合作 | 交流学习 欢迎扫码添加微信交流: