create-openclaw-bot 5.4.1 → 5.5.0
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.
- package/CHANGELOG.md +188 -170
- package/CHANGELOG.vi.md +186 -168
- package/README.md +323 -321
- package/README.vi.md +323 -321
- package/old_v510.js +0 -0
- package/package.json +1 -1
- package/setup/data/channels.js +164 -0
- package/setup/data/header.js +80 -0
- package/setup/data/index.js +73 -0
- package/setup/data/plugins.js +60 -0
- package/setup/data/providers.js +121 -0
- package/setup/data/skills.js +169 -0
- package/setup/shared/common-gen.js +223 -0
- package/setup/shared/docker-gen.js +359 -0
- package/setup/shared/runtime-gen.js +710 -0
- package/setup/shared/scaffold-gen.js +212 -0
- package/setup.js +82 -14
- package/patch-tray.js +0 -7
package/README.vi.md
CHANGED
|
@@ -1,321 +1,323 @@
|
|
|
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.
|
|
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.
|
|
28
|
-
|
|
29
|
-
-
|
|
30
|
-
-
|
|
31
|
-
-
|
|
32
|
-
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
-
|
|
40
|
-
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
-
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
-
|
|
54
|
-
-
|
|
55
|
-
-
|
|
56
|
-
-
|
|
57
|
-
-
|
|
58
|
-
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
|
69
|
-
|
|
|
70
|
-
|
|
|
71
|
-
|
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
- **Bước
|
|
83
|
-
- **Bước
|
|
84
|
-
- **Bước
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
>
|
|
90
|
-
>
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
```
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
>
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
<
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
|
130
|
-
|
|
|
131
|
-
| **
|
|
132
|
-
| **
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
|
139
|
-
|
|
|
140
|
-
| **
|
|
141
|
-
| **
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
|
150
|
-
|
|
|
151
|
-
| **
|
|
152
|
-
| **
|
|
153
|
-
| **
|
|
154
|
-
| **
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
- **
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
docker compose
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
pm2
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
9Router là
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
**
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
|
273
|
-
|
|
|
274
|
-
| `gemma4:
|
|
275
|
-
| `gemma4:
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
- [
|
|
288
|
-
- [
|
|
289
|
-
- [
|
|
290
|
-
- [
|
|
291
|
-
- [
|
|
292
|
-
- [
|
|
293
|
-
- [
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
- [
|
|
312
|
-
- [
|
|
313
|
-
- [
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
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.5.0-0EA5E9?style=for-the-badge" alt="Version 5.5.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.5.0
|
|
28
|
+
|
|
29
|
+
- 📦 **OpenClaw 2026.4.14** — Nâng từ 2026.4.5. Bao gồm hệ thống Dreaming (thử nghiệm), cải thiện active-memory, sửa deadlock nút approve Telegram, ổn định WebSocket keepalive.
|
|
30
|
+
- 📄 **Tách file workspace docs** — Multi-bot giờ sinh `TEAM.md` (roster đội + phối hợp) và `RELAY.md` (sổ tay chuyển tiếp) thành file riêng, rõ ràng hơn.
|
|
31
|
+
- 🔐 **Quy tắc bảo mật đầy đủ mọi nơi** — Tất cả `AGENTS.md` giờ có đủ 4 section bảo mật (File hệ thống, API Key, Ví Crypto, Docker) bất kể OS, mode hay kênh.
|
|
32
|
+
- 🗑️ **Xóa file `.yaml` agent** — OpenClaw Core chỉ đọc từ `openclaw.json`. File `.yaml` orphan không còn được sinh ra.
|
|
33
|
+
- 🤖 **Chống ảo giác handoff** — `AGENTS.md` relay bắt buộc `react` action và cấm từ chối chuyển tiếp giữa các agent.
|
|
34
|
+
- 🏗️ **Scaffold-based generation** — Cả Wizard lẫn CLI gọi chung scaffold builders, đồng nhất trên mọi platform.
|
|
35
|
+
|
|
36
|
+
<details>
|
|
37
|
+
<summary><b>Trước đó: Có gì mới ở v5.5.0</b></summary>
|
|
38
|
+
|
|
39
|
+
- 🏗️ **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`).
|
|
40
|
+
- 🗑️ **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.
|
|
41
|
+
- 🤝 **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.
|
|
42
|
+
- 🧹 **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.
|
|
43
|
+
|
|
44
|
+
</details>
|
|
45
|
+
|
|
46
|
+
---
|
|
47
|
+
|
|
48
|
+
## ✨ Tính năng
|
|
49
|
+
|
|
50
|
+
- 🤖 **Đa kênh** — Telegram (1 bot hoặc nhiều bot), Zalo Bot API, hoặc Zalo Cá nhân
|
|
51
|
+
- 🧑🤝🧑 **Độ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
|
|
52
|
+
- 🧠 **Đa provider AI** — Google Gemini, Claude, GPT-4o, OpenRouter, Ollama (local), 9Router
|
|
53
|
+
- 🧩 **Skills** — Web Search, Browser Automation, Memory, RAG, Code Interpreter, Image Gen
|
|
54
|
+
- 🔌 **Plugins** — Voice Call, Matrix, MS Teams, Nostr
|
|
55
|
+
- 🔀 **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.
|
|
56
|
+
- 🧙 **Setup Wizard** — 5 bước trực quan trên trình duyệt (`index.html`). Không cần terminal.
|
|
57
|
+
- 💻 **CLI tương tác** — `npx create-openclaw-bot` — phù hợp cho Ubuntu, VPS, kỹ sư.
|
|
58
|
+
- 🆓 **Miễn phí hoàn toàn để bắt đầu** — 9Router + Gemini free tier không tốn đồng nào
|
|
59
|
+
- 🔒 **Riêng tư** — API key chỉ lưu trên máy bạn, không gửi đi đâu
|
|
60
|
+
- ⚡ **Nhanh** — Từ zero đến bot chạy được trong dưới 5 phút
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
## 🗺️ Chọn cách triển khai
|
|
65
|
+
|
|
66
|
+
> **Không biết nên dùng cách nào?** Bảng dưới đây sẽ giúp bạn:
|
|
67
|
+
|
|
68
|
+
| Bạn là ai | Môi trường | Cách được đề xuất |
|
|
69
|
+
| --- | --- | --- |
|
|
70
|
+
| Không quen terminal | Windows / macOS | **Web Wizard** (`index.html`) |
|
|
71
|
+
| Không quen terminal | Ubuntu Desktop | **Web Wizard** → chọn Native |
|
|
72
|
+
| Quen terminal | Ubuntu / VPS | **CLI** (`npx create-openclaw-bot`) |
|
|
73
|
+
| Muốn tự động hóa hoàn toàn | Bất kỳ | **AI Agent** (Antigravity + SETUP.md) |
|
|
74
|
+
|
|
75
|
+
### 1️⃣ Tùy chọn A — Web Wizard (không cần terminal)
|
|
76
|
+
|
|
77
|
+
Phù hợp nhất cho **Windows và macOS**. Không cần dòng lệnh.
|
|
78
|
+
|
|
79
|
+
1. [Tải ZIP](https://github.com/tuanminhhole/openclaw-setup/archive/refs/heads/main.zip) hoặc clone repo này.
|
|
80
|
+
2. Mở `index.html` trong trình duyệt.
|
|
81
|
+
3. Làm theo **wizard 5 bước**:
|
|
82
|
+
- **Bước 1:** Chọn OS (Windows / macOS / Ubuntu / VPS)
|
|
83
|
+
- **Bước 2:** Chọn kênh bot (Telegram / Zalo)
|
|
84
|
+
- **Bước 3:** Chọn AI provider và model
|
|
85
|
+
- **Bước 4:** Nhập bot token và cấu hình
|
|
86
|
+
- **Bước 5:** Tải script và chạy — xong!
|
|
87
|
+
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.
|
|
88
|
+
|
|
89
|
+
> **Docker hay không Docker?**
|
|
90
|
+
>
|
|
91
|
+
> - **Windows / macOS** → Dùng **Docker** (cô lập hoàn toàn, dễ quản lý)
|
|
92
|
+
> - **Ubuntu / VPS** → Dùng **Native (không Docker)** (ít RAM hơn, ổn định hơn)
|
|
93
|
+
|
|
94
|
+
### 2️⃣ Tùy chọn B — CLI tương tác (`npx`)
|
|
95
|
+
|
|
96
|
+
Phù hợp nhất cho **kỹ sư, Ubuntu Desktop, VPS**. Nhanh và mạnh nhất.
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
npx create-openclaw-bot
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
Chạy trong terminal → làm theo hướng dẫn → script khởi động được tạo tự động.
|
|
103
|
+
|
|
104
|
+
> Yêu cầu: **Node.js 20/22/24**. Kiểm tra: `node -v`
|
|
105
|
+
>
|
|
106
|
+
> 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.
|
|
107
|
+
|
|
108
|
+
<details>
|
|
109
|
+
<summary><b>3️⃣ Tùy chọn C — AI Agent (Antigravity)</b></summary>
|
|
110
|
+
<br>
|
|
111
|
+
|
|
112
|
+
1. Mở [Antigravity IDE](https://antigravity.dev/)
|
|
113
|
+
2. Mở repo này làm workspace
|
|
114
|
+
3. Paste vào chat:
|
|
115
|
+
```
|
|
116
|
+
Đọc SETUP.md và cài đặt OpenClaw v5.5.0 cho tôi.
|
|
117
|
+
Bot token của tôi là X. Dùng 9Router (không cần API key).
|
|
118
|
+
Thư mục project: <ĐƯỜNG_DẪN_CỦA_BẠN>
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
</details>
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
## 📋 Yêu cầu
|
|
126
|
+
|
|
127
|
+
### Không dùng Docker (Native — khuyến nghị cho Ubuntu/VPS)
|
|
128
|
+
|
|
129
|
+
| Yêu cầu | Ghi chú |
|
|
130
|
+
| --- | --- |
|
|
131
|
+
| **Node.js 20/22/24** | [Tải](https://nodejs.org/) · Kiểm tra: `node -v` · Tránh Node 25 hiện tại |
|
|
132
|
+
| **AI provider** | 9Router (miễn phí) hoặc Gemini/Claude/GPT-4o |
|
|
133
|
+
| **Bot Token** | Từ Telegram BotFather hoặc Zalo Developer |
|
|
134
|
+
| **Ollama** _(tùy chọn)_ | Chỉ cần nếu muốn chạy Gemma 4 locally · [Tải](https://ollama.com/) |
|
|
135
|
+
|
|
136
|
+
### Dùng Docker (khuyến nghị cho Windows/macOS)
|
|
137
|
+
|
|
138
|
+
| Yêu cầu | Ghi chú |
|
|
139
|
+
| --- | --- |
|
|
140
|
+
| **Node.js 20/22/24** | [Tải](https://nodejs.org/) · Kiểm tra: `node -v` · Tránh Node 25 hiện tại |
|
|
141
|
+
| **Docker Desktop + Compose V2** | [Tải](https://www.docker.com/products/docker-desktop/) · Kiểm tra: `docker compose version` |
|
|
142
|
+
| **AI provider** | 9Router chạy như container sidecar — không cần cài riêng |
|
|
143
|
+
| **Bot Token** | Từ Telegram BotFather hoặc Zalo Developer |
|
|
144
|
+
|
|
145
|
+
---
|
|
146
|
+
|
|
147
|
+
## 🧠 Các Provider AI được hỗ trợ
|
|
148
|
+
|
|
149
|
+
| Provider | Chi phí | API Key | Ghi chú |
|
|
150
|
+
| --- | --- | --- | --- |
|
|
151
|
+
| **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. |
|
|
152
|
+
| **Google Gemini** | 🆓 Free tier | ✅ Có | Chất lượng cao. Free tier rất rộng rãi. |
|
|
153
|
+
| **Ollama / Gemma 4** | 🏠 Miễn phí | ❌ Không | Chạy 100% offline. Tự pull model khi khởi động lần đầu. |
|
|
154
|
+
| **Anthropic Claude** | 💰 Trả phí | ✅ Có | Chất lượng suy luận và viết tốt nhất. |
|
|
155
|
+
| **OpenAI / Codex** | 💰 Trả phí | ✅ Có | GPT-4o, Codex Mini. |
|
|
156
|
+
| **OpenRouter** | 🆓/💰 Hỗn hợp | ✅ Có | Nhiều model chung một key. Một số miễn phí. |
|
|
157
|
+
|
|
158
|
+
> 🔀 **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.
|
|
159
|
+
|
|
160
|
+
---
|
|
161
|
+
|
|
162
|
+
## 🔌 Các kênh được hỗ trợ
|
|
163
|
+
|
|
164
|
+
- **Telegram** (✅ Chính thức) — Tìm **@BotFather** → `/newbot` → Copy token.
|
|
165
|
+
- **Zalo Bot API** (✅ Chính thức) — Vào [developers.zalo.me](https://developers.zalo.me) → Tạo bot → Copy token.
|
|
166
|
+
- **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ụ.
|
|
167
|
+
|
|
168
|
+
> ⚠️ **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ụ.
|
|
169
|
+
|
|
170
|
+
---
|
|
171
|
+
|
|
172
|
+
## 📁 Cấu trúc Repo
|
|
173
|
+
|
|
174
|
+
```
|
|
175
|
+
index.html ← Wizard UI (mở trên trình duyệt)
|
|
176
|
+
style.css ← Giao diện Wizard
|
|
177
|
+
setup.js ← Logic Wizard
|
|
178
|
+
cli.js ← CLI tương tác (npx create-openclaw-bot)
|
|
179
|
+
CHANGELOG.md/.vi.md ← Lịch sử phiên bản
|
|
180
|
+
README.md ← Tiếng Anh
|
|
181
|
+
README.vi.md ← Bạn đang đọc (Tiếng Việt)
|
|
182
|
+
SETUP.md/.vi.md ← Hướng dẫn kỹ thuật cho AI Agent
|
|
183
|
+
docs/
|
|
184
|
+
install-docker.md/.vi.md ← Cài Docker theo OS
|
|
185
|
+
install-native.md/.vi.md ← Cài Native/PM2 theo OS
|
|
186
|
+
ai-providers.md/.vi.md ← Cấu hình AI provider
|
|
187
|
+
hardware-guide.md/.vi.md ← Yêu cầu RAM cho Ollama/Gemma 4
|
|
188
|
+
faq.md/.vi.md ← Câu hỏi thường gặp
|
|
189
|
+
```
|
|
190
|
+
|
|
191
|
+
> **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.
|
|
192
|
+
|
|
193
|
+
---
|
|
194
|
+
|
|
195
|
+
## ❓ Câu hỏi thường gặp
|
|
196
|
+
|
|
197
|
+
<details>
|
|
198
|
+
<summary><b>Có thực sự miễn phí không?</b></summary>
|
|
199
|
+
|
|
200
|
+
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.
|
|
201
|
+
|
|
202
|
+
</details>
|
|
203
|
+
|
|
204
|
+
<details>
|
|
205
|
+
<summary><b>Bot chạy ở đâu?</b></summary>
|
|
206
|
+
|
|
207
|
+
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.
|
|
208
|
+
|
|
209
|
+
</details>
|
|
210
|
+
|
|
211
|
+
<details>
|
|
212
|
+
<summary><b>Tôi có cần Docker không?</b></summary>
|
|
213
|
+
|
|
214
|
+
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.
|
|
215
|
+
|
|
216
|
+
</details>
|
|
217
|
+
|
|
218
|
+
<details>
|
|
219
|
+
<summary><b>Làm sao dừng/khởi động lại bot?</b></summary>
|
|
220
|
+
|
|
221
|
+
**Docker:**
|
|
222
|
+
|
|
223
|
+
```bash
|
|
224
|
+
docker compose down # Dừng
|
|
225
|
+
docker compose up -d # Chạy
|
|
226
|
+
docker compose restart # Khởi động lại
|
|
227
|
+
```
|
|
228
|
+
|
|
229
|
+
**PM2 (native):**
|
|
230
|
+
|
|
231
|
+
```bash
|
|
232
|
+
pm2 stop openclaw-bot
|
|
233
|
+
pm2 start openclaw-bot
|
|
234
|
+
pm2 restart openclaw-bot
|
|
235
|
+
```
|
|
236
|
+
|
|
237
|
+
</details>
|
|
238
|
+
|
|
239
|
+
<details>
|
|
240
|
+
<summary><b>Tôi có thể đổi AI model sau không?</b></summary>
|
|
241
|
+
|
|
242
|
+
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.
|
|
243
|
+
|
|
244
|
+
</details>
|
|
245
|
+
|
|
246
|
+
<details>
|
|
247
|
+
<summary><b>Có an toàn không?</b></summary>
|
|
248
|
+
|
|
249
|
+
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.
|
|
250
|
+
|
|
251
|
+
</details>
|
|
252
|
+
|
|
253
|
+
<details>
|
|
254
|
+
<summary><b>9Router là gì?</b></summary>
|
|
255
|
+
|
|
256
|
+
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.
|
|
257
|
+
|
|
258
|
+
</details>
|
|
259
|
+
|
|
260
|
+
<details>
|
|
261
|
+
<summary><b>Skills và Plugins khác nhau thế nào?</b></summary>
|
|
262
|
+
|
|
263
|
+
**Skills** thêm khả năng cho agent (Web Search, Browser Automation, Memory, RAG, Code Interpreter...) — cài qua `openclaw skills install` từ ClawHub.
|
|
264
|
+
|
|
265
|
+
**Plugins** thêm kênh hoặc extension runtime (Voice Call, Matrix, MS Teams...) — cài qua `openclaw plugins install` từ npm.
|
|
266
|
+
|
|
267
|
+
</details>
|
|
268
|
+
|
|
269
|
+
<details>
|
|
270
|
+
<summary><b>Cần bao nhiêu RAM cho Gemma 4?</b></summary>
|
|
271
|
+
|
|
272
|
+
| Model | RAM tối thiểu (Native) | RAM tối thiểu (Docker) |
|
|
273
|
+
| --- | --- | --- |
|
|
274
|
+
| `gemma4:e2b` | ~4 GB | ~5 GB |
|
|
275
|
+
| `gemma4:e4b` | ~8 GB | ~9 GB |
|
|
276
|
+
| `gemma4:26b` | ~18 GB | ~20 GB |
|
|
277
|
+
| `gemma4:31b` | ~24 GB | ~26 GB |
|
|
278
|
+
|
|
279
|
+
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.
|
|
280
|
+
|
|
281
|
+
</details>
|
|
282
|
+
|
|
283
|
+
---
|
|
284
|
+
|
|
285
|
+
## 🔗 Liên kết
|
|
286
|
+
|
|
287
|
+
- [OpenClaw Docs](https://openclaw.ai/docs)
|
|
288
|
+
- [9Router](https://github.com/decolua/9router)
|
|
289
|
+
- [Google AI Studio](https://aistudio.google.com/)
|
|
290
|
+
- [Telegram BotFather](https://t.me/BotFather)
|
|
291
|
+
- [Zalo Developer Platform](https://developers.zalo.me)
|
|
292
|
+
- [Docker Desktop](https://www.docker.com/products/docker-desktop/)
|
|
293
|
+
- [Ollama](https://ollama.com)
|
|
294
|
+
- [OpenRouter](https://openrouter.ai)
|
|
295
|
+
- [ClawHub (Skills)](https://clawhub.com)
|
|
296
|
+
|
|
297
|
+
---
|
|
298
|
+
|
|
299
|
+
## 📈 Star History
|
|
300
|
+
|
|
301
|
+
<div align="center">
|
|
302
|
+
|
|
303
|
+
[](https://starchart.cc/tuanminhhole/openclaw-setup)
|
|
304
|
+
|
|
305
|
+
</div>
|
|
306
|
+
|
|
307
|
+
---
|
|
308
|
+
|
|
309
|
+
## 🙏 Lời cảm ơn
|
|
310
|
+
|
|
311
|
+
- [OpenClaw](https://openclaw.ai) — AI Gateway framework
|
|
312
|
+
- [9Router](https://github.com/decolua/9router) — Open-source AI proxy (OAuth-based, no API keys)
|
|
313
|
+
- [Playwright](https://playwright.dev) — Browser automation engine
|
|
314
|
+
- [ClawHub](https://clawhub.com) — Skills registry
|
|
315
|
+
- [TheSVG](https://thesvg.org) — High-quality SVG brand icons
|
|
316
|
+
|
|
317
|
+
---
|
|
318
|
+
|
|
319
|
+
<div align="center">
|
|
320
|
+
|
|
321
|
+
Made with 🦞 by [Kent](https://github.com/tuanminhhole)
|
|
322
|
+
|
|
323
|
+
</div>
|