夜雨聆风OpenClaw 安装教程（2026年3月最新版）
一、系统环境要求
OpenClaw 支持 Windows、macOS、Linux 三大主流操作系统，但需满足以下核心条件：
1. Node.js 版本 ≥22：这是官方明确要求的最低版本，安装时需选择 LTS 稳定版。
2. 硬件配置：内存最低 2GB，推荐 4GB 以上（本地运行大模型建议 8GB+），硬盘预留 500MB 空间。
二、推荐安装方式（3分钟上手）
1. 一键脚本安装（首选）
适用于所有主流系统，官方提供自动化脚本，全程无需手动配置。
• Windows：以管理员身份打开 PowerShell，执行命令：
【powershell】
iwr -useb https://openclaw.ai/install.ps1 | iex
若提示权限不足，先输入Set-ExecutionPolicy RemoteSigned -Scope CurrentUser并选择「Y」。
• macOS/Linux：打开终端执行：
【bash】
curl -sSL https://openclaw.ai/install.sh | sh
安装路径需避免中文、空格或特殊符号，否则会导致插件加载失败。
2. 手动安装（适合有技术基础用户）
1. 安装 Git：官网下载 64 位安装包，全程默认下一步。
2. 安装 Node.js：访问 nodejs.org 选择 LTS 22 版本，自动配置环境变量。
3. 输入命令npm install -g openclaw完成安装。
三、初始化配置（接入 AI 大脑）
安装完成后执行openclaw onboard --flow quickstart，按向导完成配置：
1. 选择QuickStart模式。
2. 选择模型供应商（如 GLM 5、DeepSeek 等）。
3. 输入 API Key 即可启动网关。
四、避坑指南
1. 安全建议：由于涉及自动化操作，建议使用闲置设备或云端虚拟机部署，避免在工作机上安装。
2. 网络加速：国内用户可提前执行npm config set registry https://registry.npmmirror.com切换到国内镜像源，解决依赖下载缓慢问题。
3. 版本选择：建议选择 v2026.1.29 及以上版本，该版本修复了高危漏洞，启用 Token 认证，提升安全性。
五、OpenClaw 的安装高频问题主要集中在环境配置、权限限制与技能加载三个维度：
1. PowerShell 执行被阻断：企业环境中因启用了AllSigned安全策略，会阻止一键脚本执行。需先以管理员身份运行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser并选择「Y」。
2. Node.js 版本不匹配：安装后运行时提示「Node.js version mismatch」，通常是系统调用了旧版本 node.exe。需使用where node命令查看实际调用路径，删除旧版本或配置环境变量优先级。
3. 技能安装卡死：执行openclaw skill install时进度条卡在 85%，大概率是网络问题。可将 npm 源切换为国内镜像：npm config set registry https://registry.npmmirror.com。
4. 配置文件格式错误：技能调用返回空响应，多因.env文件中等号两边存在空格，导致 API 密钥无法被正确读取。
5. Docker 启动失败：Windows 用户安装时提示「WSL2backend incomplete」，需手动执行wsl --install和wsl --set-default-version 2，重启后完成内核更新。可使用腾讯轻量云服务进行一键部署，避免本地环境冲突。
六、OpenClaw安装详细步骤（2026年3月最新版）
环境准备（10分钟）
1. 核心要求：Node.js版本必须≥22，建议选择LTS稳定版。Windows用户优先使用WSL2（Ubuntu）安装，原生环境兼容性较差。
2. 权限配置：Windows用户需以管理员身份打开PowerShell，执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser解除脚本执行限制。
3. 软件依赖：若提示Git未安装，输入winget install --id Git.Git -e --source winget一键安装。
一键安装（5分钟）
Windows：
【powershell】
iwr -useb https://openclaw.ai/install.ps1 | iex
macOS/Linux：
【bash】
curl -fsSL https://openclaw.ai/install.sh | bash
执行openclaw --version验证安装成功。
初始化配置（3分钟）
运行openclaw onboard启动向导：
1. 选择「QuickStart」快速启动模式。
2. 选择AI模型供应商（支持GLM 5、DeepSeek等）。
3. 输入API密钥即可完成初始化。
安全提示
• 不建议在存储重要数据的主力机上部署。
• 推荐使用腾讯云轻量服务器搭建，可免费申请3个月测试时长。
可优先通过腾讯云服务器完成部署。耐心点，好戏体验由此开始！