create-openclaw-bot 5.7.4 → 5.7.6
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 +9 -13
- package/README.vi.md +40 -44
- package/dist/cli.js +210 -210
- package/dist/setup/shared/docker-gen.js +1 -13
- package/dist/setup.js +1 -13
- package/package.json +39 -39
package/README.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
# 🦞 OpenClaw Setup
|
|
4
4
|
|
|
5
5
|
<p align="center">
|
|
6
|
-
<a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.7.
|
|
6
|
+
<a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.7.6-0EA5E9?style=for-the-badge" alt="Version 5.7.6" /></a>
|
|
7
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
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
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>
|
|
@@ -24,7 +24,13 @@ An interactive **CLI tool** and **Setup Wizard** to deploy your own free AI Bot
|
|
|
24
24
|
|
|
25
25
|
---
|
|
26
26
|
|
|
27
|
-
## 🆕 What's new in v5.7.
|
|
27
|
+
## 🆕 What's new in v5.7.5
|
|
28
|
+
|
|
29
|
+
- 🐛 **Hotfix: CLI crash on all platforms** — Fixed `ReferenceError: channelKey is not defined` that caused the CLI to crash immediately after completing the setup wizard on every platform (Telegram, Zalo). The `writeWorkspaceFiles()` function now correctly receives `channelKey` as an explicit parameter.
|
|
30
|
+
- 🔤 **Fix: Vietnamese text encoding** — Restored proper UTF-8 encoding integrity in `cli.src.js` to prevent double-encoding of Vietnamese characters from Windows tools.
|
|
31
|
+
|
|
32
|
+
<details>
|
|
33
|
+
<summary><b>Previous: What's new in v5.7.2</b></summary>
|
|
28
34
|
|
|
29
35
|
- 🏗️ **Centralized config architecture** — All `openclaw.json`, `.env`, and `exec-approvals.json` generation now flows through a single `bot-config-gen.js` module. Both the Web Wizard and CLI share the same builder, eliminating config drift between surfaces.
|
|
30
36
|
- 🔄 **Rolling `@latest` versioning** — Installation scripts now use `openclaw@latest` instead of pinned versions, ensuring users always get the newest release without waiting for a setup update.
|
|
@@ -32,17 +38,7 @@ An interactive **CLI tool** and **Setup Wizard** to deploy your own free AI Bot
|
|
|
32
38
|
- 🐛 **Removed `autoReply` bug** — The `autoReply: true` field that caused gateway startup crashes on Zalo Personal has been permanently removed from all generators.
|
|
33
39
|
- 💬 **Standardized Zalo Personal config** — Zalo Personal (`zalouser`) channel now uses production-matching config with `groups`, `groupPolicy`, `historyLimit`, and proper `bindings`.
|
|
34
40
|
|
|
35
|
-
|
|
36
|
-
<summary><b>Previous: What's new in v5.7.2</b></summary>
|
|
37
|
-
|
|
38
|
-
- 🔧 **OpenAI Codex provider fix** — Updated Codex model registry to match OpenAI's current API. Removed 6 deprecated models, retained 4 active ones: `gpt-5.4`, `gpt-5.3-codex`, `gpt-5.2`, `gpt-5.4-mini`.
|
|
39
|
-
- 🔀 **9Router API mode switch** — Switched from `openai-completions` to `openai-responses` to align with OpenAI's Responses API.
|
|
40
|
-
- 🩹 **Auto-patch 9Router** — New `patch-9router.js` automatically patches 9Router source files on setup, upgrade, and before every launch to stay compatible with Codex API changes.
|
|
41
|
-
- 🎯 **Direct Codex model targeting** — 9Router config now exposes individual Codex models alongside `smart-route` so users can pick a specific model.
|
|
42
|
-
|
|
43
|
-
</details>
|
|
44
|
-
|
|
45
|
-
---
|
|
41
|
+
## </details>
|
|
46
42
|
|
|
47
43
|
## ✨ Features
|
|
48
44
|
|
package/README.vi.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
# 🦞 OpenClaw Setup
|
|
4
4
|
|
|
5
5
|
<p align="center">
|
|
6
|
-
<a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.7.
|
|
6
|
+
<a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.7.6-0EA5E9?style=for-the-badge" alt="Version 5.7.6" /></a>
|
|
7
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
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
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>
|
|
@@ -24,7 +24,13 @@ Công cụ **CLI tương tác** và **Setup Wizard** để tự triển khai Bot
|
|
|
24
24
|
|
|
25
25
|
---
|
|
26
26
|
|
|
27
|
-
## 🆕 Có gì mới trong v5.7.
|
|
27
|
+
## 🆕 Có gì mới trong v5.7.5
|
|
28
|
+
|
|
29
|
+
- 🐛 **Hotfix: CLI crash trên mọi nền tảng** — Sửa lỗi `ReferenceError: channelKey is not defined` khiến CLI crash ngay sau khi hoàn thành wizard trên mọi nền tảng (Telegram, Zalo). Hàm `writeWorkspaceFiles()` giờ nhận `channelKey` như một tham số tường minh.
|
|
30
|
+
- 🔤 **Sửa: Encoding tiếng Việt trong CLI** — Khôi phục tính toàn vẹn UTF-8 trong `cli.src.js`, ngăn double-encoding ký tự tiếng Việt do công cụ Windows gây ra.
|
|
31
|
+
|
|
32
|
+
<details>
|
|
33
|
+
<summary><b>Trước đó: Có gì mới ở v5.7.2</b></summary>
|
|
28
34
|
|
|
29
35
|
- 🏗️ **Kiến trúc config tập trung** — Toàn bộ logic tạo `openclaw.json`, `.env`, và `exec-approvals.json` giờ chạy qua module duy nhất `bot-config-gen.js`. Cả Web Wizard và CLI dùng chung cùng một builder, loại bỏ sai lệch config giữa 2 bề mặt.
|
|
30
36
|
- 🔄 **Phiên bản rolling `@latest`** — Script cài đặt giờ dùng `openclaw@latest` thay vì version cố định, đảm bảo người dùng luôn nhận bản mới nhất.
|
|
@@ -32,17 +38,7 @@ Công cụ **CLI tương tác** và **Setup Wizard** để tự triển khai Bot
|
|
|
32
38
|
- 🐛 **Xóa lỗi `autoReply`** — Trường `autoReply: true` gây crash gateway khi khởi động Zalo Personal đã bị loại bỏ vĩnh viễn khỏi mọi generator.
|
|
33
39
|
- 💬 **Chuẩn hóa config Zalo Personal** — Kênh Zalo Personal (`zalouser`) giờ dùng config khớp production với `groups`, `groupPolicy`, `historyLimit`, và `bindings` đúng.
|
|
34
40
|
|
|
35
|
-
|
|
36
|
-
<summary><b>Trước đó: Có gì mới ở v5.7.2</b></summary>
|
|
37
|
-
|
|
38
|
-
- 🔧 **Sửa provider OpenAI Codex** — Cập nhật registry model Codex phù hợp API hiện tại của OpenAI. Loại 6 model đã dừng, giữ 4 model đang hoạt động: `gpt-5.4`, `gpt-5.3-codex`, `gpt-5.2`, `gpt-5.4-mini`.
|
|
39
|
-
- 🔀 **Chuyển chế độ API 9Router** — Đổi từ `openai-completions` sang `openai-responses` cho khớp với Responses API mới của OpenAI.
|
|
40
|
-
- 🩹 **Tự động patch 9Router** — Script `patch-9router.js` mới tự vá source files 9Router khi setup, upgrade và trước mỗi lần khởi động để tương thích thay đổi API Codex.
|
|
41
|
-
- 🎯 **Chọn model Codex trực tiếp** — Config 9Router giờ hiển thị từng model Codex bên cạnh `smart-route` để người dùng có thể chọn model cụ thể.
|
|
42
|
-
|
|
43
|
-
</details>
|
|
44
|
-
|
|
45
|
-
---
|
|
41
|
+
## </details>
|
|
46
42
|
|
|
47
43
|
## ✨ Tính năng
|
|
48
44
|
|
|
@@ -64,12 +60,12 @@ Công cụ **CLI tương tác** và **Setup Wizard** để tự triển khai Bot
|
|
|
64
60
|
|
|
65
61
|
> **Không biết nên dùng cách nào?** Bảng dưới đây sẽ giúp bạn:
|
|
66
62
|
|
|
67
|
-
| Bạn là ai
|
|
68
|
-
|
|
|
69
|
-
| Không quen terminal
|
|
70
|
-
| Không quen terminal
|
|
71
|
-
| Quen terminal
|
|
72
|
-
| Muốn tự động hóa hoàn toàn | Bất kỳ
|
|
63
|
+
| Bạn là ai | Môi trường | Cách được đề xuất |
|
|
64
|
+
| -------------------------- | --------------- | ------------------------------------- |
|
|
65
|
+
| Không quen terminal | Windows / macOS | **Web Wizard** (`index.html`) |
|
|
66
|
+
| Không quen terminal | Ubuntu Desktop | **Web Wizard** → chọn Native |
|
|
67
|
+
| Quen terminal | Ubuntu / VPS | **CLI** (`npx create-openclaw-bot`) |
|
|
68
|
+
| Muốn tự động hóa hoàn toàn | Bất kỳ | **AI Agent** (Antigravity + SETUP.md) |
|
|
73
69
|
|
|
74
70
|
### 1️⃣ Tùy chọn A — Web Wizard (không cần terminal)
|
|
75
71
|
|
|
@@ -125,34 +121,34 @@ Chạy trong terminal → làm theo hướng dẫn → script khởi động đ
|
|
|
125
121
|
|
|
126
122
|
### Không dùng Docker (Native — khuyến nghị cho Ubuntu/VPS)
|
|
127
123
|
|
|
128
|
-
| Yêu cầu
|
|
129
|
-
|
|
|
130
|
-
| **Node.js 20/22/24**
|
|
131
|
-
| **AI provider**
|
|
132
|
-
| **Bot Token**
|
|
133
|
-
| **Ollama** _(tùy chọn)_ | Chỉ cần nếu muốn chạy Gemma 4 locally · [Tải](https://ollama.com/)
|
|
124
|
+
| Yêu cầu | Ghi chú |
|
|
125
|
+
| ----------------------- | ------------------------------------------------------------------------- |
|
|
126
|
+
| **Node.js 20/22/24** | [Tải](https://nodejs.org/) · Kiểm tra: `node -v` · Tránh Node 25 hiện tại |
|
|
127
|
+
| **AI provider** | 9Router (miễn phí) hoặc Gemini/Claude/GPT-4o |
|
|
128
|
+
| **Bot Token** | Từ Telegram BotFather hoặc Zalo Developer |
|
|
129
|
+
| **Ollama** _(tùy chọn)_ | Chỉ cần nếu muốn chạy Gemma 4 locally · [Tải](https://ollama.com/) |
|
|
134
130
|
|
|
135
131
|
### Dùng Docker (khuyến nghị cho Windows/macOS)
|
|
136
132
|
|
|
137
|
-
| Yêu cầu
|
|
138
|
-
|
|
|
139
|
-
| **Node.js 20/22/24**
|
|
133
|
+
| Yêu cầu | Ghi chú |
|
|
134
|
+
| ------------------------------- | ------------------------------------------------------------------------------------------- |
|
|
135
|
+
| **Node.js 20/22/24** | [Tải](https://nodejs.org/) · Kiểm tra: `node -v` · Tránh Node 25 hiện tại |
|
|
140
136
|
| **Docker Desktop + Compose V2** | [Tải](https://www.docker.com/products/docker-desktop/) · Kiểm tra: `docker compose version` |
|
|
141
|
-
| **AI provider**
|
|
142
|
-
| **Bot Token**
|
|
137
|
+
| **AI provider** | 9Router chạy như container sidecar — không cần cài riêng |
|
|
138
|
+
| **Bot Token** | Từ Telegram BotFather hoặc Zalo Developer |
|
|
143
139
|
|
|
144
140
|
---
|
|
145
141
|
|
|
146
142
|
## 🧠 Các Provider AI được hỗ trợ
|
|
147
143
|
|
|
148
|
-
| Provider
|
|
149
|
-
|
|
|
150
|
-
| **9Router**
|
|
151
|
-
| **Google Gemini**
|
|
152
|
-
| **Ollama / Gemma 4** | 🏠 Miễn phí
|
|
153
|
-
| **Anthropic Claude** | 💰 Trả phí
|
|
154
|
-
| **OpenAI / Codex**
|
|
155
|
-
| **OpenRouter**
|
|
144
|
+
| Provider | Chi phí | API Key | Ghi chú |
|
|
145
|
+
| -------------------- | ------------- | -------- | ----------------------------------------------------------------------------------------- |
|
|
146
|
+
| **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. |
|
|
147
|
+
| **Google Gemini** | 🆓 Free tier | ✅ Có | Chất lượng cao. Free tier rất rộng rãi. |
|
|
148
|
+
| **Ollama / Gemma 4** | 🏠 Miễn phí | ❌ Không | Chạy 100% offline. Tự pull model khi khởi động lần đầu. |
|
|
149
|
+
| **Anthropic Claude** | 💰 Trả phí | ✅ Có | Chất lượng suy luận và viết tốt nhất. |
|
|
150
|
+
| **OpenAI / Codex** | 💰 Trả phí | ✅ Có | GPT-4o, Codex Mini. |
|
|
151
|
+
| **OpenRouter** | 🆓/💰 Hỗn hợp | ✅ Có | Nhiều model chung một key. Một số miễn phí. |
|
|
156
152
|
|
|
157
153
|
> 🔀 **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.
|
|
158
154
|
|
|
@@ -268,12 +264,12 @@ API key của bạn chỉ được lưu trên máy trong file `.env` cục bộ.
|
|
|
268
264
|
<details>
|
|
269
265
|
<summary><b>Cần bao nhiêu RAM cho Gemma 4?</b></summary>
|
|
270
266
|
|
|
271
|
-
| Model
|
|
272
|
-
|
|
|
273
|
-
| `gemma4:e2b` | ~4 GB
|
|
274
|
-
| `gemma4:e4b` | ~8 GB
|
|
275
|
-
| `gemma4:26b` | ~18 GB
|
|
276
|
-
| `gemma4:31b` | ~24 GB
|
|
267
|
+
| Model | RAM tối thiểu (Native) | RAM tối thiểu (Docker) |
|
|
268
|
+
| ------------ | ---------------------- | ---------------------- |
|
|
269
|
+
| `gemma4:e2b` | ~4 GB | ~5 GB |
|
|
270
|
+
| `gemma4:e4b` | ~8 GB | ~9 GB |
|
|
271
|
+
| `gemma4:26b` | ~18 GB | ~20 GB |
|
|
272
|
+
| `gemma4:31b` | ~24 GB | ~26 GB |
|
|
277
273
|
|
|
278
274
|
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.
|
|
279
275
|
|