⚙️ 第一步：系统准备与依赖安装
在开始之前，需要确保你的 Ubuntu 系统（建议使用 22.04 或 24.04 LTS 版本）已经准备好必要的工具。
- 打开终端。
安装基础工具链：安装后续步骤中可能用到的 curl、git 等工具。
sudo apt install -y curl wget git build-essential
更新系统包：这是为了避免因系统包过旧而导致的依赖冲突。
sudo apt update && sudo apt upgrade -y
🚀 第二步：选择并执行安装方法
你可以根据自身需求，从以下三种方法中选择一种进行安装。
方法一：一键脚本安装（最推荐）
这是官方推荐的最简单、最省心的方式。脚本会自动处理 Node.js 依赖的检测和安装，并直接启动配置向导。
curl -fsSL https://openclaw.ai/install.sh | bash
执行后，脚本会引导你进入下一步的配置流程。
方法二：Docker 安装（环境隔离）
如果你偏好使用 Docker，或者希望将 OpenClaw 运行在隔离的容器环境中，可以使用此方法。
- 安装 Docker：如果你的系统中尚未安装 Docker 和 Docker Compose，需要先安装。
克隆仓库并运行脚本：
# 创建并进入项目目录
mkdir -p ~/openclaw && cd ~/openclaw
# 克隆官方仓库
git clone https://github.com/openclaw/openclaw.git .
# 运行 Docker 设置脚本
./docker-setup.sh
该脚本会自动构建镜像、生成访问令牌并启动服务。
方法三：npm / pnpm 安装（手动管理）
如果你已经安装了 Node.js 22+，并希望自己管理全局包，可以使用 npm 或 pnpm 进行安装。
- 验证安装：
node --version应显示v22.x.x。
全局安装 OpenClaw：
npm install -g openclaw@latest
安装 Node.js 22+ （如果还未安装）：
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E - bash && sudo apt install -y nodejs
🧭 第三步：初始化配置
安装完成后，你需要通过'新手引导'来完成核心设置，如添加 AI 模型 API 密钥、配置守护进程等。
