前置准备
环境要求
运行 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


