create-openclaw-bot 5.8.24 → 5.9.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/README.md +294 -183
- package/README.vi.md +294 -183
- package/dist/cli.js +172 -162
- package/dist/server/local-server.js +4079 -3503
- package/dist/setup/data/channels.js +1 -1
- package/dist/setup/data/header.js +80 -80
- package/dist/setup/data/plugins.js +1 -1
- package/dist/setup/data/providers.js +1 -1
- package/dist/setup/shared/bot-config-gen.js +528 -511
- package/dist/setup/shared/common-gen.js +314 -314
- package/dist/setup/shared/docker-gen.js +606 -586
- package/dist/setup/shared/install-gen.js +566 -566
- package/dist/setup/shared/workspace-gen.js +679 -648
- package/dist/web/app.js +1592 -1414
- package/dist/web/index.html +14 -14
- package/dist/web/lark.svg +1 -0
- package/dist/web/styles.css +1448 -1376
- package/node_modules/wrap-ansi/index.js +0 -0
- package/package.json +3 -2
package/README.vi.md
CHANGED
|
@@ -1,183 +1,294 @@
|
|
|
1
|
-
<div align="center">
|
|
2
|
-
|
|
3
|
-
# 🦞 OpenClaw Setup
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
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
|
-
</details>
|
|
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
|
-
|
|
83
|
-
|
|
84
|
-
|
|
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
|
-
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
# 🦞 OpenClaw Setup
|
|
4
|
+
|
|
5
|
+
### Một **giao diện Web** để tạo, triển khai & vận hành trợ lý AI đa bot miễn phí — không cần gõ terminal
|
|
6
|
+
|
|
7
|
+
*Chạy một lệnh → mở dashboard → bot lên sóng. Windows · macOS · Linux · VPS, chạy Docker hoặc native.*
|
|
8
|
+
|
|
9
|
+
<p align="center">
|
|
10
|
+
<a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.9.0-0EA5E9?style=for-the-badge" alt="Version 5.9.0" /></a>
|
|
11
|
+
<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>
|
|
12
|
+
<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>
|
|
13
|
+
<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>
|
|
14
|
+
</p>
|
|
15
|
+
|
|
16
|
+
 **Tiếng Việt** · [ English](README.md)
|
|
17
|
+
|
|
18
|
+
> 🇻🇳 Mã nguồn mở & miễn phí. Dashboard tự động hóa 100% việc tạo dự án, triển khai và quản lý bot AI trên **Telegram · Zalo · Facebook Messenger** (Discord & Lark sắp ra mắt) — cài trong vài phút, không cần biết code.
|
|
19
|
+
|
|
20
|
+
<p align="center" style="margin: 24px 0;">
|
|
21
|
+
<img src="https://raw.githubusercontent.com/tuanminhhole/openclaw-setup/main/docs/openclaw-setup-vi.png" alt="OpenClaw Setup" width="90%" style="border-radius: 8px; border: 1px solid #333; margin-bottom: 16px;" />
|
|
22
|
+
<img src="https://raw.githubusercontent.com/tuanminhhole/openclaw-setup/main/docs/dashboard-vi.png" alt="OpenClaw Dashboard" width="90%" style="border-radius: 8px; border: 1px solid #333; margin-bottom: 16px;" />
|
|
23
|
+
<img src="https://raw.githubusercontent.com/tuanminhhole/openclaw-setup/main/docs/bot.png" alt="OpenClaw Bot in Action" width="90%" style="border-radius: 8px; border: 1px solid #333;" />
|
|
24
|
+
</p>
|
|
25
|
+
|
|
26
|
+
</div>
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## 🆕 Có gì mới trong v5.9.0
|
|
31
|
+
|
|
32
|
+
- 🧠 **TencentDB Agent Memory — cài 1 chạm**: Plugin bộ nhớ mới ngay trên UI. Bộ nhớ phân tầng 4 lớp (L0–L3) + nén ngữ cảnh, giữ session dài mạch lạc và **tiết kiệm tới ~61% token**. Chạy local hoàn toàn (SQLite), không cần API key, sẵn sàng cho Docker.
|
|
33
|
+
- ⚡ **Cấu hình tiết kiệm token mặc định cho mọi bot mới**: Tự có context pruning (cache-TTL) + compaction `safeguard` — **hội thoại dài rẻ hơn & sắc nét hơn**, không cần chỉnh tay.
|
|
34
|
+
- 🎯 **Skills/Plugins theo từng bot & từng kênh**: Cài/bật/tắt skill chỉ cho **đúng 1 bot** (không lan sang bot khác); bảng chỉ hiện thứ phù hợp với kênh (Zalo / Telegram / Messenger).
|
|
35
|
+
- 📤 **Gửi file ổn định trên Zalo & Telegram**: Bot đã biết quy trình gửi đúng (`media/outbound` + tool `message`) và dùng định dạng hiện đại như `.xlsx` — hết cảnh "không gửi được file".
|
|
36
|
+
- 🐳 **Nút điều khiển Docker 1 chạm**: Restart / Rebuild container bot và cấp quyền ổ đĩa (mount thư mục host bất kỳ vào `/mnt/<tên>`, đa OS) ngay trên dashboard — khởi động lại bot mà không cần gõ lệnh.
|
|
37
|
+
- ⚡ **Trang Dashboard & Bot load nhanh hơn**: Việc dò runtime/version giờ chỉ chạy **một lần** rồi cache thay vì lặp lại mỗi lần tải trang — bot status giảm từ ~4s xuống ~3ms ở các lần tải sau. Cache tự xoá khi update/rebuild/restart/cài đặt.
|
|
38
|
+
|
|
39
|
+
<details>
|
|
40
|
+
<summary><b>Trước đó: Có gì mới trong v5.8.24 (Tự động cập nhật Launcher)</b></summary>
|
|
41
|
+
|
|
42
|
+
- **Sửa lỗi: Lệch phiên bản cache Launcher**: Tự động phát hiện nếu launcher đang chạy (tải qua `npx`) có phiên bản mới hơn hoặc khác với bản đang cache trong `~/.openclaw-setup` và tự nâng cấp tương ứng.
|
|
43
|
+
|
|
44
|
+
</details>
|
|
45
|
+
|
|
46
|
+
<details>
|
|
47
|
+
<summary><b>Trước đó: Có gì mới trong v5.8.23 (Tích hợp Skill Siêu Trí Nhớ)</b></summary>
|
|
48
|
+
|
|
49
|
+
- **Mới: Siêu Trí Nhớ Dài Hạn & Tự Đóng Gói Kỹ Năng (learning-memory)**: Tích hợp sẵn skill tự học và tự tiến hóa kỹ năng mới cho Agent.
|
|
50
|
+
- Tự động ghi nhận thông tin, kiến thức và chỉ dẫn mới từ người dùng vào file `MEMORY.md` để ghi nhớ lâu dài.
|
|
51
|
+
- Cho phép Agent tự đóng gói các quy trình làm việc hoặc logic mới học được thành mã nguồn `.js` và file hướng dẫn `SKILL.md` trực tiếp vào thư mục `./skills/`, giúp bot tự phát triển kỹ năng mà không cần lập trình viên can thiệp.
|
|
52
|
+
- Hỗ trợ chạy tự động script cài đặt (postinstall) mượt mà trên mọi nền tảng (Docker, Windows, macOS, Linux) ngay sau khi cài từ ClawHub.
|
|
53
|
+
- **Mới: Quản lý Skill trên UI**: Thêm nút bật/tắt và quản lý cài đặt skill "Siêu Trí Nhớ Dài Hạn" trực tiếp trên giao diện quản trị Web UI Setup.
|
|
54
|
+
|
|
55
|
+
</details>
|
|
56
|
+
|
|
57
|
+
<details>
|
|
58
|
+
<summary><b>Trước đó: Có gì mới trong v5.8.22</b></summary>
|
|
59
|
+
|
|
60
|
+
- **Hỗ trợ Skill Tạo ảnh Infographic chuyên nghiệp**: Tích hợp hoàn toàn công cụ tạo ảnh infographic, poster tự động thông qua API của 9Router. Tự động sinh mã nguồn script `image-generator.js` đồng bộ API credentials từ `openclaw.json` và hướng dẫn `SKILL.md` cụ thể giúp Agent nắm vững cấu trúc prompt, font chữ tiếng Việt, layout và quy tắc thiết kế ảnh.
|
|
61
|
+
- **Hỗ trợ Skill Sticker & Auto-Tag (Zalo)**:
|
|
62
|
+
- Tự động tag tên người gửi tin nhắn gần nhất trong group chat Zalo (Agent không cần tự điền `@Tên` ở đầu câu trả lời nữa, hệ thống sẽ tự làm).
|
|
63
|
+
- Cho phép Agent gửi kèm Sticker Zalo trực tiếp trong câu trả lời thông qua thẻ `[Sticker: <từ_khóa>]` đặt ở cuối tin nhắn.
|
|
64
|
+
- Tích hợp bộ giải nghĩa từ khóa cảm xúc thông minh (như `love`, `haha`, `ca khia`, `angry`, `thank you`,...) để tự động map sang sticker Zalo phù hợp.
|
|
65
|
+
- Tự động sinh script vá logic `mentions.js` và tài liệu hướng dẫn `SKILL.md` trong workspace.
|
|
66
|
+
- **Tối ưu hóa: Đơn giản hóa sinh file TOOLS.md**: Điều chỉnh generator của `TOOLS.md` để sinh ra nội dung tĩnh gọn gàng, tập trung định hướng Agent đọc chi tiết các tài liệu hướng dẫn skill tương ứng.
|
|
67
|
+
- **Tối ưu hóa: Chuẩn hóa danh sách Tài liệu tham chiếu trong AGENTS.md**: Cập nhật danh sách tài liệu tham chiếu được tạo trong file `AGENTS.md` (cho cả 2 chế độ single/relay và cả tiếng Việt/tiếng Anh) để khớp chính xác cấu trúc mới gồm đúng 9 tài liệu cốt lõi, loại bỏ các file không còn phù hợp (`TEAMS.md` cho single-bot, `BROWSER.md`) và chuẩn hóa phần mô tả.
|
|
68
|
+
|
|
69
|
+
</details>
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
73
|
+
## ✨ Tính năng nổi bật
|
|
74
|
+
|
|
75
|
+
- 🤖 **Đa kênh** — Telegram (1 hoặc nhiều bot), Zalo Bot API, Zalo Personal (Cá nhân), và Facebook Messenger (Discord & Lark sắp ra mắt).
|
|
76
|
+
- 🧑🤝🧑 **Độ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.
|
|
77
|
+
- 🧠 **Đ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).
|
|
78
|
+
- 🧩 **Kỹ năng (Skills)** — Web Search, Browser Automation (Chrome CDP thực tế), Cron/Scheduler lập lịch.
|
|
79
|
+
- 🔌 **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.
|
|
80
|
+
- 🔀 **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.
|
|
81
|
+
- 🔒 **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.
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
|
|
85
|
+
## 🗺️ Cách cài đặt nhanh nhất
|
|
86
|
+
|
|
87
|
+
### 1️⃣ Cách 1 — Cài nhanh (Khuyên dùng)
|
|
88
|
+
|
|
89
|
+
Mở terminal và chạy đúng một lệnh (chạy trên macOS, Linux & Windows — cần Node.js ≥ 22):
|
|
90
|
+
|
|
91
|
+
```bash
|
|
92
|
+
npx github:tuanminhhole/openclaw-setup
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
Lệnh này tự tải wizard, chạy server và **mở giao diện Setup** trên trình duyệt tại **http://127.0.0.1:51789**.
|
|
96
|
+
|
|
97
|
+
### 2️⃣ Cách 2 — Clone thủ công (dành cho developer)
|
|
98
|
+
|
|
99
|
+
Dành cho người muốn lấy full source. Chạy lần lượt từng dòng:
|
|
100
|
+
|
|
101
|
+
```bash
|
|
102
|
+
git clone https://github.com/tuanminhhole/openclaw-setup.git
|
|
103
|
+
cd openclaw-setup
|
|
104
|
+
npm install
|
|
105
|
+
npm start
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
Sau đó mở **http://127.0.0.1:51789** nếu trình duyệt không tự bật.
|
|
109
|
+
|
|
110
|
+
> ⚠️ `npm install` / `npm start` **chỉ chạy được KHI bạn đang ở trong thư mục `openclaw-setup` đã clone**. Nếu bạn dùng Cách 1 (npx) thì **chưa hề clone repo** — hãy dùng lệnh mở lại bên dưới, đừng chạy `npm install`/`npm start` (sẽ báo lỗi thiếu `package.json`).
|
|
111
|
+
|
|
112
|
+
### 🔁 Mở lại giao diện sau này
|
|
113
|
+
|
|
114
|
+
**Lần chạy đầu tiên sẽ tự tạo lệnh ngắn `openclaw-ui`** đúng theo OS của bạn (zsh/bash trên macOS & Linux, PowerShell trên Windows). Lần sau chỉ cần mở terminal **mới** và gõ:
|
|
115
|
+
|
|
116
|
+
```bash
|
|
117
|
+
openclaw-ui
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
<details>
|
|
121
|
+
<summary>Lệnh thủ công (dự phòng — cũng không tải lại)</summary>
|
|
122
|
+
|
|
123
|
+
```bash
|
|
124
|
+
# macOS / Linux
|
|
125
|
+
OPENCLAW_SETUP_WIZARD=true node ~/.openclaw-setup/node_modules/create-openclaw-bot/dist/cli.js
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
```powershell
|
|
129
|
+
# Windows (PowerShell)
|
|
130
|
+
$env:OPENCLAW_SETUP_WIZARD="true"; node "$env:USERPROFILE\.openclaw-setup\node_modules\create-openclaw-bot\dist\cli.js"
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
</details>
|
|
134
|
+
|
|
135
|
+
### ⬆️ Cập nhật lên phiên bản mới
|
|
136
|
+
|
|
137
|
+
Bấm **Cập nhật** ngay trong dashboard — nó tự kéo bản mới và **tự khởi động lại UI** (tab tự kết nối lại). Hoặc chạy lại lệnh trong terminal — luôn lấy bản mới nhất từ GitHub:
|
|
138
|
+
|
|
139
|
+
```bash
|
|
140
|
+
npx github:tuanminhhole/openclaw-setup
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
---
|
|
144
|
+
|
|
145
|
+
## 📋 Yêu cầu hệ thống
|
|
146
|
+
|
|
147
|
+
- **Node.js 24 LTS** (bắt buộc) — wizard Setup chạy bằng Node, nên cần cho **cả** chế độ Docker lẫn Native. [Tải Node.js](https://nodejs.org/).
|
|
148
|
+
- **Git**: Đã cài đặt và có trong biến môi trường PATH.
|
|
149
|
+
- **Docker Desktop** (khuyên dùng, để chạy bot): hỗ trợ Docker Compose V2. [Tải Docker](https://www.docker.com/products/docker-desktop/).
|
|
150
|
+
|
|
151
|
+
---
|
|
152
|
+
|
|
153
|
+
## 🚀 Hướng dẫn cài đặt từng bước
|
|
154
|
+
|
|
155
|
+
> Lần đầu dùng? Làm lần lượt theo thứ tự — không cần gõ terminal ngoài bước mở giao diện.
|
|
156
|
+
|
|
157
|
+
**1. Mở giao diện Setup** — chạy lệnh cài ở trên, dashboard sẽ mở trên trình duyệt.
|
|
158
|
+
|
|
159
|
+
**2. Chọn Hệ điều hành & Chế độ chạy** — cài [Node.js 24 LTS](https://nodejs.org/) trước (wizard chạy bằng Node — cần cho **cả 2** chế độ). Rồi vào tab **Cài đặt**, chọn hệ điều hành và chế độ chạy:
|
|
160
|
+
- **Docker** (khuyên dùng) — chạy cách ly và **tạo được nhiều project/bot**. Cài thêm [Docker Desktop](https://www.docker.com/products/docker-desktop/).
|
|
161
|
+
- **Native** — nhẹ hơn, chạy bot thẳng trên máy (không cần Docker).
|
|
162
|
+
|
|
163
|
+
**3. Nhập đường dẫn & tên project** — nhập đường dẫn thư mục và tên project (ví dụ tên: `bot`), rồi bấm **Cài đặt**. Ví dụ đường dẫn:
|
|
164
|
+
- Windows: `D:\bot`
|
|
165
|
+
- macOS: `/Users/<tên-bạn>/bot`
|
|
166
|
+
- Linux: `/home/<tên-bạn>/bot`
|
|
167
|
+
|
|
168
|
+
**4. Đăng nhập 9Router** — bấm nút **Mở website 9Router**, đăng nhập bằng mật khẩu mặc định **`123456`**.
|
|
169
|
+
|
|
170
|
+
**5. Tạo API key (9Router)** — vào mục **Endpoints**, tạo một API key mới. Sau đó mở thư mục project → file `openclaw.json` → kéo xuống mục **`models`** → dán key vào ô `apiKey` còn trống rồi lưu.
|
|
171
|
+
|
|
172
|
+
**6. Kết nối Provider (9Router)** — vào mục **Providers**, chọn provider bạn muốn; hệ thống tự kết nối.
|
|
173
|
+
|
|
174
|
+
**7. Tạo Combo định tuyến (9Router)** — vào mục **Combos**, tạo combo đặt tên **đúng** là **`smart-route`** và thêm các models cần dùng.
|
|
175
|
+
|
|
176
|
+
**8. Tạo bot** — quay lại giao diện Setup, chọn kênh, nhập thông tin bot + thông tin cá nhân, rồi bấm **Tạo bot**.
|
|
177
|
+
|
|
178
|
+
**9. Restart & test** — khởi động lại container bot, rồi nhắn tin cho bot để kiểm tra. 🎉
|
|
179
|
+
|
|
180
|
+
---
|
|
181
|
+
|
|
182
|
+
## 🧠 Các Provider AI được hỗ trợ (Thông qua 9Router)
|
|
183
|
+
|
|
184
|
+
- [9Router GitHub](https://github.com/decolua/9router)
|
|
185
|
+
|
|
186
|
+
---
|
|
187
|
+
|
|
188
|
+
## 🔌 Kênh trò chuyện hỗ trợ
|
|
189
|
+
|
|
190
|
+
- **Telegram**: Lấy token bot chính thức từ `@BotFather`.
|
|
191
|
+
- **Zalo Bot API**: Lấy thông tin kết nối chính thức từ [developers.zalo.me](https://developers.zalo.me).
|
|
192
|
+
- **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.
|
|
193
|
+
- **Facebook Messenger**: Qua plugin riêng `fb-messenger` (liên hệ **tuanminhhole** để nhận) — chỉ cần dùng Page token.
|
|
194
|
+
- **Discord**: _Sắp ra mắt._
|
|
195
|
+
- **Lark**: _Sắp ra mắt._
|
|
196
|
+
|
|
197
|
+
---
|
|
198
|
+
|
|
199
|
+
## 📁 Cấu trúc thư mục dự án
|
|
200
|
+
|
|
201
|
+
```text
|
|
202
|
+
openclaw-setup/
|
|
203
|
+
|-- README.md ← Tài liệu tiếng Anh
|
|
204
|
+
|-- README.vi.md ← Hướng dẫn tiếng Việt (Bạn đang đọc)
|
|
205
|
+
|-- package.json ← Điểm cấu hình NPM và scripts khởi chạy
|
|
206
|
+
|-- dist/ ← Mã nguồn đã biên dịch của Web UI và CLI
|
|
207
|
+
`-- src/ ← Mã nguồn gốc (giao diện, máy chủ cục bộ API, script build)
|
|
208
|
+
```
|
|
209
|
+
|
|
210
|
+
---
|
|
211
|
+
|
|
212
|
+
## ❓ Câu hỏi thường gặp
|
|
213
|
+
|
|
214
|
+
<details>
|
|
215
|
+
<summary><b>Làm thế nào để dừng hoặc chạy lại bot?</b></summary>
|
|
216
|
+
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.
|
|
217
|
+
</details>
|
|
218
|
+
|
|
219
|
+
<details>
|
|
220
|
+
<summary><b>Sửa tính cách bot và danh sách tác vụ ở đâu?</b></summary>
|
|
221
|
+
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.
|
|
222
|
+
</details>
|
|
223
|
+
|
|
224
|
+
<details>
|
|
225
|
+
<summary><b>Tôi có thể đổi model AI sau khi cài không?</b></summary>
|
|
226
|
+
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.
|
|
227
|
+
</details>
|
|
228
|
+
|
|
229
|
+
---
|
|
230
|
+
|
|
231
|
+
## 🔗 Liên kết hữu ích
|
|
232
|
+
|
|
233
|
+
- [OpenClaw Docs](https://openclaw.ai/docs)
|
|
234
|
+
- [9Router GitHub](https://github.com/decolua/9router)
|
|
235
|
+
- [Google AI Studio](https://aistudio.google.com/)
|
|
236
|
+
- [Telegram BotFather](https://t.me/BotFather)
|
|
237
|
+
- [Zalo Developer Platform](https://developers.zalo.me)
|
|
238
|
+
- [Docker Desktop](https://www.docker.com/products/docker-desktop/)
|
|
239
|
+
- [ClawHub (Skills)](https://clawhub.com)
|
|
240
|
+
|
|
241
|
+
---
|
|
242
|
+
|
|
243
|
+
## 📈 Star History
|
|
244
|
+
|
|
245
|
+
<div align="center">
|
|
246
|
+
|
|
247
|
+
[](https://starchart.cc/tuanminhhole/openclaw-setup)
|
|
248
|
+
|
|
249
|
+
</div>
|
|
250
|
+
|
|
251
|
+
---
|
|
252
|
+
|
|
253
|
+
## 🙏 Lời cảm ơn
|
|
254
|
+
|
|
255
|
+
- [OpenClaw](https://openclaw.ai) — AI Gateway framework
|
|
256
|
+
- [9Router](https://github.com/decolua/9router) — Open-source AI proxy (OAuth-based, no API keys)
|
|
257
|
+
- [ClawHub](https://clawhub.com) — Kho đăng ký các kỹ năng của bot
|
|
258
|
+
- [TheSVG](https://thesvg.org) — Kho biểu tượng nhãn hiệu SVG chất lượng cao
|
|
259
|
+
|
|
260
|
+
---
|
|
261
|
+
|
|
262
|
+
## 🙌 Tác giả & Đóng góp
|
|
263
|
+
|
|
264
|
+
Làm bởi **[tuanminhhole (Kent)](https://github.com/tuanminhhole)** như một món quà mở cho cộng đồng.
|
|
265
|
+
Mọi góp ý / PR cải tiến đều được hoan nghênh. Nếu thấy hữu ích, hãy ⭐ repo để nhiều người biết tới nhé!
|
|
266
|
+
|
|
267
|
+
---
|
|
268
|
+
|
|
269
|
+
## 🦞 Hệ sinh thái OpenClaw (cùng tác giả)
|
|
270
|
+
|
|
271
|
+
Các repo đi kèm để bạn dựng một trợ lý AI "tự vận hành" hoàn chỉnh:
|
|
272
|
+
|
|
273
|
+
**🚀 Cài đặt & khung nền**
|
|
274
|
+
- [openclaw-setup](https://github.com/tuanminhhole/openclaw-setup) — *(repo này)* Setup bot AI miễn phí bằng OpenClaw + 9Router (Telegram/Zalo/Messenger, Docker)
|
|
275
|
+
- [vietbrain](https://github.com/tuanminhhole/vietbrain) — Bộ khung "Bộ Não Thứ Hai" tiếng Việt cho Obsidian (sẵn sàng AI)
|
|
276
|
+
|
|
277
|
+
**🔌 Plugin (runtime)**
|
|
278
|
+
- `openclaw-fb-messenger` — Kênh Facebook Messenger *(riêng tư — liên hệ để nhận)*
|
|
279
|
+
- [openclaw-telegram-multibot-relay](https://github.com/tuanminhhole/openclaw-telegram-multibot-relay) — Multibot Telegram relay, delegation & cron nhắc lịch native
|
|
280
|
+
- [openclaw-zalo-mod](https://github.com/tuanminhhole/openclaw-zalo-mod) — Quản lý nhóm Zalo zero-token (slash command, anti-spam, warn, memory)
|
|
281
|
+
- [openclaw-browser-automation](https://github.com/tuanminhhole/openclaw-browser-automation) — Smart Search & Browser Automation
|
|
282
|
+
- [openclaw-facebook-crawler](https://github.com/tuanminhhole/openclaw-facebook-crawler) — Crawl dữ liệu Facebook
|
|
283
|
+
- [openclaw-n8n-facebook-poster](https://github.com/tuanminhhole/openclaw-n8n-facebook-poster) — Tự động đăng Facebook qua n8n
|
|
284
|
+
|
|
285
|
+
**🧩 Skill**
|
|
286
|
+
- [openclaw-skill-super-memory](https://github.com/tuanminhhole/openclaw-skill-super-memory) — Bộ nhớ nâng cao cho agent
|
|
287
|
+
- [openclaw-skill-infographic](https://github.com/tuanminhhole/openclaw-skill-infographic) — Tạo infographic
|
|
288
|
+
- [openclaw-skill-zalo-sticker-mention](https://github.com/tuanminhhole/openclaw-skill-zalo-sticker-mention) — Sticker & mention trên Zalo
|
|
289
|
+
|
|
290
|
+
---
|
|
291
|
+
|
|
292
|
+
<div align="center">
|
|
293
|
+
<sub>🦞 <b>openclaw-setup</b> · một phần của hệ sinh thái <a href="https://github.com/tuanminhhole">tuanminhhole (Kent)</a> · MIT License</sub>
|
|
294
|
+
</div>
|