最简洁、最易操作的openclaw安装方案
根据文档内容,针对Windows 11系统,安装OpenClaw主要有以下几种推荐方案:
方案一:WSL2 + Ubuntu部署(官方强烈推荐)
这是目前Windows平台上最完整、体验最佳的部署方式,能够提供完整的Linux环境支持,确保所有功能都能顺畅运行。
安装步骤:
启用WSL2:
首先以管理员身份打开PowerShell,依次执行以下命令:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
wsl --set-default-version 2
执行完毕后记得重启计算机。
安装Ubuntu:
打开Microsoft Store,搜索并安装“Ubuntu 22.04 LTS”或“Ubuntu 24.04 LTS”。首次启动时需要设置用户名和密码。
在Ubuntu中安装OpenClaw:
打开Ubuntu终端,执行一键安装脚本:
curl -fsSL https://openclaw.ai/install.sh | bash
如果遇到网络问题,可以使用国内镜像,速度会更快:
curl -fsSL https://clawd.org.cn/install.sh | bash
配置Windows访问:
OpenClaw服务运行在WSL2中。完成安装后,直接在Windows浏览器中访问 http://localhost:18789 就能使用Web界面了。
方案二:PowerShell原生部署
这个方案适合那些不想使用WSL2的纯Windows环境用户,操作相对直接。
安装步骤:
安装Node.js 22+:
访问Node.js官网,下载Windows安装包(选择LTS版本22.x),然后运行安装程序。
以管理员身份安装OpenClaw:
以管理员身份打开PowerShell,执行:
npm install -g openclaw@latest
或者安装国内社区汉化版:
npm install -g @qingchencloud/openclaw-zh@latest
解决可能的问题:
如果遇到权限问题,可以启用PowerShell脚本执行策略:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
要是sharp模块加载失败,清理缓存并强制重装通常能解决问题:
npm cache clean --force
npm install -g openclaw@latest --force
方案三:Docker部署(推荐新手)
这个方案提供环境隔离,实现一键部署,管理起来特别方便,很适合刚接触的用户。
安装步骤:
安装Docker Desktop:
访问Docker官网,下载并安装Docker Desktop for Windows。安装过程中会提示安装WSL2,按照指引完成即可。
一键脚本部署:
打开PowerShell(或WSL2终端),执行:
curl -fsSL https://clawd.org.cn/install.sh | bash
脚本会自动拉取镜像、启动容器并完成初始配置。
访问使用:
完成后,在浏览器中打开 http://127.0.0.1:18789/ 就能立即使用。
通用后续步骤(无论哪种方案)
安装完成后,都需要进行初始化配置:
在终端中运行配置向导:
openclaw onboard
按照向导提示:
选择AI模型提供商(国内推荐:Kimi、DeepSeek、智谱GLM)
输入对应模型的API Key
选择聊天工具(如飞书、钉钉等,或暂时选None)
完成配置后,就可以通过Web UI或配置的聊天工具开始使用了。
总结与建议
首选方案:方案一(WSL2)。这个方案能获得最完整的系统功能和最佳的兼容性,尤其是未来需要使用涉及系统集成的Skills时,优势更加明显。
备选方案:方案三(Docker)。简单快捷,环境干净,适合想要快速体验的用户。
注意事项:文档明确指出,纯Windows环境(方案二)下“部分系统集成功能受限”。如果只是进行基础对话和文件管理,可以选择方案二;但若想体验全部功能,建议使用WSL2或Docker方案。
请根据你的具体需求和熟悉程度选择安装方式。安装过程中如遇到问题,可参考文档中的“常见问题”部分进行排查。

