Cài đặt OpenClaw bằng Docker Compose ─ Triển khai AI Agent chỉ với một lệnh

  Apr 5, 2026      2m      0   

 

Hướng dẫn cài đặt OpenClaw AI agent bằng Docker Compose: container hóa hoàn toàn, cài đặt một lệnh duy nhất, hỗ trợ nhiều instance trên cùng máy, backup và restore dễ dàng.

OpenClaw là gì?

OpenClaw là một AI agent mã nguồn mở. Bài viết này hướng dẫn cách triển khai OpenClaw bằng Docker Compose với repository openclaw-minimal-docker-compose.

Tại sao nên dùng Docker Compose?

• Container hóa hoàn toàn — OpenClaw chạy trong container, không ảnh hưởng đến hệ thống máy chủ
• Cài đặt một lệnh duy nhất — chỉ cần một dòng lệnh curl là xong
• Minimal Docker Compose — cấu hình gọn nhẹ, dễ hiểu, dễ tùy chỉnh
• Backup & restore đơn giản — nén thư mục, giải nén và chạy lại
• Nhiều instance trên cùng máy — chạy nhiều OpenClaw agent song song với các port khác nhau

Yêu cầu

Cài đặt Docker và Docker Compose trước khi bắt đầu.

Nếu chưa có curl, chạy sudo apt-get install curl (Debian/Ubuntu) hoặc sudo yum install curl (RHEL/CentOS).

I. Cài đặt nhanh

curl -fsSL https://raw.githubusercontent.com/minhng92/openclaw-minimal-docker-compose/master/run.sh | bash -s -- --destination openclaw-one

Sau khi chạy xong, truy cập http://localhost:18789 với mật khẩu gateway mặc định minhng.info.

Tham số cài đặt

Tham số	Mô tả	Mặc định
--destination	Thư mục cài đặt	(bắt buộc)
--port	Cổng HTTP gateway	18789
--port-ws	Cổng WebSocket gateway	18790
--password	Mật khẩu đăng nhập gateway	minhng.info
--model-provider	Nhà cung cấp model	openai
--model-base-url	Base URL của model provider	https://api.openai.com
--model-api-key	API key (ghi vào agent.env)	—
--model-api-adapter	Adapter API	openai-completions
--model-id	ID của model	gpt-5.4
--telegram-bot-token	Token Telegram bot (ghi vào agent.env)	—

Ví dụ cài đặt

Đặt mật khẩu gateway tùy chỉnh:

curl -fsSL https://raw.githubusercontent.com/minhng92/openclaw-minimal-docker-compose/master/run.sh | bash -s -- --destination openclaw-one --password mySecret123

Đặt mật khẩu + API key:

curl -fsSL https://raw.githubusercontent.com/minhng92/openclaw-minimal-docker-compose/master/run.sh | bash -s -- --destination openclaw-one --password mySecret123 --model-api-key sk-proj-abc123XYZ

Đầy đủ tùy chọn (port + mật khẩu + model + Telegram):

curl -fsSL https://raw.githubusercontent.com/minhng92/openclaw-minimal-docker-compose/master/run.sh | bash -s -- \
  --destination openclaw-one \
  --port 18789 \
  --port-ws 18790 \
  --password mySecret123 \
  --model-api-key sk-proj-abc123XYZ \
  --telegram-bot-token XXX:XXX

Dùng model provider khác (ví dụ DeepSeek):

curl -fsSL https://raw.githubusercontent.com/minhng92/openclaw-minimal-docker-compose/master/run.sh | bash -s -- \
  --destination openclaw-one \
  --model-provider deepseek \
  --model-base-url https://api.deepseek.com \
  --model-api-key sk-abc123XYZ \
  --model-api-adapter openai-completions \
  --model-id deepseek-chat

II. Cài đặt thủ công

git clone git@github.com:minhng92/openclaw-minimal-docker-compose.git
cd openclaw-minimal-docker-compose
# nano agent.env   # thiết lập mật khẩu, model provider, Telegram token, v.v.
docker-compose up -d

File cấu hình

File	Mục đích
.env	Biến môi trường mặc định (theo dõi bởi Git)
agent.env	Override khi deploy — ưu tiên hơn .env, không bị Git track
openclaw.json	Cấu hình gateway & agent (tham khảo)

Đổi mật khẩu gateway bằng cách thiết lập trong agent.env:

OPENCLAW_GATEWAY_PASSWORD=mySecret123

Đổi port bằng cách sửa giá trị phía trước dấu : trong docker-compose.yml:

    ports:
      - "YOUR_HTTP_PORT:18789"
      - "YOUR_WS_PORT:18790"

III. Ghép nối thiết bị (Device Pairing)

Truy cập http://localhost:18789 và đăng nhập bằng mật khẩu gateway (mặc định: minhng.info). Lần đầu kết nối, giao diện sẽ hiển thị pairing required.

Duyệt yêu cầu ghép nối từ terminal:

docker-compose exec openclaw-gateway bash -c 'openclaw devices list'

docker-compose exec openclaw-gateway bash -c 'openclaw devices approve <REQUEST-ID>'

Sau khi duyệt, đăng nhập lại để truy cập Control UI.

Ghép nối Telegram Bot

Yêu cầu: Telegram bot token đã được cấu hình trong .env hoặc agent.env.

Mở chat với bot trên Telegram, bot sẽ trả về một mã ghép nối (pairing code). Duyệt từ terminal:

docker-compose exec openclaw-gateway bash -c 'openclaw pairing approve telegram <PAIRING-CODE>'

IV. Cấp quyền thực thi đầy đủ

Sửa file _data/exec-approvals.json:

{
  "defaults": {
    "security": "full",
    "ask": "off"
  }
}

V. Quản lý Instance

# Áp dụng thay đổi cấu hình
docker-compose down && docker-compose up -d

# Xem log
docker-compose logs --tail 50

# Dừng instance
docker-compose down

# Khởi động lại
docker-compose restart

# Xóa instance hoàn toàn
docker-compose down -v
cd .. && rm -rf <destination-folder>

VI. Chạy nhiều Instance

Chạy thêm instance thứ hai trên cùng máy với port khác:

curl -fsSL https://raw.githubusercontent.com/minhng92/openclaw-minimal-docker-compose/master/run.sh | bash -s -- --destination openclaw-two --port 18889 --port-ws 18890

Mỗi instance hoạt động độc lập với thư mục và port riêng.

VII. Backup & Restore

Backup:

sudo zip -r openclaw-minimal.zip openclaw-minimal

Restore:

sudo unzip openclaw-minimal.zip
cd openclaw-minimal
docker-compose up -d

Toàn bộ dữ liệu nằm trong thư mục cài đặt, nên chỉ cần nén và giải nén là xong.

Tài liệu tham khảo

• Repository: minhng92/openclaw-minimal-docker-compose
• OpenClaw Official: openclaw.ai
• OpenClaw Docs: docs.openclaw.ai

---

Star repository minhng92/openclaw-minimal-docker-compose nếu bạn thấy hữu ích nhé!

Minh Nguyen

Share this:

      

• #openclaw
• #ubuntu
• #docker-compose
• #docker