引言
OpenClaw 是一款本地 AI 智能体，支持读写本地文件、操控浏览器、自动化办公等功能，并可接入 QQ 变身私人机器人。
前置准备与安全红线
1. 基础硬件 & 系统要求
| 系统类型 | 最低要求 | 推荐配置 |
|---|---|---|
| Windows | Windows 10 64 位 | Windows 11 64 位，优先使用 WSL2 |
| macOS | macOS 12+ | macOS 14+，M 系列芯片 |
| Linux | 内核 4.15+，1 核 1G 内存 | Ubuntu 22.04 LTS，2 核 2G 内存 |
额外要求：稳定的网络环境，用于下载依赖包和模型调用
2. 核心安全红线（必读！）
🚨 高风险提示：OpenClaw 拥有本地文件读写、系统命令执行等高权限，切勿安装来源不明的第三方技能包，避免恶意代码风险。AppID、AppSecret、API Key 等敏感信息切勿泄露、切勿上传到公开代码仓库。新手优先在虚拟机、云服务器或备用机上测试，避免误操作影响主力机数据。国内用户务必先配置 npm 国内镜像，90% 的安装失败都源于网络超时。
3. 前置环境安装
OpenClaw 基于 Node.js 运行，必须满足 Node 版本≥v22，Windows 用户还需安装 Git。
步骤 1：安装 Node.js
- 官网下载：Node.js 官方网站，选择 LTS 长期支持版本（自动附带 npm 包管理器）
- 安装全程默认下一步，自动配置系统环境变量
- 验证安装：打开终端 / PowerShell，执行以下命令，输出版本号≥v22 即为成功
node --version
npm --version
步骤 2：Windows 用户必装 Git
- 官网下载：Git 官方网站
- 安装全程默认下一步，安装程序会自动配置环境变量
- 验证安装：PowerShell 执行以下命令，输出版本号即为成功
git --version
步骤 3：配置国内 npm 镜像（关键避坑）
国内用户直接访问官方 npm 源极易超时失败，先执行以下命令切换淘宝镜像：
# 切换国内镜像源
npm config set registry https://registry.npmmirror.com
# 清理缓存，避免旧数据干扰
npm cache clean --force
# 验证镜像是否切换成功
npm config get registry
全平台安装教程（官方推荐方案）
方案一：一键脚本安装（新手首选，自动处理所有依赖）
🔹 Windows 系统安装
- 必须右键开始菜单，选择「Windows PowerShell (管理员)」，非管理员权限会导致安装失败
- 复制以下命令到 PowerShell 中回车执行，脚本会自动安装所有依赖和 OpenClaw 本体
irm -useb https://openclaw.ai/install.ps1 | iex
