Chạy OpenClaw trong Docker
Chạy gateway và CLI dưới dạng các dịch vụ Docker Compose, build từ source hoặc tải image dựng sẵn ghcr.io/openclaw/openclaw.
Bạn cần Git và Docker có Compose. Build image cục bộ cần ít nhất 6 GB RAM, vì vậy hãy dùng image dựng sẵn nếu host có ít RAM hơn.
Clone repository và chạy thiết lập
Script thiết lập trong repository chuẩn bị các dịch vụ Compose. Để bỏ qua bước build cục bộ, hãy export OPENCLAW_IMAGE=ghcr.io/openclaw/openclaw:latest trước khi chạy script. Image này cũng được phát hành trên Docker Hub với tên openclaw/openclaw.
shell git clone https://github.com/openclaw/openclaw.git cd openclaw ./scripts/docker/setup.shMở dashboard
Lệnh này chạy container CLI một lần để thực hiện lệnh dashboard; --no-open ngăn container cố mở trình duyệt. Các lệnh CLI khác cũng hoạt động tương tự, chẳng hạn docker compose run --rm openclaw-cli channels add --channel telegram --token "<token>".
shell docker compose run --rm openclaw-cli dashboard --no-openLưu dữ liệu bền vững và chọn cấu hình host
Lưu trạng thái OpenClaw, gồm openclaw.json và workspace của agent, trên named volume hoặc bind mount để dữ liệu tồn tại qua các lần build lại container và cập nhật. Nếu tự build image, hãy dành ít nhất 6 GB RAM; với image dựng sẵn và các model trên cloud, gateway chạy được với 1 GB. Bên trong container, gateway.bind auto sẽ phân giải thành 0.0.0.0, vì vậy hãy bật xác thực bằng token.
Cập nhật container
Pull image mới cho cả dịch vụ gateway và CLI, sau đó chỉ tạo lại gateway. Cấu hình và workspace vẫn được lưu trên volume.
shell docker compose pull openclaw-gateway openclaw-cli docker compose up -d openclaw-gateway
Vì gateway lắng nghe trên 0.0.0.0 bên trong container, ánh xạ cổng như 18789:18789 sẽ công khai cổng đó trên mọi giao diện mạng của host. Thay vào đó, hãy ánh xạ thành 127.0.0.1:18789:18789.