引言
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


