推荐新手使用一键脚本安装：执行curl -fssl https://openclaw.ai/install.sh | bash自动安装node.js v22+、git及openclaw cli，并运行openclaw onboard --flow quickstart完成配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您在 Linux 系统上尝试安装 OpenClaw，但遇到命令执行失败、环境依赖缺失或服务无法启动等问题，则可能是由于 Node.js 版本不兼容、权限配置不当或网络策略限制所致。以下是适用于主流 Linux 发行版（Ubuntu/Debian、CentOS/RHEL、Arch 等）的多种安装方法：
一、一键脚本安装（推荐新手，自动处理依赖）
该方法通过官方维护的 Bash 脚本自动检测系统环境、安装 Node.js（v22+）、Git 及 OpenClaw CLI，并完成初始化配置，全程无需手动干预。
1、打开终端，确保已联网且具备 sudo 权限。
2、执行以下命令下载并运行安装脚本：
curl -fsSL https://openclaw.ai/install.sh | bash
3、等待脚本自动完成 Node.js 安装、npm 全局安装 openclaw、以及环境变量写入。
4、安装结束后，直接运行配置向导：
openclaw onboard --flow quickstart
二、npm 全局安装（适合已有 Node.js v22+ 环境）
若您已手动安装 Node.js 22.0 或更高版本 LTS 版本，且 npm 可正常工作，则可跳过环境检查，直接通过包管理器安装 CLI 工具，部署更轻量、更新更及时。
1、确认 Node.js 版本满足要求：
node -v
输出应为 v22.x.x 或更高；若低于此版本，请先升级。
2、执行全局安装命令：
sudo npm install -g openclaw@latest
3、验证是否安装成功：
openclaw --version
4、启动交互式配置流程：
openclaw onboard
三、源码构建安装（适合需定制或国内网络受限用户）
该方式绕过 npm registry，直接从国内镜像仓库拉取代码并本地构建，避免因网络波动导致的安装中断，同时支持修改配置、调试日志、启用实验性功能。
1、安装基础构建工具：
sudo apt update && sudo apt install -y git pnpm curl
2、克隆中文优化版仓库（Gitee 镜像，加速下载）：
git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git
3、进入目录并检出稳定分支：
cd openclaw-cn && git checkout v2026.2.2-cn
4、配置 npm 镜像并安装依赖：
pnpm config set registry https://registry.npmmirror.com && pnpm install
5、执行构建与链接：
pnpm build && sudo pnpm link
6、运行配置向导：
openclaw onboard --install-daemon
四、WSL2 内 Ubuntu 子系统安装（仅限 Windows 主机用户）
虽然标题限定为 Linux，但大量 Windows 用户通过 WSL2 运行 Linux 环境部署 OpenClaw。此方式被官方明确标注为“稳定性最佳”，尤其适配 systemd 服务管理、后台常驻及端口转发场景。
1、在 Windows 管理员 PowerShell 中启用 WSL2：
wsl --install
2、重启后启动 Ubuntu，更新系统：
sudo apt update && sudo apt upgrade -y
3、安装 Node.js 22（使用 NodeSource 官方源）：
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash - && sudo apt-get install -y nodejs
4、安装 OpenClaw 并启用后台守护进程：
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
5、配置 systemd 启动项（确保开机自启）：
openclaw configure --section daemon --set enabled=true
