在 Windows 10 个人电脑上部署 OpenClaw(2026 版)通常有两种路径:原生 Windows 安装(推荐零门槛、性能更好)和 WSL2 隔离安装(兼容性更强、推荐新手)。以下是两种方式的详细部署步骤及常见坑点。
这是目前国内用户最常用的方式,特别适合资源丰富(8GB+内存,建议16GB以上)的个人电脑。
打开 PowerShell(必须以管理员身份运行):
解决脚本执行策略:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force
关闭安全软件(如360、腾讯管家等)或设置白名单:
安装脚本会自动下载并执行文件,安全软件可能会误报拦截。
在管理员 PowerShell 中执行以下命令,OpenClaw 将自动完成环境检测、依赖安装和软件部署:
iwr -useb https://clawd.bot/install.ps1 | iex
或:
iwr -useb https://openclaw.ai/install.ps1 | iex
原理:该脚本会自动检测 Node.js、Git、pnpm 等环境,如未安装会自动帮你下载(Windows 版)。
耗时:首次安装会下载 200+ MB 数据,耐心等待。
安装完成后,执行初始化配置向导:
openclaw onboard
该向导会指导你完成 Ollama(本地大模型)或 OpenAI(云模型)的配置。
openclaw
如果看到欢迎界面,恭喜你安装成功!
官方强烈建议 Windows 用户通过 WSL2(Linux 子系统)安装,以获得更好的兼容性和隔离性。
安装 WSL2(仅需一次):
wsl --install
重启电脑。
打开 Ubuntu 终端(首次打开会自动初始化)。
在 Ubuntu 终端中执行:
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs npm install -g pnpm
pnpm add -g openclaw@latest # 或者 npm install -g openclaw@latest
openclaw onboard
权限不足:
问题:安装或运行时提示“权限被拒绝”。
解决:确保 PowerShell 是以 管理员身份运行,或者在 WSL2 终端中使用 sudo。
网络访问不了 GitHub:
问题:下载脚本或依赖失败。
解决:使用国内加速镜像,如 https://mirror.ghproxy.com/ 前缀,或配置 VPN。
Node.js 版本过低:
问题:脚本报错 Node.js version must be >=22。
解决:手动下载最新的 Node.js 22.x LTS 安装包(安装时勾选“Add to PATH”),或删除旧版本重新安装。
Git 未安装:
问题:提示 git not found。
解决:手动下载 Git for Windows(https://git-scm.com/download/win ),安装后重启 PowerShell。
备份配置:
配置文件位于 C:\Users\{你的用户名}\.openclaw,建议定期备份。
模型管理:
若使用 Ollama 作为本地模型引擎,建议下载 2GB 以上的模型文件,确保 C: 盘有足够空间(推荐 20GB+)。
总结:对于大多数用户,直接执行一键脚本 iwr -useb https://clawd.bot/install.ps1 | iex 是最快捷的方式。只要你的电脑联网正常、磁盘空间足够,整个过程完全自动化。
【版权声明】
本站部分内容来源于互联网,本站不拥有所有权,不承担相关法律责任。如果发现本站有侵权的内容,欢迎发送邮件至masing@13sy.com 举报,并提供相关证据,一经查实,本站将立刻删除涉嫌侵权内容。
下一篇:没有了