create-openclaw-bot 5.7.9 → 5.8.0

package/README.vi.md

@@ -1,315 +1,164 @@
-<div align="center">
-
-# 🦞 OpenClaw Setup
-
-<p align="center">
-  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.7.9-0EA5E9?style=for-the-badge" alt="Version 5.7.9" /></a>
-  <a href="https://github.com/tuanminhhole/openclaw-setup?tab=MIT-1-ov-file"><img src="https://img.shields.io/badge/LICENSE-MIT-success?style=for-the-badge" alt="MIT License" /></a>
-  <a href="https://www.npmjs.com/package/create-openclaw-bot"><img src="https://img.shields.io/npm/v/create-openclaw-bot?style=for-the-badge&label=CLI&color=2563EB&logo=npm&logoColor=white" alt="NPM Version" /></a>
-  <a href="https://github.com/tuanminhhole/openclaw-setup/stargazers"><img src="https://img.shields.io/github/stars/tuanminhhole/openclaw-setup?style=for-the-badge&color=eab308&logo=github&logoColor=white" alt="GitHub Stars" /></a>
-</p>
-
-<p style="margin-top: 16px;">
-  <img src="https://flagcdn.com/24x18/vn.png" alt="Tiếng Việt" width="24" height="18" style="vertical-align: sub;"> <strong>Tiếng Việt</strong> ·
-  <img src="https://flagcdn.com/24x18/gb.png" alt="English" width="24" height="18" style="vertical-align: sub;"> <a href="README.md">English</a>
-</p>
-
-Công cụ **CLI tương tác** và **Setup Wizard** để tự triển khai Bot AI miễn phí trên Telegram hoặc Zalo chỉ trong vài phút — hỗ trợ **Windows, macOS, Ubuntu, VPS**.
-
-<a href="https://github.com/tuanminhhole/openclaw-setup">
-  <img src="https://raw.githubusercontent.com/tuanminhhole/openclaw-setup/main/docs/preview.png" alt="OpenClaw Setup Hero Image" width="100%" style="border-radius: 8px; margin: 16px 0; border: 1px solid #333;" />
-</a>
-
-</div>
-
----
-
-## 🆕 Có gì mới trong v5.7.9
-
-- 🔧 **Cập nhật tham chiếu Plugin Zalo** — Đổi tên `zalo-mod` thành `openclaw-zalo-mod` trong các chuỗi sinh cấu hình và test để đồng bộ với package mới.
-
-<details>
-<summary><b>Trước đó: Có gì mới ở v5.7.8</b></summary>
-
-- 🧹 **Dọn dẹp Plugin Zalo Mod** — Gỡ bỏ auto-inject `zalo-mod` khỏi config được generate. Plugin giờ phải cài thủ công qua ClawHub, loại bỏ vòng lặp cài đặt liên tục và xung đột quyền trong Docker.
-- 🔧 **Docker Build Sạch Hơn** — `openclaw-zalo-mod` không còn được nhúng vào Docker image khi build hoặc trong entrypoint runtime, giảm kích thước image và lỗi khởi động.
-- 📝 **Chuẩn Hóa Workflow Release** — Thêm `.agent/workflows/update.md` làm checklist release chuẩn cho repo này.
-
-## </details>
-
-## ✨ Tính năng
-
-- 🤖 **Đa kênh** — Telegram (1 bot hoặc nhiều bot), Zalo Bot API, hoặc Zalo Cá nhân
-- 🧑‍🤝‍🧑 **Đội bot** — Chạy tối đa 5 Telegram bot đồng thời. Các bot dùng chung workspace, phối hợp xử lý tác vụ và điều phối với nhau trong group chat theo Chế độ Phòng Ban
-- 🧠 **Đa provider AI** — Google Gemini, Claude, GPT-4o, OpenRouter, Ollama (local), 9Router
-- 🧩 **Skills** — Web Search, Browser Automation, Memory, RAG, Code Interpreter, Image Gen
-- 🔌 **Plugins** — Voice Call, Matrix, MS Teams, Nostr
-- 🔀 **9Router** — AI proxy miễn phí với đăng nhập OAuth. Không cần API key. Hỗ trợ Claude Code, Codex, Gemini CLI.
-- 🧙 **Setup Wizard** — 5 bước trực quan trên trình duyệt (`index.html`). Không cần terminal.
-- 💻 **CLI tương tác** — `npx create-openclaw-bot` — phù hợp cho Ubuntu, VPS, kỹ sư.
-- 🆓 **Miễn phí hoàn toàn để bắt đầu** — 9Router + Gemini free tier không tốn đồng nào
-- 🔒 **Riêng tư** — API key chỉ lưu trên máy bạn, không gửi đi đâu
-- ⚡ **Nhanh** — Từ zero đến bot chạy được trong dưới 5 phút
-
----
-
-## 🗺️ Chọn cách triển khai
-
-> **Không biết nên dùng cách nào?** Bảng dưới đây sẽ giúp bạn:
-
-| Bạn là ai                  | Môi trường      | Cách được đề xuất                     |
-| -------------------------- | --------------- | ------------------------------------- |
-| Không quen terminal        | Windows / macOS | **Web Wizard** (`index.html`)         |
-| Không quen terminal        | Ubuntu Desktop  | **Web Wizard** → chọn Native          |
-| Quen terminal              | Ubuntu / VPS    | **CLI** (`npx create-openclaw-bot`)   |
-| Muốn tự động hóa hoàn toàn | Bất kỳ          | **AI Agent** (Antigravity + SETUP.md) |
-
-### 1️⃣ Tùy chọn A — Web Wizard (không cần terminal)
-
-Phù hợp nhất cho **Windows và macOS**. Không cần dòng lệnh.
-
-1. [Tải ZIP](https://github.com/tuanminhhole/openclaw-setup/archive/refs/heads/main.zip) hoặc clone repo này.
-2. Mở `index.html` trong trình duyệt.
-3. Làm theo **wizard 5 bước**:
-   - **Bước 1:** Chọn OS (Windows / macOS / Ubuntu / VPS)
-   - **Bước 2:** Chọn kênh bot (Telegram / Zalo)
-   - **Bước 3:** Chọn AI provider và model
-   - **Bước 4:** Nhập bot token và cấu hình
-   - **Bước 5:** Tải script và chạy — xong!
-4. Script tải về sẽ tự cài đặt mọi thứ cần thiết (9Router, Ollama, Docker, v.v.) dựa trên lựa chọn của bạn.
-
-> **Docker hay không Docker?**
->
-> - **Windows / macOS** → Dùng **Docker** (cô lập hoàn toàn, dễ quản lý)
-> - **Ubuntu / VPS** → Dùng **Native (không Docker)** (ít RAM hơn, ổn định hơn)
-
-### 2️⃣ Tùy chọn B — CLI tương tác (`npx`)
-
-Phù hợp nhất cho **kỹ sư, Ubuntu Desktop, VPS**. Nhanh và mạnh nhất.
-
-```bash
-npx create-openclaw-bot
-```
-
-Chạy trong terminal → làm theo hướng dẫn → script khởi động được tạo tự động.
-
-> Yêu cầu: **Node.js 20/22/24**. Kiểm tra: `node -v`
->
-> Lưu ý: **tránh Node.js 25 hiện tại**. Có báo cáo OpenClaw gặp lỗi trên Node 25.
-
-<details>
-<summary><b>3️⃣ Tùy chọn C — AI Agent (Antigravity)</b></summary>
-<br>
-
-1. Mở [Antigravity IDE](https://antigravity.dev/)
-2. Mở repo này làm workspace
-3. Paste vào chat:
-   ```
-   Đọc SETUP.md và cài đặt OpenClaw v5.5.0 cho tôi.
-   Bot token của tôi là X. Dùng 9Router (không cần API key).
-   Thư mục project: <ĐƯỜNG_DẪN_CỦA_BẠN>
-   ```
-
-</details>
-
----
-
-## 📋 Yêu cầu
-
-### Không dùng Docker (Native — khuyến nghị cho Ubuntu/VPS)
-
-| Yêu cầu                 | Ghi chú                                                                   |
-| ----------------------- | ------------------------------------------------------------------------- |
-| **Node.js 20/22/24**    | [Tải](https://nodejs.org/) · Kiểm tra: `node -v` · Tránh Node 25 hiện tại |
-| **AI provider**         | 9Router (miễn phí) hoặc Gemini/Claude/GPT-4o                              |
-| **Bot Token**           | Từ Telegram BotFather hoặc Zalo Developer                                 |
-| **Ollama** _(tùy chọn)_ | Chỉ cần nếu muốn chạy Gemma 4 locally · [Tải](https://ollama.com/)        |
-
-### Dùng Docker (khuyến nghị cho Windows/macOS)
-
-| Yêu cầu                         | Ghi chú                                                                                     |
-| ------------------------------- | ------------------------------------------------------------------------------------------- |
-| **Node.js 20/22/24**            | [Tải](https://nodejs.org/) · Kiểm tra: `node -v` · Tránh Node 25 hiện tại                   |
-| **Docker Desktop + Compose V2** | [Tải](https://www.docker.com/products/docker-desktop/) · Kiểm tra: `docker compose version` |
-| **AI provider**                 | 9Router chạy như container sidecar — không cần cài riêng                                    |
-| **Bot Token**                   | Từ Telegram BotFather hoặc Zalo Developer                                                   |
-
----
-
-## 🧠 Các Provider AI được hỗ trợ
-
-| Provider             | Chi phí       | API Key  | Ghi chú                                                                                   |
-| -------------------- | ------------- | -------- | ----------------------------------------------------------------------------------------- |
-| **9Router**          | 🆓 Miễn phí   | ❌ OAuth | Khuyến nghị cho người mới. Tự route đến model tốt nhất. Hỗ trợ Claude CLI, Codex, Gemini. |
-| **Google Gemini**    | 🆓 Free tier  | ✅ Có    | Chất lượng cao. Free tier rất rộng rãi.                                                   |
-| **Ollama / Gemma 4** | 🏠 Miễn phí   | ❌ Không | Chạy 100% offline. Tự pull model khi khởi động lần đầu.                                   |
-| **Anthropic Claude** | 💰 Trả phí    | ✅ Có    | Chất lượng suy luận và viết tốt nhất.                                                     |
-| **OpenAI / Codex**   | 💰 Trả phí    | ✅ Có    | GPT-4o, Codex Mini.                                                                       |
-| **OpenRouter**       | 🆓/💰 Hỗn hợp | ✅ Có    | Nhiều model chung một key. Một số miễn phí.                                               |
-
-> 🔀 **9Router v0.3.75+** hỗ trợ passthrough cho Claude Code, Codex, Gemini CLI, và Antigravity. Xem [docs/ai-providers.md](docs/ai-providers.md) để biết chi tiết.
-
----
-
-## 🔌 Các kênh được hỗ trợ
-
-- **Telegram** (✅ Chính thức) — Tìm **@BotFather** → `/newbot` → Copy token.
-- **Zalo Bot API** (✅ Chính thức) — Vào [developers.zalo.me](https://developers.zalo.me) → Tạo bot → Copy token.
-- **Zalo Cá nhân** (⚠️ Không chính thức) — Quét QR sau khi cài (không cần token). Dùng tài khoản phụ.
-
-> ⚠️ **Zalo Cá nhân** dùng API không chính thức. Tài khoản có thể bị hạn chế. Chỉ dùng tài khoản phụ.
-
----
-
-## 📁 Cấu trúc Repo
-
-```
-index.html           ← Wizard UI (mở trên trình duyệt)
-style.css            ← Giao diện Wizard
-setup.js             ← Logic Wizard
-cli.js               ← CLI tương tác (npx create-openclaw-bot)
-CHANGELOG.md/.vi.md  ← Lịch sử phiên bản
-README.md            ← Tiếng Anh
-README.vi.md         ← Bạn đang đọc (Tiếng Việt)
-SETUP.md/.vi.md      ← Hướng dẫn kỹ thuật cho AI Agent
-docs/
-  install-docker.md/.vi.md     ← Cài Docker theo OS
-  install-native.md/.vi.md     ← Cài Native/PM2 theo OS
-  ai-providers.md/.vi.md       ← Cấu hình AI provider
-  hardware-guide.md/.vi.md     ← Yêu cầu RAM cho Ollama/Gemma 4
-  faq.md/.vi.md                ← Câu hỏi thường gặp
-```
-
-> **Lưu ý:** Script khởi động (`.bat`, `.sh`) **không có trong repo** — chúng được tạo bởi Web Wizard hoặc CLI dựa trên cấu hình của bạn.
-
----
-
-## ❓ Câu hỏi thường gặp
-
-<details>
-<summary><b>Có thực sự miễn phí không?</b></summary>
-
-Có. Docker, Google Gemini API (free tier), và token bot Telegram/Zalo đều miễn phí. Bạn chỉ trả tiền nếu chọn AI provider trả phí như Claude hoặc GPT-4o.
-
-</details>
-
-<details>
-<summary><b>Bot chạy ở đâu?</b></summary>
-
-Trên máy tính hoặc server của bạn. Với Docker thì chạy trong container; với Native thì chạy như tiến trình PM2. Nếu máy tắt thì bot cũng tắt. Dùng VPS để bot chạy 24/7.
-
-</details>
-
-<details>
-<summary><b>Tôi có cần Docker không?</b></summary>
-
-Không bắt buộc. Docker chỉ là một tùy chọn. Người dùng Windows/macOS nên dùng Docker để cô lập sạch sẽ. Người dùng Ubuntu/VPS nên cài native với PM2 — ít tốn RAM hơn và OpenClaw đã bảo mật sẵn.
-
-</details>
-
-<details>
-<summary><b>Làm sao dừng/khởi động lại bot?</b></summary>
-
-**Docker:**
-
-```bash
-docker compose down      # Dừng
-docker compose up -d     # Chạy
-docker compose restart   # Khởi động lại
-```
-
-**PM2 (native):**
-
-```bash
-pm2 stop openclaw-bot
-pm2 start openclaw-bot
-pm2 restart openclaw-bot
-```
-
-</details>
-
-<details>
-<summary><b>Tôi có thể đổi AI model sau không?</b></summary>
-
-Có. Chạy lại `npx create-openclaw-bot` trong thư mục bot, hoặc sửa trực tiếp `.openclaw/openclaw.json` và restart bot.
-
-</details>
-
-<details>
-<summary><b>Có an toàn không?</b></summary>
-
-API key của bạn chỉ được lưu trên máy trong file `.env` cục bộ. OpenClaw không gửi chúng đi đâu. Khi dùng Ollama, toàn bộ AI chạy hoàn toàn offline.
-
-</details>
-
-<details>
-<summary><b>9Router là gì?</b></summary>
-
-9Router là AI proxy mã nguồn mở. Thay vì quản lý API key từ nhiều provider, bạn đăng nhập một lần qua OAuth tại `localhost:20128/dashboard`. Nó tự route request đến model AI tốt nhất hiện có. Từ v0.3.75, hỗ trợ passthrough cho Claude Code, Codex, Gemini CLI, và Antigravity.
-
-</details>
-
-<details>
-<summary><b>Skills và Plugins khác nhau thế nào?</b></summary>
-
-**Skills** thêm khả năng cho agent (Web Search, Browser Automation, Memory, RAG, Code Interpreter...) — cài qua `openclaw skills install` từ ClawHub.
-
-**Plugins** thêm kênh hoặc extension runtime (Voice Call, Matrix, MS Teams...) — cài qua `openclaw plugins install` từ npm.
-
-</details>
-
-<details>
-<summary><b>Cần bao nhiêu RAM cho Gemma 4?</b></summary>
-
-| Model        | RAM tối thiểu (Native) | RAM tối thiểu (Docker) |
-| ------------ | ---------------------- | ---------------------- |
-| `gemma4:e2b` | ~4 GB                  | ~5 GB                  |
-| `gemma4:e4b` | ~8 GB                  | ~9 GB                  |
-| `gemma4:26b` | ~18 GB                 | ~20 GB                 |
-| `gemma4:31b` | ~24 GB                 | ~26 GB                 |
-
-Xem [docs/hardware-guide.md](docs/hardware-guide.md) để biết thêm chi tiết kể cả cách cấu hình swap cho VPS.
-
-</details>
-
----
-
-## 🔗 Liên kết
-
-- [OpenClaw Docs](https://openclaw.ai/docs)
-- [9Router](https://github.com/decolua/9router)
-- [Google AI Studio](https://aistudio.google.com/)
-- [Telegram BotFather](https://t.me/BotFather)
-- [Zalo Developer Platform](https://developers.zalo.me)
-- [Docker Desktop](https://www.docker.com/products/docker-desktop/)
-- [Ollama](https://ollama.com)
-- [OpenRouter](https://openrouter.ai)
-- [ClawHub (Skills)](https://clawhub.com)
-
----
-
-## 📈 Star History
-
-<div align="center">
-
-[![Star History Chart](https://starchart.cc/tuanminhhole/openclaw-setup.svg?variant=adaptive)](https://starchart.cc/tuanminhhole/openclaw-setup)
-
-</div>
-
----
-
-## 🙏 Lời cảm ơn
-
-- [OpenClaw](https://openclaw.ai) — AI Gateway framework
-- [9Router](https://github.com/decolua/9router) — Open-source AI proxy (OAuth-based, no API keys)
-- [Playwright](https://playwright.dev) — Browser automation engine
-- [ClawHub](https://clawhub.com) — Skills registry
-- [TheSVG](https://thesvg.org) — High-quality SVG brand icons
-
----
-
-<div align="center">
-
-Made with 🦞 by [Kent](https://github.com/tuanminhhole)
-
-</div>
+<div align="center">
+
+# 🦞 OpenClaw Setup
+
+<p align="center">
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.8.0-0EA5E9?style=for-the-badge" alt="Version 5.8.0" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup?tab=MIT-1-ov-file"><img src="https://img.shields.io/badge/LICENSE-MIT-success?style=for-the-badge" alt="MIT License" /></a>
+  <a href="https://www.npmjs.com/package/create-openclaw-bot"><img src="https://img.shields.io/npm/v/create-openclaw-bot?style=for-the-badge&label=CLI&color=2563EB&logo=npm&logoColor=white" alt="NPM Version" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/stargazers"><img src="https://img.shields.io/github/stars/tuanminhhole/openclaw-setup?style=for-the-badge&color=eab308&logo=github&logoColor=white" alt="GitHub Stars" /></a>
+</p>
+
+<p style="margin-top: 16px;">
+  <img src="https://flagcdn.com/24x18/vn.png" alt="Tiếng Việt" width="24" height="18" style="vertical-align: sub;"> <strong>Tiếng Việt</strong> ·
+  <img src="https://flagcdn.com/24x18/gb.png" alt="English" width="24" height="18" style="vertical-align: sub;"> <a href="README.md">English</a>
+</p>
+
+Trình cài đặt và quản trị **Web UI Setup** thế hệ mới giúp tự động hóa 100% quá trình tạo dự án, triển khai và quản lý đa bot AI miễn phí trên Telegram hoặc Zalo — hỗ trợ **Windows, macOS, Ubuntu, VPS**.
+
+<p align="center" style="margin: 24px 0;">
+  <img src="https://raw.githubusercontent.com/tuanminhhole/openclaw-setup/main/docs/openclaw-setup.png" alt="OpenClaw Setup" width="49%" style="border-radius: 8px; border: 1px solid #333;" />
+  <img src="https://raw.githubusercontent.com/tuanminhhole/openclaw-setup/main/docs/dashboard.png" alt="OpenClaw Dashboard" width="49%" style="border-radius: 8px; border: 1px solid #333;" />
+</p>
+
+</div>
+
+---
+
+## 🆕 Có gì mới trong v5.8.0 (Bản nâng cấp lớn)
+
+- 🎨 **Giao diện Quản trị Web UI Mới**: Thay thế hoàn toàn các file tĩnh `index.html` và kịch bản dòng lệnh thủ công bằng một Dashboard cài đặt và quản lý bot cực kỳ trực quan với tone màu Dark Red/Black cao cấp.
+- 🔀 **Hợp nhất Cấu hình AI qua 9Router**: Từ phiên bản này, trình cài đặt tối giản hóa bằng việc sử dụng duy nhất **9Router** làm Gateway AI Proxy trung tâm. Người dùng không cần cấu hình API key phức tạp hay thủ công cho từng provider nữa. Thông qua 9Router, bạn có thể dễ dàng quản lý và kết nối mọi nhà cung cấp AI từ miễn phí (như Google Gemini free tier, Ollama local chạy offline) đến các mô hình trả phí cao cấp (như OpenAI GPT-4o, Anthropic Claude...) thông qua một giao diện đăng nhập OAuth cực kỳ nhanh chóng và bảo mật.
+- 📊 **Bảng điều khiển Tiến trình (Process Controller)**: Dễ dàng Bật (`Start`), Tắt (`Stop`), hoặc Tạo lại (`Recreate`) các bot container ngay trên giao diện Web mà không cần gõ bất cứ lệnh Docker nào.
+- 📑 **Xem Log thời gian thực (Live Logs)**: Tích hợp trình xem nhật ký hoạt động trực tiếp (streaming logs) từ bot lên giao diện, hỗ trợ tối đa cho việc kiểm tra và khắc phục lỗi tức thì.
+- 📁 **Trình quản lý File trực quan (File Tree Editor)**: Cho phép xem và chỉnh sửa trực tiếp các file cấu hình quan trọng như `openclaw.json`, `SOUL.md`, `AGENTS.md` ngay từ trình duyệt web.
+- 🔑 **Đăng nhập Zalo QR trực tiếp**: Tích hợp luồng kích hoạt Zalo Personal bằng cách quét mã QR hiển thị ngay trên giao diện quản trị.
+- 🔄 **Phân bổ Cổng Mạng thông minh**: Cơ chế tự động phát hiện cổng rảnh và gán cổng động (`routerPort`) giúp loại bỏ hoàn toàn xung đột mạng khi chạy nhiều bot trên cùng một máy.
+
+---
+
+## ✨ Tính năng nổi bật
+
+- 🤖 **Đa kênh** — Telegram (1 hoặc nhiều bot), Zalo Bot API, hoặc Zalo Personal (Cá nhân).
+- 🧑‍🤝‍🧑 **Đội bot (Multi-bot Team)** — Chạy đồng thời nhiều bot Telegram/Zalo, tự động đồng bộ hóa tài liệu và phối hợp làm việc theo nhóm.
+- 🧠 **Đa nhà cung cấp AI qua 9Router** — Dễ dàng định tuyến đến Google Gemini, Claude, GPT-4o, OpenRouter, Ollama (chạy local offline).
+- 🧩 **Kỹ năng (Skills)** — Web Search, Browser Automation (Chrome CDP thực tế), Cron/Scheduler lập lịch.
+- 🔌 **Plugin tích hợp** — Cài đặt nhanh các plugin nâng cao (`openclaw-zalo-mod`, Facebook Crawler...) chỉ bằng 1 nút nhấn trên UI.
+- 🔀 **9Router tích hợp** — Cầu nối AI proxy miễn phí không cần API key thông qua đăng nhập OAuth.
+- 🔒 **An toàn & Riêng tư** — Toàn bộ cấu hình và API key chỉ lưu trên thiết bị của bạn.
+
+---
+
+## 🗺️ Cách cài đặt nhanh nhất
+
+### 1️⃣ Cách 1: Sử dụng NPX (Không cần tải code trước)
+
+Mở terminal trên máy của bạn và chạy lệnh duy nhất:
+
+```bash
+npx create-openclaw-bot
+```
+
+_Hệ thống sẽ tự động tạo thư mục, cài đặt môi trường và mở giao diện Web Setup trên trình duyệt._
+
+### 2️⃣ Cách 2: Clone thủ công
+
+Nếu bạn tải mã nguồn từ GitHub về máy:
+
+```bash
+npm install
+npm start
+```
+
+---
+
+## 📋 Yêu cầu hệ thống
+
+- **Node.js**: Phiên bản 20, 22 hoặc 24 (Tránh dùng bản Node.js 25 do xung đột runtime).
+- **Git**: Đã cài đặt và có trong biến môi trường PATH.
+- **Docker Desktop** (Nếu chọn cài đặt qua Docker): Hỗ trợ Docker Compose V2.
+
+---
+
+## 🧠 Các Provider AI được hỗ trợ (Thông qua 9Router)
+
+- [9Router GitHub](https://github.com/decolua/9router)
+
+---
+
+## 🔌 Kênh trò chuyện hỗ trợ
+
+- **Telegram**: Lấy token bot chính thức từ `@BotFather`.
+- **Zalo Bot API**: Lấy thông tin kết nối chính thức từ [developers.zalo.me](https://developers.zalo.me).
+- **Zalo Cá nhân (Zalo Personal)**: Kích hoạt cực nhanh bằng cách quét mã QR hiển thị ngay trên Dashboard OpenClaw.
+
+---
+
+## 📁 Cấu trúc thư mục dự án
+
+```text
+openclaw-setup/
+|-- README.md                ← Tài liệu tiếng Anh
+|-- README.vi.md             ← Hướng dẫn tiếng Việt (Bạn đang đọc)
+|-- package.json             ← Điểm cấu hình NPM và scripts khởi chạy
+|-- dist/                    ← Mã nguồn đã biên dịch của Web UI và CLI
+`-- src/                     ← Mã nguồn gốc (giao diện, máy chủ cục bộ API, script build)
+```
+
+---
+
+## ❓ Câu hỏi thường gặp
+
+<details>
+<summary><b>Làm thế nào để dừng hoặc chạy lại bot?</b></summary>
+Giờ đây bạn không cần gõ lệnh nữa! Chỉ cần mở Web UI Setup lên, truy cập tab <b>Bot</b> và sử dụng nút bấm <b>Start / Stop / Recreate</b> để quản lý trực quan tiến trình hoạt động của Bot.
+</details>
+
+<details>
+<summary><b>Sửa tính cách bot và danh sách tác vụ ở đâu?</b></summary>
+Bạn có thể sửa trực tiếp ngay trên trình duyệt bằng cách truy cập tab <b>Bot</b>, cuộn xuống phần <b>Bot file tree</b> và click chọn file cần sửa (ví dụ: `SOUL.md`, `AGENTS.md`). Sau khi sửa xong nhấn <b>Save</b> là cấu hình sẽ được cập nhật ngay lập tức.
+</details>
+
+<details>
+<summary><b>Tôi có thể đổi model AI sau khi cài không?</b></summary>
+Hoàn toàn được. Bạn có thể sửa trực tiếp file `openclaw.json` ở giao diện web của setup, hoặc chạy lại lệnh cài đặt trỏ vào thư mục cũ để cập nhật nhanh cấu hình.
+</details>
+
+---
+
+## 🔗 Liên kết hữu ích
+
+- [OpenClaw Docs](https://openclaw.ai/docs)
+- [9Router GitHub](https://github.com/decolua/9router)
+- [Google AI Studio](https://aistudio.google.com/)
+- [Telegram BotFather](https://t.me/BotFather)
+- [Zalo Developer Platform](https://developers.zalo.me)
+- [Docker Desktop](https://www.docker.com/products/docker-desktop/)
+- [ClawHub (Skills)](https://clawhub.com)
+
+---
+
+## 📈 Star History
+
+<div align="center">
+
+[![Star History Chart](https://starchart.cc/tuanminhhole/openclaw-setup.svg?variant=adaptive)](https://starchart.cc/tuanminhhole/openclaw-setup)
+
+</div>
+
+---
+
+## 🙏 Lời cảm ơn
+
+- [OpenClaw](https://openclaw.ai) — AI Gateway framework
+- [9Router](https://github.com/decolua/9router) — Open-source AI proxy (OAuth-based, no API keys)
+- [ClawHub](https://clawhub.com) — Kho đăng ký các kỹ năng của bot
+- [TheSVG](https://thesvg.org) — Kho biểu tượng nhãn hiệu SVG chất lượng cao
+
+---
+
+<div align="center">
+
+Made with 🦞 by [Kent](https://github.com/tuanminhhole)
+
+</div>