简介
OpenClaw（昵称「龙虾」）是一款基于 Node.js 的本地 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
