前置准备
环境要求
运行 OpenClaw 对硬件没有苛刻要求，普通办公电脑即可满足。
- CPU：2 核及以上（Intel i3/i5、AMD Ryzen 3/5）
- 内存：4G 起步，建议 8G 以应对多任务
- 存储：SSD 剩余空间 10G 以上，用于镜像和配置
- 网络：需正常联网，国内镜像源已适配
软件依赖
- 操作系统：Windows 10+ / macOS 12+ / Linux（Ubuntu 22.04 推荐，Windows 建议使用 WSL2）
- 核心工具：Docker ≥ 24.0 + Docker Compose ≥ 2.20、Git ≥ 2.40
- 可选凭证：大模型 API-Key（如阿里云百炼/Kimi，本地部署可省略）
- 浏览器：Chrome 或 Edge 最新版
国内镜像源配置
为避免拉取镜像超时，建议提前配置国内加速源。
# 配置 Docker 镜像源（适用于 Windows/macOS/Linux）
mkdir -p /etc/docker
cat > /etc/docker/daemon.json << EOF
{
"registry-mirrors": ["https://docker.mirrors.ustc.edu.cn", "https://hub-mirror.c.163.com"]
}
EOF
systemctl daemon-reload && systemctl restart docker
# 配置 Git 镜像加速
git config --global url."https://ghproxy.com/https://github.com/".insteadOf "https://github.com/"
核心部署方案
方案一：Docker 本地部署（推荐）
这种方式数据完全私有化，适合本地开发或内网使用。
1. 安装基础工具
如果系统未安装 Docker 或 Git，请执行以下脚本。已安装则跳过。
# 一键安装 Docker（内置国内源）
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
# 安装 Git
sudo apt install git -y
2. 拉取源码与构建镜像
克隆项目并构建本地镜像，这一步通常耗时几分钟。
# 克隆仓库
git clone https://ghproxy.com/https://github.com/OpenClawChinese/OpenClaw.git
cd OpenClaw
# 构建镜像
docker build -t openclaw:latest .
# 创建持久化卷，防止配置丢失
docker volume create openclaw-data
