create-openclaw-bot 5.4.0 → 5.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/CHANGELOG.md +177 -157
  2. package/CHANGELOG.vi.md +175 -155
  3. package/README.md +321 -321
  4. package/README.vi.md +321 -321
  5. package/cli.js +17 -19
  6. package/package.json +1 -1
  7. package/setup.js +16 -5
  8. package/openclaw_correct_structure.md +0 -203
package/README.vi.md CHANGED
@@ -1,321 +1,321 @@
1
- <div align="center">
2
-
3
- # 🦞 OpenClaw Setup
4
-
5
- <p align="center">
6
- <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.4.0-0EA5E9?style=for-the-badge" alt="Version 5.4.0" /></a>
7
- <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>
8
- <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>
9
- <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>
10
- </p>
11
-
12
- <p style="margin-top: 16px;">
13
- <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> ·
14
- <img src="https://flagcdn.com/24x18/gb.png" alt="English" width="24" height="18" style="vertical-align: sub;"> <a href="README.md">English</a>
15
- </p>
16
-
17
- 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**.
18
-
19
- <a href="https://github.com/tuanminhhole/openclaw-setup">
20
- <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;" />
21
- </a>
22
-
23
- </div>
24
-
25
- ---
26
-
27
- ## 🆕 Có gì mới trong v5.4.0
28
-
29
- - 🏗️ **Tái cấu trúc kiến trúc multi-bot** — Các flag `isTelegramMultiBot`, `isSharedMultiBot`, `isMultiBotWizard` được gộp thành một biến `isMultiBot` duy nhất. Đường dẫn `agentDir` trong `openclaw.json` được tạo ra nay đúng chuẩn `.openclaw/agents/{slug}/agent` (tương đối với `OPENCLAW_HOME`).
30
- - 🗑️ **Xóa hoàn toàn kênh combo Telegram + Zalo** — Combo mode đã được gỡ bỏ khỏi cả Web Wizard lẫn CLI. Sẽ được thiết kế lại trong bản phát hành sau.
31
- - 🤝 **Quy tắc cross-workspace trong `AGENTS.md`** — Ở chế độ multi-bot, `AGENTS.md` của mỗi bot có thêm mục liệt kê đường dẫn workspace của các bot anh em và quy tắc phối hợp.
32
- - 🧹 **Config sạch hơn** — Không còn tạo `auth-profiles.json` per-agent cho 9Router; không còn tạo `.env` cho native scripts; không còn tạo `models.json` per-agent cho Ollama.
33
-
34
- <details>
35
- <summary><b>Trước đó: Có gì mới ở v5.3.5</b></summary>
36
-
37
- - 🐛 **Fix: Lỗi Syntax MEMORY.md trong Workspace Zalo** — Patch TOOLS.md trước đó được chèn sai vị trí, gây `SyntaxError` trên `setup.js`. Đã sửa.
38
- - 🐟 **Cải tiến: Script gỡ cài đặt nằm trong thư mục project** — Tất cả 4 OS native + Docker ZIP đều có `uninstall-*.{bat,sh}` ngay trong thư mục project sau khi setup xong.
39
- - 🐛 **Fix: Windows Docker script crashes với "docker not recognized"** — File `.ps1` được tạo giờ dùng `Get-Command` để tìm Docker, kiểm tra Docker Desktop đang chạy, và gọi lệnh qua toán tử `&` — hoạt động kể cả khi Docker không có trong PATH mặc định của PowerShell.
40
- - 🐛 **Fix: Thiếu hướng dẫn login Zalo QR cho combo trong script Windows** — Phần hướng dẫn sau cài đặt giờ hiển thị lệnh `docker compose exec` login khi chọn combo channel.
41
-
42
- </details>
43
-
44
- ---
45
-
46
- ## ✨ Tính năng
47
-
48
- - 🤖 **Đa kênh** — Telegram (1 bot hoặc nhiều bot), Zalo Bot API, hoặc Zalo Cá nhân
49
- - 🧑‍🤝‍🧑 **Độ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
50
- - 🧠 **Đa provider AI** — Google Gemini, Claude, GPT-4o, OpenRouter, Ollama (local), 9Router
51
- - 🧩 **Skills** — Web Search, Browser Automation, Memory, RAG, Code Interpreter, Image Gen
52
- - 🔌 **Plugins** — Voice Call, Matrix, MS Teams, Nostr
53
- - 🔀 **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.
54
- - 🧙 **Setup Wizard** — 5 bước trực quan trên trình duyệt (`index.html`). Không cần terminal.
55
- - 💻 **CLI tương tác** — `npx create-openclaw-bot` — phù hợp cho Ubuntu, VPS, kỹ sư.
56
- - 🆓 **Miễn phí hoàn toàn để bắt đầu** — 9Router + Gemini free tier không tốn đồng nào
57
- - 🔒 **Riêng tư** — API key chỉ lưu trên máy bạn, không gửi đi đâu
58
- - ⚡ **Nhanh** — Từ zero đến bot chạy được trong dưới 5 phút
59
-
60
- ---
61
-
62
- ## 🗺️ Chọn cách triển khai
63
-
64
- > **Không biết nên dùng cách nào?** Bảng dưới đây sẽ giúp bạn:
65
-
66
- | Bạn là ai | Môi trường | Cách được đề xuất |
67
- | --- | --- | --- |
68
- | Không quen terminal | Windows / macOS | **Web Wizard** (`index.html`) |
69
- | Không quen terminal | Ubuntu Desktop | **Web Wizard** → chọn Native |
70
- | Quen terminal | Ubuntu / VPS | **CLI** (`npx create-openclaw-bot`) |
71
- | Muốn tự động hóa hoàn toàn | Bất kỳ | **AI Agent** (Antigravity + SETUP.md) |
72
-
73
- ### 1️⃣ Tùy chọn A — Web Wizard (không cần terminal)
74
-
75
- Phù hợp nhất cho **Windows và macOS**. Không cần dòng lệnh.
76
-
77
- 1. [Tải ZIP](https://github.com/tuanminhhole/openclaw-setup/archive/refs/heads/main.zip) hoặc clone repo này.
78
- 2. Mở `index.html` trong trình duyệt.
79
- 3. Làm theo **wizard 5 bước**:
80
- - **Bước 1:** Chọn OS (Windows / macOS / Ubuntu / VPS)
81
- - **Bước 2:** Chọn kênh bot (Telegram / Zalo)
82
- - **Bước 3:** Chọn AI provider và model
83
- - **Bước 4:** Nhập bot token và cấu hình
84
- - **Bước 5:** Tải script và chạy — xong!
85
- 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.
86
-
87
- > **Docker hay không Docker?**
88
- >
89
- > - **Windows / macOS** → Dùng **Docker** (cô lập hoàn toàn, dễ quản lý)
90
- > - **Ubuntu / VPS** → Dùng **Native (không Docker)** (ít RAM hơn, ổn định hơn)
91
-
92
- ### 2️⃣ Tùy chọn B — CLI tương tác (`npx`)
93
-
94
- Phù hợp nhất cho **kỹ sư, Ubuntu Desktop, VPS**. Nhanh và mạnh nhất.
95
-
96
- ```bash
97
- npx create-openclaw-bot
98
- ```
99
-
100
- Chạy trong terminal → làm theo hướng dẫn → script khởi động được tạo tự động.
101
-
102
- > Yêu cầu: **Node.js 20/22/24**. Kiểm tra: `node -v`
103
- >
104
- > 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.
105
-
106
- <details>
107
- <summary><b>3️⃣ Tùy chọn C — AI Agent (Antigravity)</b></summary>
108
- <br>
109
-
110
- 1. Mở [Antigravity IDE](https://antigravity.dev/)
111
- 2. Mở repo này làm workspace
112
- 3. Paste vào chat:
113
- ```
114
- Đọc SETUP.md và cài đặt OpenClaw v5.4.0 cho tôi.
115
- Bot token của tôi là X. Dùng 9Router (không cần API key).
116
- Thư mục project: <ĐƯỜNG_DẪN_CỦA_BẠN>
117
- ```
118
-
119
- </details>
120
-
121
- ---
122
-
123
- ## 📋 Yêu cầu
124
-
125
- ### Không dùng Docker (Native — khuyến nghị cho Ubuntu/VPS)
126
-
127
- | Yêu cầu | Ghi chú |
128
- | --- | --- |
129
- | **Node.js 20/22/24** | [Tải](https://nodejs.org/) · Kiểm tra: `node -v` · Tránh Node 25 hiện tại |
130
- | **AI provider** | 9Router (miễn phí) hoặc Gemini/Claude/GPT-4o |
131
- | **Bot Token** | Từ Telegram BotFather hoặc Zalo Developer |
132
- | **Ollama** _(tùy chọn)_ | Chỉ cần nếu muốn chạy Gemma 4 locally · [Tải](https://ollama.com/) |
133
-
134
- ### Dùng Docker (khuyến nghị cho Windows/macOS)
135
-
136
- | Yêu cầu | Ghi chú |
137
- | --- | --- |
138
- | **Node.js 20/22/24** | [Tải](https://nodejs.org/) · Kiểm tra: `node -v` · Tránh Node 25 hiện tại |
139
- | **Docker Desktop + Compose V2** | [Tải](https://www.docker.com/products/docker-desktop/) · Kiểm tra: `docker compose version` |
140
- | **AI provider** | 9Router chạy như container sidecar — không cần cài riêng |
141
- | **Bot Token** | Từ Telegram BotFather hoặc Zalo Developer |
142
-
143
- ---
144
-
145
- ## 🧠 Các Provider AI được hỗ trợ
146
-
147
- | Provider | Chi phí | API Key | Ghi chú |
148
- | --- | --- | --- | --- |
149
- | **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. |
150
- | **Google Gemini** | 🆓 Free tier | ✅ Có | Chất lượng cao. Free tier rất rộng rãi. |
151
- | **Ollama / Gemma 4** | 🏠 Miễn phí | ❌ Không | Chạy 100% offline. Tự pull model khi khởi động lần đầu. |
152
- | **Anthropic Claude** | 💰 Trả phí | ✅ Có | Chất lượng suy luận và viết tốt nhất. |
153
- | **OpenAI / Codex** | 💰 Trả phí | ✅ Có | GPT-4o, Codex Mini. |
154
- | **OpenRouter** | 🆓/💰 Hỗn hợp | ✅ Có | Nhiều model chung một key. Một số miễn phí. |
155
-
156
- > 🔀 **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.
157
-
158
- ---
159
-
160
- ## 🔌 Các kênh được hỗ trợ
161
-
162
- - **Telegram** (✅ Chính thức) — Tìm **@BotFather** → `/newbot` → Copy token.
163
- - **Zalo Bot API** (✅ Chính thức) — Vào [developers.zalo.me](https://developers.zalo.me) → Tạo bot → Copy token.
164
- - **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ụ.
165
-
166
- > ⚠️ **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ụ.
167
-
168
- ---
169
-
170
- ## 📁 Cấu trúc Repo
171
-
172
- ```
173
- index.html ← Wizard UI (mở trên trình duyệt)
174
- style.css ← Giao diện Wizard
175
- setup.js ← Logic Wizard
176
- cli.js ← CLI tương tác (npx create-openclaw-bot)
177
- CHANGELOG.md/.vi.md ← Lịch sử phiên bản
178
- README.md ← Tiếng Anh
179
- README.vi.md ← Bạn đang đọc (Tiếng Việt)
180
- SETUP.md/.vi.md ← Hướng dẫn kỹ thuật cho AI Agent
181
- docs/
182
- install-docker.md/.vi.md ← Cài Docker theo OS
183
- install-native.md/.vi.md ← Cài Native/PM2 theo OS
184
- ai-providers.md/.vi.md ← Cấu hình AI provider
185
- hardware-guide.md/.vi.md ← Yêu cầu RAM cho Ollama/Gemma 4
186
- faq.md/.vi.md ← Câu hỏi thường gặp
187
- ```
188
-
189
- > **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.
190
-
191
- ---
192
-
193
- ## ❓ Câu hỏi thường gặp
194
-
195
- <details>
196
- <summary><b>Có thực sự miễn phí không?</b></summary>
197
-
198
- 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.
199
-
200
- </details>
201
-
202
- <details>
203
- <summary><b>Bot chạy ở đâu?</b></summary>
204
-
205
- 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.
206
-
207
- </details>
208
-
209
- <details>
210
- <summary><b>Tôi có cần Docker không?</b></summary>
211
-
212
- 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.
213
-
214
- </details>
215
-
216
- <details>
217
- <summary><b>Làm sao dừng/khởi động lại bot?</b></summary>
218
-
219
- **Docker:**
220
-
221
- ```bash
222
- docker compose down # Dừng
223
- docker compose up -d # Chạy
224
- docker compose restart # Khởi động lại
225
- ```
226
-
227
- **PM2 (native):**
228
-
229
- ```bash
230
- pm2 stop openclaw-bot
231
- pm2 start openclaw-bot
232
- pm2 restart openclaw-bot
233
- ```
234
-
235
- </details>
236
-
237
- <details>
238
- <summary><b>Tôi có thể đổi AI model sau không?</b></summary>
239
-
240
- 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.
241
-
242
- </details>
243
-
244
- <details>
245
- <summary><b>Có an toàn không?</b></summary>
246
-
247
- 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.
248
-
249
- </details>
250
-
251
- <details>
252
- <summary><b>9Router là gì?</b></summary>
253
-
254
- 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.
255
-
256
- </details>
257
-
258
- <details>
259
- <summary><b>Skills và Plugins khác nhau thế nào?</b></summary>
260
-
261
- **Skills** thêm khả năng cho agent (Web Search, Browser Automation, Memory, RAG, Code Interpreter...) — cài qua `openclaw skills install` từ ClawHub.
262
-
263
- **Plugins** thêm kênh hoặc extension runtime (Voice Call, Matrix, MS Teams...) — cài qua `openclaw plugins install` từ npm.
264
-
265
- </details>
266
-
267
- <details>
268
- <summary><b>Cần bao nhiêu RAM cho Gemma 4?</b></summary>
269
-
270
- | Model | RAM tối thiểu (Native) | RAM tối thiểu (Docker) |
271
- | --- | --- | --- |
272
- | `gemma4:e2b` | ~4 GB | ~5 GB |
273
- | `gemma4:e4b` | ~8 GB | ~9 GB |
274
- | `gemma4:26b` | ~18 GB | ~20 GB |
275
- | `gemma4:31b` | ~24 GB | ~26 GB |
276
-
277
- 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.
278
-
279
- </details>
280
-
281
- ---
282
-
283
- ## 🔗 Liên kết
284
-
285
- - [OpenClaw Docs](https://openclaw.ai/docs)
286
- - [9Router](https://github.com/decolua/9router)
287
- - [Google AI Studio](https://aistudio.google.com/)
288
- - [Telegram BotFather](https://t.me/BotFather)
289
- - [Zalo Developer Platform](https://developers.zalo.me)
290
- - [Docker Desktop](https://www.docker.com/products/docker-desktop/)
291
- - [Ollama](https://ollama.com)
292
- - [OpenRouter](https://openrouter.ai)
293
- - [ClawHub (Skills)](https://clawhub.com)
294
-
295
- ---
296
-
297
- ## 📈 Star History
298
-
299
- <div align="center">
300
-
301
- [![Star History Chart](https://starchart.cc/tuanminhhole/openclaw-setup.svg?variant=adaptive)](https://starchart.cc/tuanminhhole/openclaw-setup)
302
-
303
- </div>
304
-
305
- ---
306
-
307
- ## 🙏 Lời cảm ơn
308
-
309
- - [OpenClaw](https://openclaw.ai) — AI Gateway framework
310
- - [9Router](https://github.com/decolua/9router) — Open-source AI proxy (OAuth-based, no API keys)
311
- - [Playwright](https://playwright.dev) — Browser automation engine
312
- - [ClawHub](https://clawhub.com) — Skills registry
313
- - [TheSVG](https://thesvg.org) — High-quality SVG brand icons
314
-
315
- ---
316
-
317
- <div align="center">
318
-
319
- Made with 🦞 by [Kent](https://github.com/tuanminhhole)
320
-
321
- </div>
1
+ <div align="center">
2
+
3
+ # 🦞 OpenClaw Setup
4
+
5
+ <p align="center">
6
+ <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.4.2-0EA5E9?style=for-the-badge" alt="Version 5.4.2" /></a>
7
+ <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>
8
+ <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>
9
+ <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>
10
+ </p>
11
+
12
+ <p style="margin-top: 16px;">
13
+ <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> ·
14
+ <img src="https://flagcdn.com/24x18/gb.png" alt="English" width="24" height="18" style="vertical-align: sub;"> <a href="README.md">English</a>
15
+ </p>
16
+
17
+ 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**.
18
+
19
+ <a href="https://github.com/tuanminhhole/openclaw-setup">
20
+ <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;" />
21
+ </a>
22
+
23
+ </div>
24
+
25
+ ---
26
+
27
+ ## 🆕 Có gì mới trong v5.4.2
28
+
29
+ - 🏗️ **Tái cấu trúc kiến trúc multi-bot** — Các flag `isTelegramMultiBot`, `isSharedMultiBot`, `isMultiBotWizard` được gộp thành một biến `isMultiBot` duy nhất. Đường dẫn `agentDir` trong `openclaw.json` được tạo ra nay đúng chuẩn `.openclaw/agents/{slug}/agent` (tương đối với `OPENCLAW_HOME`).
30
+ - 🗑️ **Xóa hoàn toàn kênh combo Telegram + Zalo** — Combo mode đã được gỡ bỏ khỏi cả Web Wizard lẫn CLI. Sẽ được thiết kế lại trong bản phát hành sau.
31
+ - 🤝 **Quy tắc cross-workspace trong `AGENTS.md`** — Ở chế độ multi-bot, `AGENTS.md` của mỗi bot có thêm mục liệt kê đường dẫn workspace của các bot anh em và quy tắc phối hợp.
32
+ - 🧹 **Config sạch hơn** — Không còn tạo `auth-profiles.json` per-agent cho 9Router; không còn tạo `.env` cho native scripts; không còn tạo `models.json` per-agent cho Ollama.
33
+
34
+ <details>
35
+ <summary><b>Trước đó: Có gì mới ở v5.3.5</b></summary>
36
+
37
+ - 🐛 **Fix: Lỗi Syntax MEMORY.md trong Workspace Zalo** — Patch TOOLS.md trước đó được chèn sai vị trí, gây `SyntaxError` trên `setup.js`. Đã sửa.
38
+ - 🐟 **Cải tiến: Script gỡ cài đặt nằm trong thư mục project** — Tất cả 4 OS native + Docker ZIP đều có `uninstall-*.{bat,sh}` ngay trong thư mục project sau khi setup xong.
39
+ - 🐛 **Fix: Windows Docker script crashes với "docker not recognized"** — File `.ps1` được tạo giờ dùng `Get-Command` để tìm Docker, kiểm tra Docker Desktop đang chạy, và gọi lệnh qua toán tử `&` — hoạt động kể cả khi Docker không có trong PATH mặc định của PowerShell.
40
+ - 🐛 **Fix: Thiếu hướng dẫn login Zalo QR cho combo trong script Windows** — Phần hướng dẫn sau cài đặt giờ hiển thị lệnh `docker compose exec` login khi chọn combo channel.
41
+
42
+ </details>
43
+
44
+ ---
45
+
46
+ ## ✨ Tính năng
47
+
48
+ - 🤖 **Đa kênh** — Telegram (1 bot hoặc nhiều bot), Zalo Bot API, hoặc Zalo Cá nhân
49
+ - 🧑‍🤝‍🧑 **Độ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
50
+ - 🧠 **Đa provider AI** — Google Gemini, Claude, GPT-4o, OpenRouter, Ollama (local), 9Router
51
+ - 🧩 **Skills** — Web Search, Browser Automation, Memory, RAG, Code Interpreter, Image Gen
52
+ - 🔌 **Plugins** — Voice Call, Matrix, MS Teams, Nostr
53
+ - 🔀 **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.
54
+ - 🧙 **Setup Wizard** — 5 bước trực quan trên trình duyệt (`index.html`). Không cần terminal.
55
+ - 💻 **CLI tương tác** — `npx create-openclaw-bot` — phù hợp cho Ubuntu, VPS, kỹ sư.
56
+ - 🆓 **Miễn phí hoàn toàn để bắt đầu** — 9Router + Gemini free tier không tốn đồng nào
57
+ - 🔒 **Riêng tư** — API key chỉ lưu trên máy bạn, không gửi đi đâu
58
+ - ⚡ **Nhanh** — Từ zero đến bot chạy được trong dưới 5 phút
59
+
60
+ ---
61
+
62
+ ## 🗺️ Chọn cách triển khai
63
+
64
+ > **Không biết nên dùng cách nào?** Bảng dưới đây sẽ giúp bạn:
65
+
66
+ | Bạn là ai | Môi trường | Cách được đề xuất |
67
+ | --- | --- | --- |
68
+ | Không quen terminal | Windows / macOS | **Web Wizard** (`index.html`) |
69
+ | Không quen terminal | Ubuntu Desktop | **Web Wizard** → chọn Native |
70
+ | Quen terminal | Ubuntu / VPS | **CLI** (`npx create-openclaw-bot`) |
71
+ | Muốn tự động hóa hoàn toàn | Bất kỳ | **AI Agent** (Antigravity + SETUP.md) |
72
+
73
+ ### 1️⃣ Tùy chọn A — Web Wizard (không cần terminal)
74
+
75
+ Phù hợp nhất cho **Windows và macOS**. Không cần dòng lệnh.
76
+
77
+ 1. [Tải ZIP](https://github.com/tuanminhhole/openclaw-setup/archive/refs/heads/main.zip) hoặc clone repo này.
78
+ 2. Mở `index.html` trong trình duyệt.
79
+ 3. Làm theo **wizard 5 bước**:
80
+ - **Bước 1:** Chọn OS (Windows / macOS / Ubuntu / VPS)
81
+ - **Bước 2:** Chọn kênh bot (Telegram / Zalo)
82
+ - **Bước 3:** Chọn AI provider và model
83
+ - **Bước 4:** Nhập bot token và cấu hình
84
+ - **Bước 5:** Tải script và chạy — xong!
85
+ 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.
86
+
87
+ > **Docker hay không Docker?**
88
+ >
89
+ > - **Windows / macOS** → Dùng **Docker** (cô lập hoàn toàn, dễ quản lý)
90
+ > - **Ubuntu / VPS** → Dùng **Native (không Docker)** (ít RAM hơn, ổn định hơn)
91
+
92
+ ### 2️⃣ Tùy chọn B — CLI tương tác (`npx`)
93
+
94
+ Phù hợp nhất cho **kỹ sư, Ubuntu Desktop, VPS**. Nhanh và mạnh nhất.
95
+
96
+ ```bash
97
+ npx create-openclaw-bot
98
+ ```
99
+
100
+ Chạy trong terminal → làm theo hướng dẫn → script khởi động được tạo tự động.
101
+
102
+ > Yêu cầu: **Node.js 20/22/24**. Kiểm tra: `node -v`
103
+ >
104
+ > 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.
105
+
106
+ <details>
107
+ <summary><b>3️⃣ Tùy chọn C — AI Agent (Antigravity)</b></summary>
108
+ <br>
109
+
110
+ 1. Mở [Antigravity IDE](https://antigravity.dev/)
111
+ 2. Mở repo này làm workspace
112
+ 3. Paste vào chat:
113
+ ```
114
+ Đọc SETUP.md và cài đặt OpenClaw v5.4.2 cho tôi.
115
+ Bot token của tôi là X. Dùng 9Router (không cần API key).
116
+ Thư mục project: <ĐƯỜNG_DẪN_CỦA_BẠN>
117
+ ```
118
+
119
+ </details>
120
+
121
+ ---
122
+
123
+ ## 📋 Yêu cầu
124
+
125
+ ### Không dùng Docker (Native — khuyến nghị cho Ubuntu/VPS)
126
+
127
+ | Yêu cầu | Ghi chú |
128
+ | --- | --- |
129
+ | **Node.js 20/22/24** | [Tải](https://nodejs.org/) · Kiểm tra: `node -v` · Tránh Node 25 hiện tại |
130
+ | **AI provider** | 9Router (miễn phí) hoặc Gemini/Claude/GPT-4o |
131
+ | **Bot Token** | Từ Telegram BotFather hoặc Zalo Developer |
132
+ | **Ollama** _(tùy chọn)_ | Chỉ cần nếu muốn chạy Gemma 4 locally · [Tải](https://ollama.com/) |
133
+
134
+ ### Dùng Docker (khuyến nghị cho Windows/macOS)
135
+
136
+ | Yêu cầu | Ghi chú |
137
+ | --- | --- |
138
+ | **Node.js 20/22/24** | [Tải](https://nodejs.org/) · Kiểm tra: `node -v` · Tránh Node 25 hiện tại |
139
+ | **Docker Desktop + Compose V2** | [Tải](https://www.docker.com/products/docker-desktop/) · Kiểm tra: `docker compose version` |
140
+ | **AI provider** | 9Router chạy như container sidecar — không cần cài riêng |
141
+ | **Bot Token** | Từ Telegram BotFather hoặc Zalo Developer |
142
+
143
+ ---
144
+
145
+ ## 🧠 Các Provider AI được hỗ trợ
146
+
147
+ | Provider | Chi phí | API Key | Ghi chú |
148
+ | --- | --- | --- | --- |
149
+ | **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. |
150
+ | **Google Gemini** | 🆓 Free tier | ✅ Có | Chất lượng cao. Free tier rất rộng rãi. |
151
+ | **Ollama / Gemma 4** | 🏠 Miễn phí | ❌ Không | Chạy 100% offline. Tự pull model khi khởi động lần đầu. |
152
+ | **Anthropic Claude** | 💰 Trả phí | ✅ Có | Chất lượng suy luận và viết tốt nhất. |
153
+ | **OpenAI / Codex** | 💰 Trả phí | ✅ Có | GPT-4o, Codex Mini. |
154
+ | **OpenRouter** | 🆓/💰 Hỗn hợp | ✅ Có | Nhiều model chung một key. Một số miễn phí. |
155
+
156
+ > 🔀 **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.
157
+
158
+ ---
159
+
160
+ ## 🔌 Các kênh được hỗ trợ
161
+
162
+ - **Telegram** (✅ Chính thức) — Tìm **@BotFather** → `/newbot` → Copy token.
163
+ - **Zalo Bot API** (✅ Chính thức) — Vào [developers.zalo.me](https://developers.zalo.me) → Tạo bot → Copy token.
164
+ - **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ụ.
165
+
166
+ > ⚠️ **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ụ.
167
+
168
+ ---
169
+
170
+ ## 📁 Cấu trúc Repo
171
+
172
+ ```
173
+ index.html ← Wizard UI (mở trên trình duyệt)
174
+ style.css ← Giao diện Wizard
175
+ setup.js ← Logic Wizard
176
+ cli.js ← CLI tương tác (npx create-openclaw-bot)
177
+ CHANGELOG.md/.vi.md ← Lịch sử phiên bản
178
+ README.md ← Tiếng Anh
179
+ README.vi.md ← Bạn đang đọc (Tiếng Việt)
180
+ SETUP.md/.vi.md ← Hướng dẫn kỹ thuật cho AI Agent
181
+ docs/
182
+ install-docker.md/.vi.md ← Cài Docker theo OS
183
+ install-native.md/.vi.md ← Cài Native/PM2 theo OS
184
+ ai-providers.md/.vi.md ← Cấu hình AI provider
185
+ hardware-guide.md/.vi.md ← Yêu cầu RAM cho Ollama/Gemma 4
186
+ faq.md/.vi.md ← Câu hỏi thường gặp
187
+ ```
188
+
189
+ > **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.
190
+
191
+ ---
192
+
193
+ ## ❓ Câu hỏi thường gặp
194
+
195
+ <details>
196
+ <summary><b>Có thực sự miễn phí không?</b></summary>
197
+
198
+ 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.
199
+
200
+ </details>
201
+
202
+ <details>
203
+ <summary><b>Bot chạy ở đâu?</b></summary>
204
+
205
+ 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.
206
+
207
+ </details>
208
+
209
+ <details>
210
+ <summary><b>Tôi có cần Docker không?</b></summary>
211
+
212
+ 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.
213
+
214
+ </details>
215
+
216
+ <details>
217
+ <summary><b>Làm sao dừng/khởi động lại bot?</b></summary>
218
+
219
+ **Docker:**
220
+
221
+ ```bash
222
+ docker compose down # Dừng
223
+ docker compose up -d # Chạy
224
+ docker compose restart # Khởi động lại
225
+ ```
226
+
227
+ **PM2 (native):**
228
+
229
+ ```bash
230
+ pm2 stop openclaw-bot
231
+ pm2 start openclaw-bot
232
+ pm2 restart openclaw-bot
233
+ ```
234
+
235
+ </details>
236
+
237
+ <details>
238
+ <summary><b>Tôi có thể đổi AI model sau không?</b></summary>
239
+
240
+ 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.
241
+
242
+ </details>
243
+
244
+ <details>
245
+ <summary><b>Có an toàn không?</b></summary>
246
+
247
+ 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.
248
+
249
+ </details>
250
+
251
+ <details>
252
+ <summary><b>9Router là gì?</b></summary>
253
+
254
+ 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.
255
+
256
+ </details>
257
+
258
+ <details>
259
+ <summary><b>Skills và Plugins khác nhau thế nào?</b></summary>
260
+
261
+ **Skills** thêm khả năng cho agent (Web Search, Browser Automation, Memory, RAG, Code Interpreter...) — cài qua `openclaw skills install` từ ClawHub.
262
+
263
+ **Plugins** thêm kênh hoặc extension runtime (Voice Call, Matrix, MS Teams...) — cài qua `openclaw plugins install` từ npm.
264
+
265
+ </details>
266
+
267
+ <details>
268
+ <summary><b>Cần bao nhiêu RAM cho Gemma 4?</b></summary>
269
+
270
+ | Model | RAM tối thiểu (Native) | RAM tối thiểu (Docker) |
271
+ | --- | --- | --- |
272
+ | `gemma4:e2b` | ~4 GB | ~5 GB |
273
+ | `gemma4:e4b` | ~8 GB | ~9 GB |
274
+ | `gemma4:26b` | ~18 GB | ~20 GB |
275
+ | `gemma4:31b` | ~24 GB | ~26 GB |
276
+
277
+ 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.
278
+
279
+ </details>
280
+
281
+ ---
282
+
283
+ ## 🔗 Liên kết
284
+
285
+ - [OpenClaw Docs](https://openclaw.ai/docs)
286
+ - [9Router](https://github.com/decolua/9router)
287
+ - [Google AI Studio](https://aistudio.google.com/)
288
+ - [Telegram BotFather](https://t.me/BotFather)
289
+ - [Zalo Developer Platform](https://developers.zalo.me)
290
+ - [Docker Desktop](https://www.docker.com/products/docker-desktop/)
291
+ - [Ollama](https://ollama.com)
292
+ - [OpenRouter](https://openrouter.ai)
293
+ - [ClawHub (Skills)](https://clawhub.com)
294
+
295
+ ---
296
+
297
+ ## 📈 Star History
298
+
299
+ <div align="center">
300
+
301
+ [![Star History Chart](https://starchart.cc/tuanminhhole/openclaw-setup.svg?variant=adaptive)](https://starchart.cc/tuanminhhole/openclaw-setup)
302
+
303
+ </div>
304
+
305
+ ---
306
+
307
+ ## 🙏 Lời cảm ơn
308
+
309
+ - [OpenClaw](https://openclaw.ai) — AI Gateway framework
310
+ - [9Router](https://github.com/decolua/9router) — Open-source AI proxy (OAuth-based, no API keys)
311
+ - [Playwright](https://playwright.dev) — Browser automation engine
312
+ - [ClawHub](https://clawhub.com) — Skills registry
313
+ - [TheSVG](https://thesvg.org) — High-quality SVG brand icons
314
+
315
+ ---
316
+
317
+ <div align="center">
318
+
319
+ Made with 🦞 by [Kent](https://github.com/tuanminhhole)
320
+
321
+ </div>