这是我写过的最完整的OpenClaw安装教程从环境准备到成功启动每个环节都不跳过。如果你之前看过其他的安装教程但装失败了或者你是完全的零基础新手这篇就是为你准备的。我会把安装过程中每一个可能出问题的点都标注出来确保你跟着做能一次成功。OpenClaw最新版本一键部署包下载地址TopClaw官网一键免费部署OpenClaw第一章环境准备千万不要跳过很多新手安装失败根本原因不在OpenClaw而是系统环境有问题。花3分钟做以下检查能帮你省掉后面可能浪费的半小时。检查项1操作系统版本Windows用户按 WinR输入winver回车。确认版本号不低于Windows 10版本1703以上。低于这个版本的建议升级系统否则很多依赖库不兼容。macOS用户点左上角苹果图标→关于本机。确认macOS版本不低于10.15Catalina。太旧的MacBook可能无法运行最新版Node.js。Linux用户终端输入cat /etc/os-release确认发行版和版本。Ubuntu 18.04、CentOS 7、Debian 10 都可以。检查项2内存和磁盘Windows任务管理器→性能标签 macOS活动监视器 Linuxfree -h 和 df -h 要求 内存≥4GB推荐8GB 磁盘可用≥2GB如果内存只有2GBOpenClaw能跑但会比较卡。特别是安装依赖的时候内存消耗比较大建议关掉其他占内存的程序Chrome标签页少开点。检查项3网络环境安装过程中需要下载依赖使用过程中需要调用大模型API。两个都需要网络。测试网络是否正常 ping open.bigmodel.cn 如果ping不通可能的原因 1. 网络本身有问题检查WiFi/网线 2. DNS解析失败试试换DNS为114.114.114.114 3. 被公司/学校防火墙拦截需要白名单或VPN检查项4端口占用OpenClaw默认使用3456端口。提前检查一下这个端口有没有被占用Windowsnetstat -ano | findstr 3456 macOS/Linuxlsof -i :3456如果有输出说明端口被占。要么关掉占用进程要么等会儿改OpenClaw的端口配置。第二章获取API Key建议先把这一步搞定再安装OpenClaw因为安装完之后你可以马上测试不用等API Key审核。1. 打开 https://open.bigmodel.cn 2. 手机号注册 3. 实名认证上传身份证正反面1-5分钟审核 4. 登录→控制台→API Keys→创建新Key 5. 复制Key到记事本保存注意Key只显示一次。如果关掉了页面没保存只能删除旧的重新创建。第三章安装OpenClaw安装包方式Windows推荐1. 下载 .exe 安装包 2. 双击运行UAC提示点是 3. 安装向导四步同意→路径→快捷方式→安装 4. 完成后桌面出现图标 5. 首次启动防火墙弹窗→点允许访问Docker方式Linux/macOS推荐docker pull nicepkg/openclaw:latest docker run -d --name openclaw --restart unless-stopped \ -p 3456:3456 \ -v ~/.qclaw:/root/.qclaw \ nicepkg/openclaw:latest源码方式开发者# 确认Node.js 18 node --version # 克隆和安装 git clone https://github.com/nicepkg/openclaw.git cd openclaw npm config set registry https://registry.npmmirror.com npm install第四章配置在~/.qclaw/.env文件中写入ZHIPU_API_KEY你的KeyWindows用户注意文件名必须是.env不是.env.txt。在文件夹选项里勾选显示文件扩展名再确认。第五章启动与验证启动OpenClaw浏览器打开http://localhost:3456输入你好发送。收到回复 → 安装成功 ✓ 未收到回复 → 进入排查模式 ① Gateway是否在运行看终端有没有输出 ② 端口是否正确确认3456没被占 ③ .env文件是否正确Key、拼写、文件名 ④ 防火墙是否阻止 ⑤ 浏览器缓存→ 清缓存或无痕模式重试99%的失败都能通过以上五个排查步骤找到原因。按顺序来不要乱试。第六章安装后的第一件事安装成功后建议立即做三件事1. 编辑SOUL.md定制Agent风格 2. 安装常用Skillxlsx、email等 3. 测试各种功能搜索、代码生成、文件操作等到此为止从环境准备到成功启动你已经完成了完整的OpenClaw安装之旅。如果过程中遇到这篇没有覆盖到的问题去GitHub Issues搜一下大概率有人已经遇到过并给出了解决方案。