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.
- package/CHANGELOG.md +177 -157
- package/CHANGELOG.vi.md +175 -155
- package/README.md +321 -321
- package/README.vi.md +321 -321
- package/cli.js +17 -19
- package/package.json +1 -1
- package/setup.js +16 -5
- package/openclaw_correct_structure.md +0 -203
package/CHANGELOG.vi.md
CHANGED
|
@@ -1,164 +1,184 @@
|
|
|
1
|
-
# Changelog (Tiếng Việt)
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
## [5.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
|
-
- **
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
-
|
|
64
|
-
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
- **Sửa:
|
|
73
|
-
- **Sửa:
|
|
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
|
-
## [5.
|
|
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
|
-
|
|
1
|
+
# Changelog (Tiếng Việt)
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
## [5.4.2] — 2026-04-14
|
|
5
|
+
|
|
6
|
+
### 🐛 Sửa lỗi Script Cài Tự Động (Web Wizard)
|
|
7
|
+
|
|
8
|
+
- **Trùng lặp cài đặt Plugin**: Đã sửa thuật toán bị lỗi khiến plugin Telegram Multi-Bot Relay bị tiêm vào lệnh cài đặt terminal tận hai lần trong các script `setup-openclaw-*.bat/sh`. Điều này khắc phục lỗi crash "plugin already exists" do vòng lặp cài cùng một gói package.
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
## [5.4.1] — 2026-04-14
|
|
12
|
+
|
|
13
|
+
### 🐛 Sửa Lỗi Build Dockerfile
|
|
14
|
+
|
|
15
|
+
- **Phục hồi hỗ trợ Trình duyệt**: Đưa trở lại gói lệnh cài đặt `xvfb` APT và việc thực thi Xvfb quay trong nền (`Xvfb :99 -screen...`) vào Dockerfile `CMD`. Nó giúp các bot chạy Playwright có giao diện headful khởi động mà không bị crash vì thiếu khung màn hình.
|
|
16
|
+
- **Sửa lỗi REST API CORS**: Khôi phục script tiêm dải IP nội bộ lúc runtime. Script này tự động lấy các bridge IP nội bộ của Docker (`172...`) để cấp phép vào mục `allowedOrigins` cho `openclaw.json` ngay lúc container khởi động, sửa hoàn toàn lỗi bị block CORS 403 không vào được Web UI.
|
|
17
|
+
|
|
18
|
+
### 🧹 Tự Động Tạo Script Gỡ Cài Đặt
|
|
19
|
+
|
|
20
|
+
- **Tính Năng Wizard UI**: Giao diện HTML wizard giờ đây sẽ tự động tải thêm một file script dọn dẹp hệ thống (`uninstall-openclaw-*.bat/sh`) mỗi khi tải file cài đặt cho Native hoặc Docker.
|
|
21
|
+
- **Dọn Dẹp Triệt Để**: Các script này giúp dừng sạch sẽ các tiến trình nền của 9Router/OpenClaw, gỡ cài đặt các gói npm toàn cầu và xoá an toàn thư mục project cũng như data `.9router`, giúp bạn làm sạch máy để cài đặt lại dễ dàng.
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
## [5.4.0] — 2026-04-14
|
|
25
|
+
|
|
26
|
+
### 🗑️ Xóa: Kênh Combo Telegram + Zalo
|
|
27
|
+
|
|
28
|
+
- **Tạm ngưng và xóa chế độ `telegram+zalo-personal` khỏi cả Web Wizard lẫn CLI.** Card kênh bị ẩn trong `index.html`, xóa khỏi `channels.js` và `data/index.js`, toàn bộ logic điều kiện liên quan đã được dọn sạch khỏi `controller.js`, `output.js`, `steps.js`, `multi-bot.js`, `win-bat.js`, `macos-sh.js`, `linux-sh.js`, `vps-sh.js`, `native-helpers-gen.js` và `cli.src.js`. Combo mode sẽ được thiết kế lại trong bản phát hành tương lai.
|
|
29
|
+
|
|
30
|
+
### 🏗️ Tái cấu trúc: Kiến Trúc Multi-Bot
|
|
31
|
+
|
|
32
|
+
- **Gộp flag multi-bot** — `isTelegramMultiBot`, `isSharedMultiBot` và `isMultiBotWizard` đã được hợp nhất thành một biến `isMultiBot` duy nhất xuyên suốt codebase. Giảm độ phức tạp và loại bỏ các nhánh code phân kỳ.
|
|
33
|
+
- **Sửa đường dẫn `agentDir`** — `agentDir` trong `openclaw.json` được tạo ra nay được đặt đúng là `.openclaw/agents/{slug}/agent` (tương đối với `OPENCLAW_HOME`). Trước đây dùng đường dẫn sai ở root project gây lỗi double-prefix khi runtime.
|
|
34
|
+
- **Xóa thư mục `agents/` thừa ở gốc project** — OS scripts không còn cố tạo `mkdir agents/` ở root; toàn bộ file agent được tạo trong `.openclaw/agents/`.
|
|
35
|
+
|
|
36
|
+
### 🧹 Dọn Dẹp Config Generation
|
|
37
|
+
|
|
38
|
+
- **Xóa `auth-profiles.json` per-agent khi dùng 9Router/proxy** — Khi provider là proxy, không còn sinh per-agent `auth-profiles.json` nữa. File này chỉ được tạo cho các provider API trực tiếp khi cần xác thực riêng từng agent.
|
|
39
|
+
- **Xóa `.env` trong native deployment** — Token bot và API key cho native mode giờ được quản lý qua `openclaw channels login` / 9Router dashboard. Không còn tự sinh `.env` trong native scripts để tránh rò rỉ credentials.
|
|
40
|
+
- **Xóa `models.json` per-agent cho Ollama (CLI)** — Config model Ollama đã khai báo trong `openclaw.json → agents.defaults.model`. File `models.json` thừa trong `agents/{id}/agent/` không còn được sinh nữa.
|
|
41
|
+
|
|
42
|
+
### 🤝 Quy Tắc Cross-Workspace trong AGENTS.md
|
|
43
|
+
|
|
44
|
+
- **`AGENTS.md` multi-bot có thêm mục "Workspace Chéo"** — Ở chế độ multi-bot (relay), `AGENTS.md` của mỗi bot có thêm mục `🤝 Workspace Chéo (Multi-Agent)` liệt kê đường dẫn workspace của các bot anh em. Quy tắc: bot được phép đọc `IDENTITY`, `SOUL`, `MEMORY` của bot khác để hiểu ngữ cảnh chung; không được xóa hoặc ghi đè file workspace của bot khác trừ khi user yêu cầu rõ ràng.
|
|
45
|
+
|
|
46
|
+
### 🔧 Tái Cấu Trúc win-bat.js
|
|
47
|
+
|
|
48
|
+
- **Tách `appendGatewayStart()` và `appendDashboardInfo()` thành helper riêng** — Các đoạn code khởi động gateway PowerShell và in URL dashboard được lặp đi lặp lại đã được đóng gói vào 2 hàm helper cục bộ trong `generateWinBat`, giảm khoảng 50 dòng code.
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
## [5.3.5] — 2026-04-12
|
|
52
|
+
|
|
53
|
+
### 🐛 Sửa: Lỗi Syntax MEMORY.md trong Workspace Zalo
|
|
54
|
+
|
|
55
|
+
- **Sửa: `SyntaxError: Unexpected token ':'` trong `setup.js`** — Patch TOOLS.md trước đó được chèn sau nhánh `vi` của ternary MEMORY.md, khiến nhánh `: en-value` bị bỏ lơ phía dưới. VS Code hiển thị badge đỏ số "7" trên `setup.js`. Đã fix; hai nhánh MEMORY.md nay liền kề nhau, TOOLS.md theo sau như property riêng biệt.
|
|
56
|
+
|
|
57
|
+
### 🐟 Cải Tiến: Script Gỡ Cài Đặt Nằm Trong Thư Mục Project
|
|
58
|
+
|
|
59
|
+
- **Tất cả 4 luồng native OS + Docker ZIP** giờ đều có sẵn file `uninstall-*.{bat,sh}` **trong thư mục project** ngay sau khi setup chạy xong. Trước đây uninstall chỉ có thể tải riêng từ trình duyệt. Pattern giống `start-chrome-debug.bat` / `.sh`:
|
|
60
|
+
- Windows native: `uninstall-openclaw-win.bat` viết qua `appendBatWriteCommands`
|
|
61
|
+
- macOS native: `uninstall-openclaw.sh` viết qua `appendShWriteCommands`
|
|
62
|
+
- VPS/Ubuntu: `uninstall-openclaw-vps.sh` viết qua `appendShWriteCommands`
|
|
63
|
+
- Linux Desktop: `uninstall-openclaw.sh` viết qua `appendShWriteCommands`
|
|
64
|
+
- Docker (mọi OS): uninstall script có trong ZIP generatedFiles
|
|
65
|
+
|
|
66
|
+
|
|
67
|
+
## [5.3.4] — 2026-04-12
|
|
68
|
+
|
|
69
|
+
### 🐛 Windows Native — Ổn Định Gateway & Workspace
|
|
70
|
+
|
|
71
|
+
- **Sửa: Terminal tự đóng sau khi khởi động gateway** — `call openclaw gateway run` chặn terminal vô thời hạn; đóng cửa sổ khiến gateway chết theo. Gateway giờ được mở trong **cửa sổ CMD riêng biệt** qua PS1 launcher (giống 9Router), setup terminal đóng gọn mà gateway vẫn chạy độc lập.
|
|
72
|
+
- **Sửa: Thiếu `call` trước `openclaw gateway stop`** — Lệnh dừng gateway trước khi khởi động lại thiếu từ khóa `call`, có thể khiến bat script không trả quyền điều hành sau khi stop. Đã thêm `call openclaw gateway stop 2>nul` cho tất cả luồng.
|
|
73
|
+
- **Sửa: Tên workspace** — Single-bot deployment trước đây dùng chung `.openclaw/workspace`. Giờ tất cả agent đều có thư mục riêng theo tên agent ID: `.openclaw/workspace-{agentId}` (ví dụ `workspace-williams`, `workspace-luna`). Tránh xung đột và đồng bộ với cấu trúc `agents/{agentId}`.
|
|
74
|
+
- **Cải tiến: TOOLS.md đầy đủ hơn cho mọi bot** — File `TOOLS.md` được tạo ra giờ bao gồm cả mục danh sách skills + quy ước VÀ section "Ghi chú thiết lập của bạn" theo chuẩn OpenClaw, giúp người dùng có điểm xuất phát rõ ràng để ghi lại cấu hình môi trường riêng.
|
|
75
|
+
- **Cải tiến: AGENTS.md cho Zalo bot bổ sung quy tắc bảo mật** — `AGENTS.md` sinh ra cho bot Zalo Personal (kiểu Luna) giờ có thêm block `🔐 Quy Tắc Bảo Mật — BẮT BUỘC` giống hệt bot Telegram (giới hạn file-system, bảo vệ credentials, ví crypto, mount Docker).
|
|
76
|
+
- **Cải tiến: Thêm TOOLS.md cho Zalo bot** — Workspace của bot Zalo giờ cũng có file `TOOLS.md` cùng cấu trúc với bot Telegram.
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
## [5.3.3] — 2026-04-11
|
|
80
|
+
|
|
81
|
+
### 🧹 Tự Động Tạo Script Gỡ Cài Đặt
|
|
82
|
+
|
|
83
|
+
- **Tính Năng Wizard UI**: Giao diện HTML wizard giờ đây sẽ tự động tải thêm một file script dọn dẹp hệ thống (`uninstall-openclaw-*.bat/sh`) mỗi khi tải file cài đặt cho Native hoặc Docker.
|
|
84
|
+
- **Dọn Dẹp Triệt Để**: Các script này giúp dừng sạch sẽ các tiến trình nền của 9Router/OpenClaw, gỡ cài đặt các gói npm toàn cầu và xoá an toàn thư mục project cũng như data `.9router`, giúp bạn làm sạch máy để cài đặt lại dễ dàng.
|
|
85
|
+
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
## [5.3.2] — 2026-04-11
|
|
89
|
+
|
|
90
|
+
### 🐛 Windows Native — Sửa Lỗi Khởi Động 9Router
|
|
91
|
+
|
|
92
|
+
- **Sửa: Bỏ flag `-l` (chế độ đọc stdin) khỏi lệnh launch 9Router** — `resolveNative9RouterDesktopLaunch()` trước đây truyền `-l` khiến 9Router chạy ở chế độ REPL tương tác. Khi chạy ẩn (không có TTY), tiến trình bị treo chờ stdin mà không bao giờ nhận được. Đã bỏ flag; 9Router giờ khởi động ổn định ở nền trên Windows, macOS desktop và mọi luồng native không phải VPS.
|
|
93
|
+
- **Sửa: Pre-seed `DATA_DIR/.9router/db.json` với `requireLogin: false` trước khi 9Router khởi động** — Nếu `db.json` chưa tồn tại khi 9Router khởi chạy, nó dùng đường dẫn mặc định của riêng mình (`~/.9router`) và đặt `requireLogin` là `true`, gây ra màn hình login khi mở dashboard. CLI wizard giờ tạo thư mục `.9router` và ghi sẵn `db.json` (với `requireLogin: false`) **trước** khi spawn 9Router, khớp với hành vi của file `setup-openclaw-win.bat` đã được sửa.
|
|
94
|
+
- **Không thay đổi luồng PM2/VPS** — Fix chỉ áp dụng cho path spawn nền của desktop (`osChoice !== 'vps'`). Người dùng VPS vẫn dùng luồng PM2 `startNative9RouterPm2` hiện tại, không bị ảnh hưởng.
|
|
95
|
+
|
|
96
|
+
## [5.3.1] — 2026-04-10
|
|
97
|
+
|
|
98
|
+
### 🌟 Đổi Chính Sách Bảo Mật Zalo Personal
|
|
99
|
+
|
|
100
|
+
- **Thả Ga Inbox Zalo Cầm Tay**: Lược bỏ rào cản duyệt bảo mật của Zalo Personal. Thông số `dmPolicy` trên cài đặt Zalo cá nhân đã được chuyển mặc định từ `pairing` sang `open`. Bây giờ bất cứ ai trên mạng lưới Zalo nhắn tin vào tài khoản của Bot đều sẽ được AI tự động tiếp đón ngay lập tức thay vì bị chặn lại chờ bạn duyệt lệnh kết nối E2E!
|
|
101
|
+
|
|
102
|
+
|
|
103
|
+
## [5.3.0] — 2026-04-11
|
|
104
|
+
|
|
105
|
+
### 🆕 Đa Kênh: Telegram + Zalo Personal Cùng Lúc
|
|
106
|
+
|
|
107
|
+
- **Tuỳ chọn kênh combo** — Thêm `telegram+zalo-personal` vào CLI wizard (menu `select`) và web wizard (channel card). Chọn option này để cấu hình 1 bot nhận tin nhắn từ cả Telegram **và** Zalo Personal cùng lúc trong 1 config duy nhất.
|
|
108
|
+
- **Tự inject `plugins.entries.zalouser`** — Khi chọn bất kỳ kênh Zalo Personal nào, `openclaw.json` giờ tự thêm `plugins.entries.zalouser: { enabled: true }`, xử lý nguyên nhân gốc rễ của lỗi "not configured" khi Zalo khởi động.
|
|
109
|
+
- **Fix cold-start Docker tích hợp sẵn** — Script nền `(sleep 45 && node -e '...touch historyLimit...')` giờ được baked thẳng vào Dockerfile CMD được generate. Kích hoạt chokidar → hot-reload gateway → `restartChannel('zalouser')` sau khi Docker network ổn định. Không cần hack `lastTouchedAt` thủ công nữa.
|
|
110
|
+
- **Helper predicates** — Thêm `hasTelegram(ck)` và `hasZaloPersonal(ck)` thay thế tất cả so sánh literal `channelKey === 'telegram/zalo-personal'` trong `cli.js` để dễ mở rộng sau này.
|
|
111
|
+
- **Cập nhật smoke tests** — `tests/smoke-cli-logic.mjs` cập nhật để match logic predicate mới (78 checks passing).
|
|
112
|
+
|
|
113
|
+
## [5.2.3] — 2026-04-10
|
|
114
|
+
|
|
115
|
+
### 🐛 Sửa lỗi & Cải thiện encoding
|
|
116
|
+
|
|
117
|
+
- **Fix: `ReferenceError: projectDir is not defined`** — Crash khi bấm "Generate Configs" ở chế độ multi-bot. Biến `projectDir` không được khai báo trong `buildTelegramPostInstallChecklist()` và là dead code (không dùng trong return). Đã xoá.
|
|
118
|
+
- **Fix: Nút "Tiếp theo" ở Bước 3 bị validate sai** — `state._activeBotTab` là typo của `state.activeBotIndex`, khiến validation multi-bot luôn đọc sai tab index.
|
|
119
|
+
- **Fix: `saveFormData()` luôn lưu tên bot vào `bots[0]`** — Trong multi-bot mode, tên bot đang active bị ghi đè cố định vào `bots[0]` thay vì `bots[state.activeBotIndex]`. Đã sửa.
|
|
120
|
+
- **UX: Hiển thị gợi ý khi nút "Generate Configs" bị khoá** — Khi nút bị disable, một cảnh báo xuất hiện ngay bên dưới cho biết trường nào còn thiếu (ví dụ: "Còn thiếu: GOOGLE_API_KEY").
|
|
121
|
+
- **Fix: Tiếng Việt có dấu trong file `.bat` và `.sh` được tạo ra** — Toàn bộ chuỗi echo/Write-Host tiếng Việt có dấu trong script cài đặt cho Windows và Linux/macOS đã được chuyển về dạng không dấu (ASCII thuần) để tránh lỗi encoding trên các máy không dùng UTF-8.
|
|
122
|
+
|
|
123
|
+
## [5.2.2] — 2026-04-10
|
|
124
|
+
|
|
125
|
+
|
|
126
|
+
### 🐛 Sửa lỗi Docker & Native PM2
|
|
127
|
+
|
|
128
|
+
- **Sửa crash loop Docker (xung đột port socat)**: `socat TCP-LISTEN:18791` chiếm port `0.0.0.0:18791` trước khi `openclaw gateway run` khởi động, gây `EADDRINUSE`. Đã xóa gateway bridge khỏi Dockerfile CMD trong `cli.js` và `setup.js`.
|
|
129
|
+
- **Sửa Dashboard Docker không vào được từ host**: Gateway `bind` đặt là `'loopback'` — Docker port mapping không reach được loopback bên trong container. Khôi phục pattern đúng từ v5.0.9: `bind:'custom', customBindHost:'0.0.0.0'`.
|
|
130
|
+
- **Sửa `delete c.gateway.customBindHost`**: Một lệnh `delete` thừa đang xóa key `customBindHost` ngay sau khi set. Đã xóa dòng đó.
|
|
131
|
+
- **Sửa Docker tải lại npm mỗi lần build**: `ARG CACHEBUST=<timestamp>` bust cache layer `npm install -g openclaw` mỗi lần build dù chỉ đổi config. Thay bằng `ARG OPENCLAW_VER` ổn định theo version — Docker tái sử dụng cache giữa các lần rebuild.
|
|
132
|
+
- **Sửa lồng đôi `.openclaw` trong native PM2**: `ecosystem.config.js` đang đặt `OPENCLAW_HOME: projectDir/.openclaw`, khiến OpenClaw resolve workspace thành `projectDir/.openclaw/.openclaw/workspace`. Đã xóa `OPENCLAW_HOME` khỏi PM2 env; OpenClaw tự tìm config qua `cwd` (khớp với v5.0.9).
|
|
133
|
+
|
|
134
|
+
|
|
135
|
+
## [5.2.1] — 2026-04-09
|
|
136
|
+
|
|
137
|
+
### 🐛 Sửa Lỗi Ubuntu/VPS Native
|
|
138
|
+
|
|
139
|
+
- **Sửa `Bot-9router errored` (PM2 ↺ 15)**: `resolveNative9RouterDesktopLaunch` cố tìm file `9router/app/server.js` trong thư mục npm global — đường dẫn này không tồn tại sau `npm install -g 9router`. Giờ dùng trực tiếp binary `9router` CLI với các tham số đúng (`-n -l -H 0.0.0.0 -p 20128 --skip-update`), loại bỏ hoàn toàn vòng lặp restart.
|
|
140
|
+
- **Sửa đường dẫn workspace bị double `.openclaw`**: `workspace` và `agentDir` trong `openclaw.json` được sinh ra dưới dạng đường dẫn tuyệt đối (ví dụ `/home/user/bot/.openclaw/workspace`). OpenClaw giải quyết các path này tương đối với `OPENCLAW_HOME`, gây ra double-prefix (`/home/user/bot/.openclaw/.openclaw/workspace`). Đã chuyển sang path tương đối (`workspace`, `agents/<id>/agent`) giống Docker mode.
|
|
141
|
+
- **Sửa thiếu runtime packages khi cài native**: `grammy`, `@grammyjs/runner`, `@grammyjs/transformer-throttler`, `@buape/carbon`, `@larksuiteoapi/node-sdk`, `@slack/web-api` được cài trong Docker (Dockerfile) nhưng bỏ qua ở native. `installLatestOpenClaw` giờ cài toàn bộ `OPENCLAW_RUNTIME_PACKAGES` sau binary chính.
|
|
142
|
+
- **Sửa `openclaw: command not found` sau khi cài**: Hướng dẫn login Zalo sau setup giờ có thêm gợi ý `source ~/.bashrc && source ~/.profile` cho terminal mới trên Linux.
|
|
143
|
+
- **Sửa Zalo session lưu sai thư mục**: Lệnh login thủ công giờ bao gồm env vars `OPENCLAW_HOME` và `OPENCLAW_STATE_DIR` để session được lưu vào `<projectDir>/.openclaw/credentials/zalouser/` — đúng chỗ gateway PM2 đọc.
|
|
144
|
+
- **Sửa đường dẫn project tương đối**: Input `projectDir` giờ được chuẩn hóa bằng `path.resolve()` để gõ `home/ubuntu/bot` (thiếu `/` đầu) tự động thành `/home/ubuntu/bot`.
|
|
145
|
+
|
|
146
|
+
|
|
147
|
+
## [5.2.0] — 2026-04-09
|
|
148
|
+
|
|
149
|
+
### Upgrade 1 Lệnh (Không Cần Chạy Lại Wizard)
|
|
150
|
+
|
|
151
|
+
- Thêm subcommand `upgrade` vào CLI: `npx create-openclaw-bot@latest upgrade`. Tự nhận diện Docker hay Native/PM2 và cập nhật OpenClaw mà không cần chạy lại wizard.
|
|
152
|
+
- Thêm `upgrade.ps1` cho Windows — nhấp đúp trong thư mục bot là tự động upgrade. Không cần biết terminal.
|
|
153
|
+
- Thêm `upgrade.sh` cho Linux / macOS / Ubuntu — `bash upgrade.sh` hoặc pipe trực tiếp qua `curl`/`wget` từ GitHub.
|
|
154
|
+
- Toàn bộ dữ liệu người dùng giữ nguyên: `.env`, `.openclaw/memory/`, sessions, credentials, OAuth token 9Router không bao giờ bị xoá.
|
|
155
|
+
- Docker mode: vá `Dockerfile` (cập nhật `OPENCLAW_NPM_SPEC` + `CACHEBUST`) → `docker compose build --no-cache` + `docker compose up -d`.
|
|
156
|
+
- Native/PM2 mode: cài lại `openclaw` + `9router` global → `pm2 restart all`.
|
|
157
|
+
|
|
158
|
+
|
|
159
|
+
## [5.1.15] — 2026-04-08
|
|
160
|
+
|
|
161
|
+
### Dong Bo Native Setup & Sua Loi Wizard Windows
|
|
162
|
+
|
|
163
|
+
- Sua wizard HTML tren Windows native de file `.bat` tai ve luon duoc regenerate theo state moi nhat truoc khi download.
|
|
164
|
+
- Sua toan bo runtime path tren Windows native theo project dir nguoi dung nhap: `.env`, `.openclaw` va `.9router` khong con roi ve home/AppData.
|
|
165
|
+
- Them `OPENCLAW_STATE_DIR` vao native runtime env de OpenClaw doc dung config duoc sinh trong thu muc project.
|
|
166
|
+
- Chong format config legacy `gateway.bind: "0.0.0.0"` va chuyen sang `bind: "custom"` + `customBindHost: "0.0.0.0"`.
|
|
167
|
+
- Sua luong single-bot tren Windows native de provider, model, API key va Telegram bot token tu wizard duoc sync dung vao `.env` va `openclaw.json`.
|
|
168
|
+
- Sua native Windows 9Router path resolution va doi helper sync `smart-route` sang lay active providers tu API song cua `9Router`, khop voi logic Docker.
|
|
169
|
+
- Bu native parity cho skill/runtime tren Windows: skill duoc cai tu dong, browser automation tu cai runtime can thiet, va `skills.entries` dung dung `slug`.
|
|
170
|
+
- Cap nhat native script cho macOS, Linux Desktop va Ubuntu/VPS de chay tu `PROJECT_DIR` duoc chon va export `OPENCLAW_HOME`, `OPENCLAW_STATE_DIR`, `DATA_DIR` theo project-local.
|
|
151
171
|
- Mo rong smoke test cho runtime path native, 9Router sync, provider/token sync, browser install va luong startup project-local tren Unix.
|
|
152
172
|
|
|
153
173
|
## [5.1.14] — 2026-04-08
|
|
154
174
|
|
|
155
175
|
### Sá»a lá»—i ổn định OpenClaw và Docker
|
|
156
176
|
|
|
157
|
-
- Pin lại OpenClaw vá» `openclaw@2026.4.5` vì bản cáºp nháºt ngà y `08/04/2026` Ä‘ang lá»—i.
|
|
158
|
-
- Sá»a Dockerfile cho các case Docker trên Windows để tránh lá»—i startup do escape command sai và lá»—i `allowedOrigins`.
|
|
159
|
-
- Thêm ghi chú khuyên dùng `Node.js 20` đến `24`, tạm tránh `Node.js 25` để ổn định hơn với OpenClaw.
|
|
160
|
-
|
|
161
|
-
## [5.1.13] — 2026-04-08
|
|
177
|
+
- Pin lại OpenClaw vá» `openclaw@2026.4.5` vì bản cáºp nháºt ngà y `08/04/2026` Ä‘ang lá»—i.
|
|
178
|
+
- Sá»a Dockerfile cho các case Docker trên Windows để tránh lá»—i startup do escape command sai và lá»—i `allowedOrigins`.
|
|
179
|
+
- Thêm ghi chú khuyên dùng `Node.js 20` đến `24`, tạm tránh `Node.js 25` để ổn định hơn với OpenClaw.
|
|
180
|
+
|
|
181
|
+
## [5.1.13] — 2026-04-08
|
|
162
182
|
|
|
163
183
|
### 🛠Sá»a lá»—i cà i macOS & ổn định Wizard
|
|
164
184
|
|