简介
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
全平台安装教程
方案一：一键脚本安装（新手首选）
Windows 系统安装
- 必须右键开始菜单，选择「Windows PowerShell (管理员)」，非管理员权限会导致安装失败
