第2章 - 环境准备

嗨，朋友！在安装 OpenClaw 之前，我们需要先把 Linux 环境准备好。别担心，这一步很简单！

🤔 需要什么？

在开始之前，确认你有以下东西：

项目	要求	说明
Linux 系统	Ubuntu 20.04+、Debian 11+、CentOS 8+ 等	推荐 Ubuntu 22.04 LTS
Node.js	22 或更高版本	OpenClaw 的运行时环境
内存	至少 1GB	推荐 2GB 以上
磁盘	至少 2GB 可用空间	用于 OpenClaw 和相关数据
网络	能访问外网	需要连接 AI 模型 API

🚀 第一步：更新系统

不管你用什么 Linux 发行版，第一步都是更新系统：

Ubuntu / Debian

sudo apt update && sudo apt upgrade -y

CentOS / RHEL / Fedora

sudo dnf update -y

Arch Linux

sudo pacman -Syu

🟢 第二步：安装 Node.js 22+

OpenClaw 需要 Node.js 22 或更高版本。这是最关键的依赖。

方法一：使用 NodeSource（推荐）

# 下载并执行 NodeSource 安装脚本
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 安装 Node.js
sudo apt install -y nodejs

方法二：使用 nvm（版本管理器）

如果你需要管理多个 Node.js 版本，nvm 是更好的选择：

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# 重新加载 shell 配置
source ~/.bashrc

# 安装 Node.js 22
nvm install 22

# 设置为默认版本
nvm alias default 22

方法三：使用系统包管理器（Arch Linux）

sudo pacman -S nodejs npm

验证安装

安装完成后，验证版本：

node --version
# 预期输出：v22.x.x

npm --version
# 预期输出：10.x.x

注意

如果 node --version 显示的版本低于 22，OpenClaw 将无法正常运行。请确保使用正确的版本。

🔧 第三步：安装常用工具

这些工具不是必须的，但会让后续操作更方便：

# curl - 下载文件和发送请求（大多数系统已预装）
sudo apt install -y curl

# git - 版本控制（如果你想从源码安装）
sudo apt install -y git

# screen 或 tmux - 后台运行程序
sudo apt install -y screen tmux

🔑 第四步：准备 AI 模型 API Key

OpenClaw 需要连接一个 AI 大模型来工作。你需要准备一个 API Key：

模型提供商	推荐度	说明
Anthropic Claude	⭐⭐⭐⭐⭐	官方强烈推荐，特别是 Claude Opus 4.6
OpenAI GPT	⭐⭐⭐⭐	也是很好的选择
本地模型	⭐⭐⭐	需要较强的硬件支持

获取 Anthropic API Key

访问 Anthropic Console
注册账号并登录
在 API Keys 页面创建新的 Key
妥善保存这个 Key，后面配置时会用到

获取 OpenAI API Key

访问 OpenAI Platform
注册账号并登录
在 API Keys 页面创建新的 Key

重要

永远不要把你的 API Key 分享给别人或上传到公开仓库！这就像你的银行密码一样重要。

📋 环境检查清单

在进入下一章之前，确认以下所有项目都已完成：

[ ] Linux 系统已更新到最新
[ ] Node.js 22+ 已安装并验证
[ ] npm 可以正常使用
[ ] curl 已安装
[ ] AI 模型的 API Key 已准备好

快速检查命令：

# 一键检查所有依赖
echo "=== 系统信息 ===" && cat /etc/os-release | head -3
echo "=== Node.js 版本 ===" && node --version
echo "=== npm 版本 ===" && npm --version
echo "=== curl 版本 ===" && curl --version | head -1

💪 练习题

你使用的是哪个 Linux 发行版？版本号是多少？
你安装的 Node.js 版本是多少？
你选择了哪个 AI 模型提供商？

答案提示

运行 cat /etc/os-release 查看
运行 node --version 查看，需要 v22+
推荐 Anthropic Claude，性能最好

下一步: 第3章 - 安装 OpenClaw →