OpenClaw 小白友好型部署手册（Windows + Linux）
这篇手册面向零基础用户，尽量把部署 OpenClaw 的过程讲得直白一些。你不需要先弄懂一堆概念，只要按步骤准备好基础环境，再完成安装、初始化和验证，基本就能把它跑起来。下面以 Windows 10/11 和 Ubuntu 为例，分别说明。
部署前先准备好这些东西
OpenClaw 的核心依赖并不复杂，真正容易卡住的地方，通常是环境没装全，或者安装路径、权限、网络源没处理好。提前把这些事情理顺，后面会顺很多。
硬件要求
- 最低配置：2 核 CPU、4GB 内存、50GB 可用硬盘空间。这个配置适合只跑基础功能，不加载本地大模型。
- 推荐配置：4 核 CPU、8GB 以上内存、100GB SSD。这样多任务运行会更顺手一些。
- 如果你打算离线使用，或者在本地加载 Qwen、Llama 这类模型，最好准备 16GB 以上内存，并尽量使用 NVIDIA 显卡，体验会更稳定。
需要提前准备的工具和账号
- 网络要正常，至少能访问 GitHub，因为安装过程会拉取依赖。
- 如果你打算接入云端大模型，需要准备一个可用的 API Key。新手可以优先选中文支持较好的模型服务。
- 两个平台都要安装 Node.js 和 Git。Node.js 是运行环境，Git 负责拉取源码，后面会分别给出安装方式。
先记住几个容易踩坑的点
- 安装路径、文件夹名尽量不要包含中文、空格或特殊符号。
- 安装过程中如果系统弹出权限提示，直接确认即可。
- API Key 属于敏感信息，不要随手发给别人，也不要直接明文放在公开地方。
- 真遇到报错，先看后面的常见问题，大多数情况都能对上。
Windows 10/11 部署步骤
Windows 上最省事的方式就是走脚本安装。你几乎不需要自己拼命记命令，照着做就行。
1）安装 Node.js 和 Git
安装 Node.js
- 打开 Node.js 官方网站，下载 LTS 长期支持版。
- 双击安装包，基本一路点'下一步'即可。安装过程中如果看到自动安装必要工具之类的选项，建议勾上。
- 安装完成后，重新打开终端，输入：
node -v
如果能看到版本号，说明 Node.js 已经装好了。
安装 Git
- 打开 Git 官方网站，下载 Windows 版本安装包。
- 按默认选项安装即可。
- 安装结束后，在终端里输入：
git -v
能返回版本号，就说明 Git 可用了。
配置国内 npm 镜像
如果你在国内网络环境下，建议顺手把 npm 镜像换掉，不然后面拉依赖可能会慢很多。
打开 PowerShell，执行：
npm config set registry https://registry.npmmirror.com
执行完就可以了，不需要额外操作。
2）一键部署 OpenClaw
接下来是最关键的一步。Windows 下建议用管理员权限打开 PowerShell，然后依次执行下面的命令。
先放开当前用户的脚本执行权限：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
然后执行一键安装脚本：