2.1 安装 OpenClaw 前的准备工作
通过本文你将全面了解安装 OpenClaw 前的准备工作的核心概念、实际应用方法和最佳实践。
概述
一、安装前检查清单
在开始安装之前，先确认以下几点：
□ 电脑系统符合要求
□ 网络连接正常
□ 拥有 AI 模型 API Key
□ 准备好飞书/钉钉等渠道的机器人配置（如果需要接入）
□ 有权限安装软件（Windows 需要管理员或 WSL2）
二、系统要求
Windows 系统
| 项目 | 要求 | 说明 |
|---|---|---|
| 操作系统 | Windows 10/11 | 推荐 Windows 11 |
| WSL2 | 需要安装 | Linux 子系统，OpenClaw 运行在其上 |
| 内存 | 建议 8GB+ | 4GB 也能跑，但多任务可能卡 |
| 硬盘 | 建议 10GB+ 可用空间 | 用于安装 Node.js 和 OpenClaw |
| 管理员权限 | 部分需要 | 安装 WSL2 和全局 npm 包时需要 |
macOS 系统
| 项目 | 要求 | 说明 |
|---|---|---|
| 操作系统 | macOS 12 Monterey 或更高 | 推荐最新版本 |
| 内存 | 建议 8GB+ | |
| 硬盘 | 建议 10GB+ 可用空间 | |
| Homebrew | 推荐安装 | 方便安装 Node.js |
Linux 系统
| 项目 | 要求 | 说明 |
|---|---|---|
| 发行版 | Ubuntu 20.04 / 22.04 / 24.04 或等价发行版 | |
| 内存 | 建议 8GB+ | |
| Node.js | 需要预装 | 见下文 |
三、需要提前安装的软件
3.1 Node.js（必须）
OpenClaw 是基于 Node.js 构建的，必须安装 Node.js。
推荐安装 Node.js 22 LTS 或更高版本
| 系统 | 安装方式 | |
|---|---|---|
| Windows | 通过 WSL2 安装 Ubuntu，然后安装 Node.js | |
| macOS | Homebrew：brew install node@22 | |
| Linux | curl -fsSL https://deb.nodesource.com/setup_22.x \ | sudo -E bash - && sudo apt-get install -y nodejs |
node --version
npm --version
3.2 WSL2（Windows 用户必须）
Windows 用户需要安装 WSL2（Windows Subsystem for Linux 2），因为 OpenClaw 主要在 Linux 环境下运行。
安装步骤：
1. 以管理员身份打开 PowerShell 或命令提示符 2. 运行以下命令：
wsl --install -d Ubuntu
验证 WSL2 安装： 打开 PowerShell，输入：
wsl --list --verbose
3.3 npm（通常随 Node.js 一起安装）
npm 是 Node.js 的包管理器，通常和 Node.js 一起安装。
验证：
npm --version
四、准备 AI 模型 API Key
OpenClaw 需要连接 AI 模型才能工作，你需要提前准备好：
推荐的模型服务商
| 服务商 | 特点 | 适合场景 |
|---|---|---|
| MiniMax | 中文支持好，速度快，性价比高 | 中文对话、企业场景 |
| DeepSeek | 推理能力强，价格便宜 | 代码、深度分析 |
| 阿里云百炼 | 国内合规，模型多样 | 企业使用 |
获取 API Key 的通用步骤
1. 访问对应平台官网（如 https://platform.minimaxi.com） 2. 注册账号并完成认证 3. 进入控制台，找到"API Key"或"接口密钥"页面 4. 创建一个新的 API Key 5. 妥善保存 Key，不要泄露给陌生人
⚠️ 重要提醒：API Key 等同于账号密码，泄露后他人可免费使用你的额度。
五、准备飞书/钉钉机器人（如需接入）
如果你想让 AI 在飞书或钉钉里响应消息，需要提前创建好机器人：
飞书机器人创建步骤（第二章第五节详细说明）
简要步骤： 1. 进入飞书开放平台 2. 创建一个企业自建应用 3. 获取 App ID 和 App Secret 4. 添加机器人能力 5. 配置权限和事件订阅
钉钉机器人创建步骤（第二章第六节详细说明）
简要步骤： 1. 进入钉钉开发者平台 2. 创建钉钉应用 3. 获取 App Key 和 App Secret 4. 添加机器人能力 5. 配置消息接收模式
如果只是想先体验功能，可以暂时不配置渠道，OpenClaw 自带一个网页控制台，可以直接在里面对话。
六、网络环境确认
| 检查项 | 说明 |
|---|---|
| 能访问外网 | OpenClaw 需要访问 AI 服务商的 API |
| 目标地址 | 确保能访问 api.minimaxi.com、api.deepseek.com 等 |
| 代理设置 | 如果需要代理，在环境变量中配置 |
curl -I https://api.minimaxi.com
七、准备一个工作目录
建议为 OpenClaw 准备一个专门的工作目录：
| 系统 | 建议路径 |
|---|---|
| Windows (WSL2) | /home/你的用户名/openclaw-work/ |
| macOS | ~/openclaw-work/ |
| Linux | ~/openclaw-work/ |
mkdir -p ~/openclaw-work
八、开始安装前最后确认
✅ Node.js 已安装（版本 ≥ 22）
✅ npm 已安装
✅ （Windows）WSL2 已安装并运行
✅ 拥有 AI 模型 API Key
✅ 飞书/钉钉机器人已创建（如果需要）
✅ 网络可以访问 AI 服务商
✅ 有一个工作目录
全部打勾后，就可以开始安装了！
九、下一步
- 2.2 Windows 系统安装教程（WSL2 环境） → 详细图文步骤
- 2.3 macOS 系统安装教程 → 详细图文步骤
如有疑问，欢迎在群内提问！