create-openclaw-bot 5.11.0 → 5.12.0

package/README.md

@@ -7,7 +7,7 @@
 *Run one command → open the dashboard → your bot is live. Windows · macOS · Linux · VPS — Docker-powered, auto-installed for you.*
 
 <p align="center">
-  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.11.0-0EA5E9?style=for-the-badge" alt="Version 5.11.0" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.12.0-0EA5E9?style=for-the-badge" alt="Version 5.12.0" /></a>
   <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>
   <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>
   <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>
@@ -27,12 +27,29 @@
 
 ---
 
-## 🆕 What's New in v5.11.0
+## 🆕 What's New in v5.12.0
+
+- 💬 **OpenClaw Zalo Connect, ready in one click**: create a personal Zalo bot or press **Zalo Login** and Setup prepares the channel automatically, then opens the QR flow in the dashboard.
+- ⚡ **Install once, reconnect faster**: an existing Zalo Connect installation is reused instead of being downloaded again on every login or restart.
+- ✨ **Cleaner native Zalo experience**: group mentions, reactions and moderation now run through one maintained Zalo runtime; the retired integration and Sticker add-on are gone from Setup.
+
+<details>
+<summary><b>Previous: What's new in v5.11.1</b></summary>
+
+- 📄 **Workspace defaults, rebuilt on OpenClaw's canonical files**: new bots get all 7 upstream default workspace files (`AGENTS`/`BOOTSTRAP`/`HEARTBEAT`/`IDENTITY`/`SOUL`/`TOOLS`/`USER.md`) as the base, with this project's extra rules appended as clearly-marked add-ons — VI + EN, every bot variant.
+- 🗄️ **SQLite "disk I/O error" on Docker Desktop — fixed**: `.openclaw/state` now lives in a named volume on macOS/Windows (WAL locking doesn't survive virtiofs); Linux/VPS keeps the bind mount.
+
+</details>
+
+<details>
+<summary><b>Previous: What's new in v5.11.0</b></summary>
 
 - 🚀 **Facebook Messenger, 1-click**: the `fb-messenger` plugin is now **public on ClawHub** and installs straight from the dashboard — create a Messenger bot, open **Bot → Plugins**, and hit **Install** on the `openclaw-fb-messenger` card. Webhook + Graph API, auto User→Page token, HMAC verify.
 - 🐳 **Docker-only, rock-solid**: dropped the native (non-Docker) install path to focus on the Docker flow that runs flawlessly and stably across Windows / macOS / Linux / VPS, with cross-OS Docker auto-install.
 - 🖥️ **Chrome-debug on headless VPS**: the browser-automation Chrome-debug relay now works on a headless VPS (bridge-IP-scoped, auto-opens ufw); the bot file editor also saves non-`.md` text files.
 
+</details>
+
 <details>
 <summary><b>Previous: What's new in v5.10.1</b></summary>
 
@@ -79,11 +96,6 @@
 <summary><b>Previous: What's new in v5.8.22</b></summary>
 
 - **Infographic Poster Generator Skill**: Integrates automatic infographic and poster generation via 9Router API. Automatically generates the helper script `image-generator.js` (synchronizing API credentials from `openclaw.json`) and a comprehensive `SKILL.md` guiding agents on styling rules, Vietnamese font support, layouts, and image generation syntax.
-- **Zalo Sticker & Auto-Tag Skill**:
-  - Automatically mentions the active sender in group chats (Agent doesn't need to manually prefix with `@Name` anymore, the system handles it).
-  - Enables agents to dynamically send Zalo stickers by appending `[Sticker: <keyword>]` at the end of their text responses.
-  - Automatically maps emotional keywords (such as `love`, `haha`, `ca khia`, `angry`, `thank you`, etc.) to Zalo sticker IDs.
-  - Generates the patch script `mentions.js` and a dedicated `SKILL.md` inside the agent's workspace.
 - **Polish: Simplified TOOLS.md generation**: Streamlined the `TOOLS.md` generator to output a concise, static guide focusing on general principles and referencing the `./skills/` directory.
 - **Polish: Standardized Reference Docs list in AGENTS.md**: Updated the reference docs list in the generated `AGENTS.md` (for both single and relay variants in Vietnamese and English) to match the new structure, removing obsolete files (`TEAMS.md` for single-bot, `BROWSER.md`) and standardizing descriptions to keep exactly 9 core documents.
 
@@ -107,15 +119,25 @@
 
 ### 1️⃣ Method 1 — Quick install (Recommended)
 
-Open your terminal and run this single command (works on macOS, Linux & Windows — needs Node.js ≥ 22):
+Open your terminal and run this single command (works on macOS, Linux & Windows — needs Node.js 24 LTS):
 
 ```bash
-npx github:tuanminhhole/openclaw-setup
+npx create-openclaw-bot
 ```
 
 It downloads the wizard, starts the local server, and opens the Setup UI in your browser at **http://127.0.0.1:51789**.
 
-### 2️⃣ Method 2 — Manual clone (for developers)
+### 2️⃣ Method 2 — Run the newest GitHub source
+
+Use this if you specifically want the newest code directly from GitHub:
+
+```bash
+npx github:tuanminhhole/openclaw-setup
+```
+
+> **Git is required for this method.** Install [Git](https://git-scm.com/downloads) and make sure the `git` command works in your terminal first; otherwise npm cannot download the GitHub repository.
+
+### 3️⃣ Method 3 — Manual clone (for developers)
 
 For contributors who want the full source. Run each line in order:
 
@@ -128,38 +150,19 @@ npm start
 
 Then open **http://127.0.0.1:51789** if the browser doesn't open by itself.
 
-> ⚠️ `npm install` / `npm start` only work **inside the cloned `openclaw-setup` folder**. If you used Method 1 (npx), you did **not** clone the repo — use the reopen command below instead.
+> ⚠️ `npm install` / `npm start` only work **inside the cloned `openclaw-setup` folder**. If you used either npx method, simply run the same npx command again when you want to reopen Setup.
 
 ### 🔁 Reopen the UI later
 
-The **first launch automatically creates a short `openclaw-ui` command** for your OS (zsh/bash on macOS & Linux, PowerShell on Windows). Next time, just open a **new** terminal and run:
-
-```bash
-openclaw-ui
-```
-
-<details>
-<summary>Manual command (fallback — also no re-download)</summary>
+Run the recommended command again. Setup detects and reopens your existing project:
 
 ```bash
-# macOS / Linux
-OPENCLAW_SETUP_WIZARD=true node ~/.openclaw-setup/node_modules/create-openclaw-bot/dist/cli.js
+npx create-openclaw-bot
 ```
 
-```powershell
-# Windows (PowerShell)
-$env:OPENCLAW_SETUP_WIZARD="true"; node "$env:USERPROFILE\.openclaw-setup\node_modules\create-openclaw-bot\dist\cli.js"
-```
-
-</details>
-
 ### ⬆️ Update to the newest version
 
-Click **Update** in the dashboard — it pulls the latest and **auto-restarts the UI** for you (the tab reconnects on its own). Or from the terminal, just re-run the command — it always fetches the latest from GitHub:
-
-```bash
-npx github:tuanminhhole/openclaw-setup
-```
+Click **Update** in the **top-right corner of the Setup interface**. It downloads the newest version and restarts the UI automatically; the current browser tab reconnects on its own.
 
 ---
 
@@ -261,11 +264,12 @@ Yes. You can edit the config JSON directly via the integrated File Editor in the
 
 ---
 
-## 📈 Star History
+## ⭐ Repository Stars
 
 <div align="center">
 
-[![Star History Chart](https://starchart.cc/tuanminhhole/openclaw-setup.svg?variant=adaptive)](https://starchart.cc/tuanminhhole/openclaw-setup)
+<a href="https://github.com/tuanminhhole/openclaw-setup/stargazers"><img src="https://img.shields.io/github/stars/tuanminhhole/openclaw-setup?style=for-the-badge&logo=github&color=eab308" alt="GitHub Stars" /></a>
+<a href="https://github.com/tuanminhhole/openclaw-setup/forks"><img src="https://img.shields.io/github/forks/tuanminhhole/openclaw-setup?style=for-the-badge&logo=github&color=0ea5e9" alt="GitHub Forks" /></a>
 
 </div>
 
@@ -298,6 +302,7 @@ Companion repos to build a complete, self-running AI assistant:
 **🔌 Plugins (runtime)**
 - [openclaw-fb-messenger](https://github.com/tuanminhhole/openclaw-fb-messenger) — Facebook Messenger channel (webhook + Graph API), installable from the Setup UI
 - [openclaw-telegram-multibot-relay](https://github.com/tuanminhhole/openclaw-telegram-multibot-relay) — Multibot Telegram relay, delegation & native cron reminders
+- [openclaw-zalo-connect](https://github.com/tuanminhhole/openclaw-zalo-connect) — Personal Zalo channel/runtime with QR login, native mentions and group actions
 - [openclaw-zalo-mod](https://github.com/tuanminhhole/openclaw-zalo-mod) — Zero-token Zalo group management (slash commands, anti-spam, warn, memory)
 - [openclaw-browser-automation](https://github.com/tuanminhhole/openclaw-browser-automation) — Smart Search & Browser Automation
 - [openclaw-facebook-crawler](https://github.com/tuanminhhole/openclaw-facebook-crawler) — Facebook data crawler
@@ -306,7 +311,6 @@ Companion repos to build a complete, self-running AI assistant:
 **🧩 Skills**
 - [openclaw-skill-learning-memory](https://github.com/tuanminhhole/openclaw-skill-learning-memory) — Self-evolving long-term memory for agents
 - [openclaw-skill-infographic](https://github.com/tuanminhhole/openclaw-skill-infographic) — Infographic generation
-- [openclaw-skill-zalo-sticker-mention](https://github.com/tuanminhhole/openclaw-skill-zalo-sticker-mention) — Stickers & mentions on Zalo
 
 ---
 

package/README.vi.md

@@ -7,7 +7,7 @@
 *Chạy một lệnh → mở dashboard → bot lên sóng. Windows · macOS · Linux · VPS — chạy trên Docker, tự cài giúp bạn.*
 
 <p align="center">
-  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.11.0-0EA5E9?style=for-the-badge" alt="Version 5.11.0" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.12.0-0EA5E9?style=for-the-badge" alt="Version 5.12.0" /></a>
   <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>
   <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>
   <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>
@@ -27,12 +27,29 @@
 
 ---
 
-## 🆕 Có gì mới trong v5.11.0
+## 🆕 Có gì mới trong v5.12.0
+
+- 💬 **OpenClaw Zalo Connect, sẵn sàng trong một chạm**: tạo bot Zalo cá nhân hoặc bấm **Đăng nhập Zalo**, Setup tự chuẩn bị channel rồi mở luồng quét QR ngay trên dashboard.
+- ⚡ **Cài một lần, kết nối lại nhanh hơn**: nếu Zalo Connect đã có, Setup dùng lại bản hiện tại thay vì tải lại mỗi lần đăng nhập hay restart.
+- ✨ **Trải nghiệm Zalo native gọn hơn**: mention nhóm, reaction và quản trị dùng chung một Zalo runtime được duy trì; luồng tích hợp cũ và tiện ích Sticker đã được gỡ khỏi Setup.
+
+<details>
+<summary><b>Trước đó: Có gì mới trong v5.11.1</b></summary>
+
+- 📄 **Workspace mặc định dựng lại theo bộ file chuẩn OpenClaw**: bot tạo mới nhận đủ 7 file workspace gốc (`AGENTS`/`BOOTSTRAP`/`HEARTBEAT`/`IDENTITY`/`SOUL`/`TOOLS`/`USER.md`) làm khung, quy tắc riêng của dự án gắn thành mục bổ sung đánh dấu rõ — đủ VI + EN, mọi kiểu bot.
+- 🗄️ **Hết lỗi SQLite "disk I/O error" trên Docker Desktop**: `.openclaw/state` chuyển sang named volume trên macOS/Windows (khóa WAL không sống nổi qua virtiofs); Linux/VPS vẫn bind mount như cũ.
+
+</details>
+
+<details>
+<summary><b>Trước đó: Có gì mới trong v5.11.0</b></summary>
 
 - 🚀 **Facebook Messenger, cài 1 chạm**: plugin `fb-messenger` giờ đã **public trên ClawHub** và cài ngay trên dashboard — tạo bot Messenger, mở **Bot → Plugins**, bấm **Cài** ở thẻ `openclaw-fb-messenger`. Webhook + Graph API, tự đổi User→Page token, xác minh HMAC.
 - 🐳 **Chỉ còn Docker, cực ổn định**: loại bỏ kiểu cài native (không Docker) để tập trung cho luồng Docker chạy hoàn hảo & ổn định trên Windows / macOS / Linux / VPS, kèm tự cài Docker đa hệ điều hành.
 - 🖥️ **Chrome-debug trên VPS headless**: relay Chrome-debug của browser-automation giờ chạy được trên VPS headless (giới hạn theo bridge-IP, tự mở ufw); trình sửa file bot cũng lưu được file text không phải `.md`.
 
+</details>
+
 <details>
 <summary><b>Trước đó: Có gì mới trong v5.10.1</b></summary>
 
@@ -79,11 +96,6 @@
 <summary><b>Trước đó: Có gì mới trong v5.8.22</b></summary>
 
 - **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.
-- **Hỗ trợ Skill Sticker & Auto-Tag (Zalo)**:
-  - 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).
-  - 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.
-  - 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.
-  - Tự động sinh script vá logic `mentions.js` và tài liệu hướng dẫn `SKILL.md` trong workspace.
 - **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.
 - **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ả.
 
@@ -107,15 +119,25 @@
 
 ### 1️⃣ Cách 1 — Cài nhanh (Khuyên dùng)
 
-Mở terminal và chạy đúng một lệnh (chạy trên macOS, Linux & Windows — cần Node.js ≥ 22):
+Mở terminal và chạy đúng một lệnh (chạy trên macOS, Linux & Windows — cần Node.js 24 LTS):
 
 ```bash
-npx github:tuanminhhole/openclaw-setup
+npx create-openclaw-bot
 ```
 
 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**.
 
-### 2️⃣ Cách 2 — Clone thủ công (dành cho developer)
+### 2️⃣ Cách 2 — Chạy mã mới nhất trực tiếp từ GitHub
+
+Dùng cách này nếu bạn muốn lấy code mới nhất trực tiếp từ GitHub:
+
+```bash
+npx github:tuanminhhole/openclaw-setup
+```
+
+> **Cách này bắt buộc máy phải cài Git.** Hãy cài [Git](https://git-scm.com/downloads) và kiểm tra lệnh `git` chạy được trong terminal trước; nếu thiếu Git, npm không thể tải repository từ GitHub.
+
+### 3️⃣ Cách 3 — Clone thủ công (dành cho developer)
 
 Dành cho người muốn lấy full source. Chạy lần lượt từng dòng:
 
@@ -128,38 +150,19 @@ npm start
 
 Sau đó mở **http://127.0.0.1:51789** nếu trình duyệt không tự bật.
 
-> ⚠️ `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`).
+> ⚠️ `npm install` / `npm start` **chỉ chạy được khi bạn đang ở trong thư mục `openclaw-setup` đã clone**. Nếu dùng một trong hai cách npx, lần sau chỉ cần chạy lại đúng lệnh npx đó để mở Setup.
 
 ### 🔁 Mở lại giao diện sau này
 
-**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õ:
-
-```bash
-openclaw-ui
-```
-
-<details>
-<summary>Lệnh thủ công (dự phòng — cũng không tải lại)</summary>
+Chạy lại lệnh khuyên dùng. Setup sẽ tự nhận diện và mở project hiện có:
 
 ```bash
-# macOS / Linux
-OPENCLAW_SETUP_WIZARD=true node ~/.openclaw-setup/node_modules/create-openclaw-bot/dist/cli.js
+npx create-openclaw-bot
 ```
 
-```powershell
-# Windows (PowerShell)
-$env:OPENCLAW_SETUP_WIZARD="true"; node "$env:USERPROFILE\.openclaw-setup\node_modules\create-openclaw-bot\dist\cli.js"
-```
-
-</details>
-
 ### ⬆️ Cập nhật lên phiên bản mới
 
-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:
-
-```bash
-npx github:tuanminhhole/openclaw-setup
-```
+Bấm nút **Cập nhật** ở **góc trên bên phải giao diện Setup**. Hệ thống tự tải phiên bản mới và khởi động lại UI; tab đang mở sẽ tự kết nối lại.
 
 ---
 
@@ -261,11 +264,12 @@ Hoàn toàn được. Bạn có thể sửa trực tiếp file `openclaw.json`
 
 ---
 
-## 📈 Star History
+## ⭐ Sao của repository
 
 <div align="center">
 
-[![Star History Chart](https://starchart.cc/tuanminhhole/openclaw-setup.svg?variant=adaptive)](https://starchart.cc/tuanminhhole/openclaw-setup)
+<a href="https://github.com/tuanminhhole/openclaw-setup/stargazers"><img src="https://img.shields.io/github/stars/tuanminhhole/openclaw-setup?style=for-the-badge&logo=github&color=eab308" alt="GitHub Stars" /></a>
+<a href="https://github.com/tuanminhhole/openclaw-setup/forks"><img src="https://img.shields.io/github/forks/tuanminhhole/openclaw-setup?style=for-the-badge&logo=github&color=0ea5e9" alt="GitHub Forks" /></a>
 
 </div>
 
@@ -298,6 +302,7 @@ Các repo đi kèm để bạn dựng một trợ lý AI "tự vận hành" hoà
 **🔌 Plugin (runtime)**
 - [openclaw-fb-messenger](https://github.com/tuanminhhole/openclaw-fb-messenger) — Kênh Facebook Messenger (webhook + Graph API), cài ngay trên giao diện Setup
 - [openclaw-telegram-multibot-relay](https://github.com/tuanminhhole/openclaw-telegram-multibot-relay) — Multibot Telegram relay, delegation & cron nhắc lịch native
+- [openclaw-zalo-connect](https://github.com/tuanminhhole/openclaw-zalo-connect) — Channel/runtime Zalo cá nhân với đăng nhập QR, mention native và thao tác nhóm
 - [openclaw-zalo-mod](https://github.com/tuanminhhole/openclaw-zalo-mod) — Quản lý nhóm Zalo zero-token (slash command, anti-spam, warn, memory)
 - [openclaw-browser-automation](https://github.com/tuanminhhole/openclaw-browser-automation) — Smart Search & Browser Automation
 - [openclaw-facebook-crawler](https://github.com/tuanminhhole/openclaw-facebook-crawler) — Crawl dữ liệu Facebook
@@ -306,7 +311,6 @@ Các repo đi kèm để bạn dựng một trợ lý AI "tự vận hành" hoà
 **🧩 Skill**
 - [openclaw-skill-learning-memory](https://github.com/tuanminhhole/openclaw-skill-learning-memory) — Bộ nhớ dài hạn tự tiến hoá cho agent
 - [openclaw-skill-infographic](https://github.com/tuanminhhole/openclaw-skill-infographic) — Tạo infographic
-- [openclaw-skill-zalo-sticker-mention](https://github.com/tuanminhhole/openclaw-skill-zalo-sticker-mention) — Sticker & mention trên Zalo
 
 ---