Docker 安装 OpenClaw 最简指南
# Docker 安装 OpenClaw 最简指南
使用 Docker 快速部署 OpenClaw，无需手动配置环境
前置要求
- Docker 20.10+
- Docker Compose v2+
- 4GB+ RAM
快速开始
方法一：使用 Docker Compose (推荐)
bash
# 创建工作目录
mkdir -p ~/openclaw
cd ~/openclaw
# 创建 docker-compose.yml
cat > docker-compose.yml << 'EOF'
version: '3.8'
services:
openclaw:
image: openclaw/openclaw:latest
ports:
- "3000:3000"
environment:
- DATABASE_URL=postgresql://postgres:postgres@db:5432/openclaw
- JWT_SECRET=your-secret-key-change-me
- AI_PROVIDER=openai
- OPENAI_API_KEY=${OPENAI_API_KEY}
depends_on:
- db
restart: unless-stopped
db:
image: postgres:14-alpine
environment:
- POSTGRES_USER=postgres
- POSTGRES_PASSWORD=postgres
- POSTGRES_DB=openclaw
volumes:
- postgres_data:/var/lib/postgresql/data
restart: unless-stopped
volumes:
postgres_data:
EOF
# 启动服务
OPENAI_API_KEY=sk-your-key docker-compose up -d方法二：手动运行
bash
# 启动 PostgreSQL
docker run -d \
--name openclaw-db \
-e POSTGRES_PASSWORD=postgres \
-e POSTGRES_DB=openclaw \
-v postgres_data:/var/lib/postgresql/data \
postgres:14-alpine
# 启动 OpenClaw
docker run -d \
--name openclaw \
-p 3000:3000 \
-e DATABASE_URL=postgresql://postgres:postgres@host.docker.internal:5432/openclaw \
-e JWT_SECRET=secret \
-e OPENAI_API_KEY=sk-your-key \
openclaw/openclaw:latest
# 注意：Linux 上使用 --network=host 代替端口映射验证安装
bash
# 查看日志
docker-compose logs -f openclaw
# 检查状态
docker-compose ps访问 http://localhost:3000
数据持久化
所有数据存储在 Docker 卷中：
bash
# 查看卷
docker volume ls | grep openclaw
# 备份
docker run --rm -v openclaw_postgres_data:/data -v $(pwd):/backup alpine tar czf /backup/backup.tar.gz /data更新版本
bash
docker-compose pull
docker-compose up -d生产环境建议
- 1.使用 Nginx 反向代理
- 2.启用 HTTPS
- 3.定期备份数据
- 4.设置资源限制
yaml
# docker-compose.production.yml
services:
openclaw:
deploy:
resources:
limits:
cpus: '1'
memory: 1G常见问题
数据库连接失败
确保 PostgreSQL 容器先启动完成：
bash
docker-compose up -d db
sleep 10
docker-compose up -d openclawWindows 文件权限
在 Windows 上可能需要设置卷的读写权限。
---
相关教程：
- [Ubuntu 安装](/post/install-openclaw-ubuntu)
- [CentOS 安装](/post/install-openclaw-centos)