Linux下OpenClaw安装教程

1. 支持的Linux发行版

注意： OpenClaw支持主流的Linux发行版，建议选择LTS版本以获得最佳稳定性。

支持的发行版列表：

Ubuntu 18.04+ Debian 10+ CentOS 7+ RHEL 7+ Arch Linux Fedora 30+

发行版	推荐版本	包管理器	安装复杂度
Ubuntu	22.04 LTS / 24.04 LTS	APT (dpkg)	简单
Debian	11 (Bullseye) / 12 (Bookworm)	APT (dpkg)	简单
CentOS	7.9 / 8 Stream	YUM/DNF	中等
RHEL	8 / 9	YUM/DNF	中等
Arch Linux	Latest Rolling	Pacman	较难
Fedora	36+	DNF	中等

检查您的Linux发行版

# 查看发行版信息
cat /etc/os-release

# 查看内核版本
uname -r

# 查看系统架构
uname -m

2. 系统要求

🖥️

处理器

64位 x86_64 或 ARM64

💾

内存

至少 2GB RAM

💿

磁盘空间

至少 500MB 可用

🌐

网络连接

稳定的互联网

权限要求：大多数安装步骤需要sudo权限
依赖库：需要基本的C/C++运行时库
Shell环境：Bash、Zsh等主流Shell

3. 通用安装方法

APT包管理器（Ubuntu/Debian）

方法A：使用官方APT仓库（推荐）

# 1. 添加官方GPG密钥
curl -fsSL https://apt.openclaw.io/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/openclaw.gpg

# 2. 添加APT仓库
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/openclaw.gpg] https://apt.openclaw.io $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/openclaw.list

# 3. 更新软件包列表
sudo apt update

# 4. 安装OpenClaw
sudo apt install openclaw

方法B：下载DEB包手动安装

# 下载对应版本的DEB包
wget https://download.openclaw.io/linux/deb/openclaw_2.1.0_amd64.deb

# 安装DEB包
sudo dpkg -i openclaw_2.1.0_amd64.deb

# 解决可能的依赖问题
sudo apt install -f

YUM/DNF包管理器（RHEL/CentOS/Fedora）

方法A：使用官方YUM仓库

# 1. 添加YUM仓库（CentOS/RHEL）
sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://rpm.openclaw.io/centos/openclaw.repo

# 2. 安装OpenClaw
sudo yum install openclaw

方法B：使用DNF（Fedora）

# 1. 添加DNF仓库
sudo dnf config-manager --add-repo https://rpm.openclaw.io/fedora/openclaw.repo

# 2. 安装OpenClaw
sudo dnf install openclaw

Pacman包管理器（Arch Linux）

# 1. 从AUR安装（推荐）
yay -S openclaw

# 或者使用其他AUR助手
paru -S openclaw

# 2. 手动从AUR安装
git clone https://aur.archlinux.org/openclaw.git
cd openclaw
makepkg -si

Snap包（所有Linux发行版）

# 1. 确保已安装Snap
sudo apt install snapd    # Ubuntu/Debian
sudo yum install snapd    # CentOS/RHEL
sudo dnf install snapd    # Fedora

# 2. 启动Snap服务
sudo systemctl enable --now snapd.socket

# 3. 安装OpenClaw
sudo snap install openclaw --classic

Docker容器安装

# 1. 拉取OpenClaw镜像
docker pull openclaw/openclaw:latest

# 2. 运行临时容器
docker run --rm -it openclaw/openclaw --version

# 3. 运行持久化容器
docker run -d \
  --name openclaw \
  -p 8080:8080 \
  -v /path/to/data:/data \
  openclaw/openclaw:latest

4. 发行版专用安装

Ubuntu专用命令

# Ubuntu 22.04 LTS 专用
sudo add-apt-repository ppa:openclaw/stable
sudo apt update
sudo apt install openclaw

CentOS 7/8专用命令

# CentOS 7
sudo yum install epel-release
sudo yum install openclaw

# CentOS 8
sudo dnf install epel-release
sudo dnf install openclaw

5. 验证安装

# 检查版本
openclaw --version

# 测试帮助命令
openclaw --help

# 检查安装位置
which openclaw
ls -la $(which openclaw)

安装成功！ 如果看到版本号且命令正常工作，说明OpenClaw已成功安装。

6. 常见问题

Q1: 安装后找不到openclaw命令？

A: 可能是PATH环境变量问题，或者需要重新登录：

# 检查是否在PATH中
echo $PATH
which openclaw

# 如果不在PATH中，手动添加
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# 或者重新登录系统
logout
# 然后重新登录

Q2: 依赖包安装失败？

A: 更新系统并安装基础开发工具：

# Ubuntu/Debian
sudo apt update && sudo apt upgrade
sudo apt install build-essential libssl-dev

# CentOS/RHEL
sudo yum update
sudo yum groupinstall "Development Tools"

# 然后重新安装OpenClaw

Q3: 权限不足错误？

A: 确保使用sudo或在root用户下操作：

# 检查当前用户
whoami

# 切换到root或使用sudo
sudo su -
# 或者
sudo command_name

# 如果使用源码编译
sudo make install

Q4: 如何卸载？

A: 根据安装方式选择卸载命令：

# APT安装
sudo apt remove openclaw
sudo apt autoremove

# YUM/DNF安装
sudo yum remove openclaw

# Snap安装
sudo snap remove openclaw

# Docker安装
docker stop openclaw
docker rm openclaw
docker rmi openclaw/openclaw

📋 目录