feat: merge readme + add --allow-unconfigured flag to gateway and configure openclaw-cli to build from source [test]

README.md

@@ -24,13 +24,20 @@ Cả hai container dùng chung một image `openclaw-clawteam:latest` được b
 - **Docker Compose** >= v2.x (`docker compose` — không phải `docker-compose`)
 - Quyền truy cập vào Git repository nội bộ
 
-### 2. Clone dự án
+### 2. Tải Mã nguồn (Clone Repository)
+Mở Terminal của bạn và thực hiện kéo mã nguồn mới nhất từ kho lưu trữ của công ty về máy cục bộ.
 
+Tải toàn bộ dự án về máy:
+```bash
+git clone [https://git.smartgift.io.vn/smartgift/open-claw-team.git](https://git.smartgift.io.vn/smartgift/open-claw-team.git)
+```
+
+Di chuyển vào thư mục dự án vừa tải:
 ```bash
-git clone https://git.smartgift.io.vn/smartgift/open-claw-team.git open-claw-team
 cd open-claw-team
 ```
 
+
 ### 3. Cấu hình biến môi trường
 
 Mở và chỉnh sửa file `.env`:
@@ -60,22 +67,39 @@ Các biến quan trọng cần chú ý:
 
 ## 🐳 Hướng dẫn Sử dụng Docker
 
+Sau khi mã nguồn đã sẵn sàng, chúng ta sẽ tiến hành build docker và chạy nền các Container. Lệnh này sẽ kéo `node:24-slim` về, cài đặt tự động OpenClaw, ClawTeam và Superpowers.
+
 ### Build & Khởi động
 
 ```bash
 # Lần đầu: build image và start toàn bộ stack
 docker compose up -d --build
+```
 
+```bash
 # Các lần sau (đã có image): start nhanh
 docker compose up -d
 ```
 
+**Giải thích cờ (flags):**
+* `-d` (detached): Chạy ngầm trong background để không chiếm dụng Terminal của bạn.
+* `--build`: Ép hệ thống đóng gói lại kiến trúc mới nhất từ Dockerfile thay vì dùng cache cũ.
+
+Quá trình này có thể mất vài phút. Để kiểm tra xem hệ thống đã lên ổn định chưa, hãy gõ:
+```bash
+docker ps
+```
+
+Nếu bạn thấy cả 2 container `openclaw-gateway` và `openclaw-cli` đều hiển thị trạng thái **Up**, hệ thống đã chạy thành công!
+
 ### Xem logs
 
 ```bash
 # Log riêng Gateway
 docker compose logs -f openclaw-gateway
+```
 
+```bash
 # Log riêng CLI (thường ít output)
 docker compose logs -f openclaw-cli
 ```
@@ -103,7 +127,25 @@ docker compose exec openclaw-cli openclaw --version
 | `./.openclaw` | `/home/node/.openclaw` | Config, credentials OpenClaw |
 | `./.openclaw/workspace` | `/home/node/.openclaw/workspace` | Workspace làm việc của agents |
 
-> Thư mục `.openclaw/` được tạo tự động khi gateway khởi động lần đầu. Tất cả cấu hình (token, origins, …) lưu tại đây và **persist qua các lần restart**.
+> Thư mục `.openclaw/` được tạo tự động khi gateway khởi động lần đầu. Tất cả cấu hình (token, origins, …) lưu tại đây và **persist qua các lần restart**.Nói cách khác, thư mục `.openclaw` chính là "bộ não" chứa dữ liệu của hệ thống. Để AI có thể hoạt động, bạn cần cấp "chìa khóa" (API Keys). Có 2 cách để thực hiện:
+
+**Cách 1: Cấu hình qua Giao diện Web (Khuyên dùng)**
+Truy cập trực tiếp vào Terminal hệ thống `cli` (đây là nơi được tạo ra để kỹ sư có thể thao tác tương tác):
+```bash
+docker exec -it openclaw-team-repo-openclaw-cli-1 bash
+```
+Sau đó, trong container hãy thực thi lệnh thiết lập:
+```bash
+openclaw setup
+```
+
+**Cách 2: Cấu hình qua Terminal (bằng container CLI)**
+Hệ thống Gateway mặc định có sẵn thiết lập khởi chạy không cần config, bạn có thể thiết lập trực tiếp trên web bằng cách:
+* Mở trình duyệt và truy cập `http://localhost:18789` (Hoặc địa chỉ IP máy chủ của bạn với cổng `18789`).
+Tại giao diện Web, hệ thống sẽ tự động hiển thị Wizard Setup để bạn điền các API Key (OpenAI, Anthropic, Gemini...). Các thông tin này sẽ được lưu ngầm tự động xuống thư mục `.openclaw`.
+
+> **Cảnh báo:** Mọi tệp cấu hình bảo mật sẽ nằm ở thư mục `.openclaw` trên máy tính tải về. Thư mục này đã có trong `.gitignore`. Tuyệt đối KHÔNG sử dụng lệnh ép buộc (force add) để đẩy các tệp thuộc `.openclaw` lên Github nhằm tránh rò rỉ thông tin bảo mật.
+
 
 ---
 

docker-compose.yml

@@ -36,7 +36,8 @@ services:
         "--bind",
         "${OPENCLAW_GATEWAY_BIND:-lan}",
         "--port",
-        "18789"
+        "18789",
+        "--allow-unconfigured"
       ]
     healthcheck:
       test:
@@ -52,7 +53,11 @@ services:
       start_period: 20s
 
   openclaw-cli:
+    build:
+      context: .
+      dockerfile: ./Dockerfile
     image: openclaw-clawteam:latest
+    pull_policy: build
     network_mode: "service:openclaw-gateway"
     deploy:
       resources: