create-openclaw-bot 4.1.4 → 5.0.2

package/CHANGELOG.md

@@ -1,20 +1,93 @@
 # Changelog (English)
 
-
-## [4.1.4] — 2026-04-03
-
-### ✨ Improvements
-
-- CLI/Wizard parity: synchronized all skills (Browser Automation, Memory, RAG, Code Interpreter, etc.)
-- Browser Automation: added Desktop (Host Chrome) vs Server (Headless Chromium) mode selection for Linux/Ubuntu
-- Fixed Dockerfile WORKDIR issue causing build failures on Linux
-- Skills now install at container **runtime** (not build-time) to avoid ClawHub auth issues
-- Dynamic TOOLS.md: auto-generated listing all installed skills with hints
-- Added `browser-tool.js` (Desktop mode) and `BROWSER.md` for both modes
-- Skills registration in `openclaw.json → skills.entries` at setup time
-- Email SMTP config prompts and `.env` injection
-- Single-source versioning via `bump-version.mjs` — one command to update all files
-
+## [5.0.1] — 2026-04-04
+
+### 🚀 Native Install Mode — No Docker Required
+
+OpenClaw now supports **native (non-Docker) installation** on Windows, Linux, macOS, VPS, and shared hosting. Users who prefer not to use Docker can deploy the bot directly on their machine.
+
+- **CLI native mode** — new deployment mode selector: `docker` (default) or `native`
+- **OS-specific startup scripts** auto-generated:
+  - 🪟 **Windows** → `setup-openclaw-win.bat` (double-click install)
+  - 🐧 **Linux / macOS** → `setup-openclaw-linux.sh`
+  - 🖥️ **VPS / Ubuntu** → `setup-openclaw-vps.sh` (PM2 background process)
+  - 🏠 **Shared Hosting / cPanel** → `setup-openclaw-hosting.sh` + `ecosystem.config.cjs`
+- **Web Wizard updated** — Deploy Mode toggle (Docker / Native) with OS sub-selection cards
+- **Dynamic host URLs** — Ollama and 9Router URLs switch automatically:
+  - Docker mode: `http://ollama:11434` / `http://9router:20128/v1`
+  - Native mode: `http://localhost:11434` / `http://localhost:20128/v1`
+- **Node.js 18+ gate** — Native mode enforces minimum Node.js version at setup time
+- **Test scripts** — `test-native-install.bat` (Windows) and `test-native-install.sh` (Linux/macOS)
+
+### 🤖 Gemma 4 Model Updates
+
+- **4 Gemma 4 variants** available via Ollama: `gemma4:e2b` (~4-6 GB), `gemma4:e4b` (~8-10 GB), `gemma4:26b` (~18-24 GB), `gemma4:31b` (~24+ GB)
+- Auto-pull selected Gemma 4 variant on first `docker compose up` (container timeout extended to 15 min)
+- Raised Ollama timeout to **300 seconds** to handle large model inference
+- Added `OLLAMA_NUM_PARALLEL=1` and `OLLAMA_KEEP_ALIVE=24h` to Docker sidecar
+
+### 🤖 Multi-Bot Deployment (up to 5 Telegram bots per workspace)
+
+OpenClaw now supports deploying **multiple independent Telegram bots** from a single setup—each with its own identity, slash command, AI personality, and isolated workspace directory.
+
+- **Deploy 1–5 bots in one go** — Web Wizard and CLI both support multi-bot configuration
+- **Isolated workspaces** — each bot gets its own `botN/` directory with a separate `.env` and `.openclaw/` config, preventing any token or configuration collision
+- **Port auto-assignment** — ports start at `18791` and increment per bot (`18791`, `18792`, ...) to avoid host binding conflicts
+- **Multi-service Docker Compose** — automatically generates a `docker-compose.yml` with one service per bot, plus a shared provider container (9Router or Ollama)
+- **Department Room Model** — when bots share a Telegram group they operate like a professional team:
+  - 🤫 **Silent by default** — bots react with emoji (👍 ❤️) to casual messages but never spam replies
+  - 📣 **@mention or /slash triggers** — only the addressed bot responds, like calling a colleague by name in a meeting room
+  - 🗃️ **Shared workspace** — all bots read from a common workspace folder and can collaborate on tasks, files, and reports
+- **botGroup config** injected into each bot's `openclaw.json` so they are aware of each other's names and slash commands at runtime
+
+### 🔗 Telegram Group ID Helper
+
+Getting the Telegram Group ID is now frictionless:
+
+- **Web Wizard**: "Đã có group" card now shows an inline `Lấy Group ID` button that opens **@userinfobot** directly, with step-by-step instructions (forward a group message → bot replies with Chat ID)
+- **CLI**: selecting "existing group" prints an interactive guide with numbered steps and a direct link to `https://t.me/userinfobot`
+
+### 🎨 UI Refinements
+
+- **Group option selector** with **two interactive cards** with icon, description, hover glow, and animated selection checkmark
+- Card active state: green tint + border for "create later", indigo tint + border for "existing group"
+- Group ID input row includes inline helper button — no more hunting for documentation
+
+## [5.0.0] — 2026-04-04
+
+### 🚀 Gemma 4 Support — Google's Newest Open Model
+
+OpenClaw v5.0.0 adds **support for Gemma 4**, Google DeepMind's brand-new open-weights model family released April 2, 2026.
+
+- **Gemma 4 available in 3 sizes via Ollama** — `gemma4:4b` (~6 GB RAM), `gemma4` default (~10 GB), `gemma4:27b` (~18 GB)
+- **Zero manual install** — When you select Local Ollama + a Gemma 4 model, the setup now **auto-generates an `ollama` sidecar service** in `docker-compose.yml`. Docker pulls the model automatically on first `docker compose up`. No separate Ollama installation needed.
+- **OLLAMA_HOST auto-configured** — Points to the Docker sidecar (`http://ollama:11434`) instead of the host machine.
+- **Full model list updated** — Added `gemma4`, `gemma4:27b`, `gemma4:4b` to the Ollama provider in both CLI and Web Wizard.
+
+### 📋 Hardware Requirements for Gemma 4
+
+| Model              | Min RAM/VRAM (4-bit) | Recommended                   |
+| ------------------ | -------------------- | ----------------------------- |
+| `gemma4:4b`        | ~6 GB                | Laptop, Mac M1/M2             |
+| `gemma4` (default) | ~10 GB               | PC 16 GB RAM                  |
+| `gemma4:27b`       | ~18 GB               | Workstation 32 GB / GPU 24 GB |
+
+> Gemma 4 is **free, open-weights, Apache 2.0**. No API key required — runs 100% locally via Docker.
+
+## [4.1.4] — 2026-04-03
+
+### ✨ Improvements
+
+- CLI/Wizard parity: synchronized all skills (Browser Automation, Memory, RAG, Code Interpreter, etc.)
+- Browser Automation: added Desktop (Host Chrome) vs Server (Headless Chromium) mode selection for Linux/Ubuntu
+- Fixed Dockerfile WORKDIR issue causing build failures on Linux
+- Skills now install at container **runtime** (not build-time) to avoid ClawHub auth issues
+- Dynamic TOOLS.md: auto-generated listing all installed skills with hints
+- Added `browser-tool.js` (Desktop mode) and `BROWSER.md` for both modes
+- Skills registration in `openclaw.json → skills.entries` at setup time
+- Email SMTP config prompts and `.env` injection
+- Single-source versioning via `bump-version.mjs` — one command to update all files
+
 ## [4.1.3] — 2026-04-02
 
 ### ✨ Improvements

package/CHANGELOG.vi.md

@@ -1,20 +1,93 @@
 # Changelog (Tiếng Việt)
 
-
-## [4.1.4] — 2026-04-03
-
-### ✨ Cải tiến
-
-- CLI/Wizard đồng bộ đầy đủ skills (Browser Automation, Memory, RAG, Code Interpreter, v.v.)
-- Browser Automation: chọn chế độ Desktop (Host Chrome) hoặc Server (Headless Chromium) cho Linux/Ubuntu
-- Sửa lỗi Dockerfile WORKDIR gây lỗi build trên Linux
-- Skills install tại **runtime** container (không phải lúc build) để tránh lỗi ClawHub auth
-- TOOLS.md động: tự sinh theo danh sách skills đã chọn
-- Tự tạo `browser-tool.js` (Desktop mode) và `BROWSER.md`
-- Tự đăng ký skills vào `openclaw.json → skills.entries`
-- Bổ sung prompt cấu hình Email SMTP và inject vào `.env`
-- Single-source version qua `bump-version.mjs` — 1 lệnh cập nhật tất cả file
-
+## [5.0.1] — 2026-04-04
+
+### 🚀 Chế độ Native Install — Không cần Docker
+
+OpenClaw giờ hỗ trợ **cài đặt native (không dùng Docker)** trên Windows, Linux, macOS, VPS và shared hosting.
+
+- **CLI native mode** — thêm chọn chế độ: `docker` (mặc định) hoặc `native`
+- **Script khởi động sinh tự động theo OS:**
+  - 🪟 **Windows** → `setup-openclaw-win.bat` (double-click cài ngay)
+  - 🐧 **Linux / macOS** → `setup-openclaw-linux.sh`
+  - 🖥️ **VPS / Ubuntu** → `setup-openclaw-vps.sh` (PM2 chạy nền)
+  - 🏠 **Shared Hosting / cPanel** → `setup-openclaw-hosting.sh` + `ecosystem.config.cjs`
+- **Web Wizard cập nhật** — Thêm toggle Deploy Mode (Docker / Native) + chọn OS
+- **URL host động** — Ollama và 9Router URL tự chuyển:
+  - Docker: `http://ollama:11434` / `http://9router:20128/v1`
+  - Native: `http://localhost:11434` / `http://localhost:20128/v1`
+- **Kiểm tra Node.js 18+** — Native mode yêu cầu Node.js 18+ trước khi chạy
+- **Test scripts** — `test-native-install.bat` (Windows) và `test-native-install.sh` (Linux/macOS)
+
+### 🤖 Cập nhật Gemma 4
+
+- **4 biến thể Gemma 4** qua Ollama: `gemma4:e2b` (~4-6 GB), `gemma4:e4b` (~8-10 GB), `gemma4:26b` (~18-24 GB), `gemma4:31b` (~24+ GB)
+- Tự pull model Gemma 4 khi `docker compose up` lần đầu (timeout container tăng lên 15 phút)
+- Nâng timeout Ollama lên **300 giây** để xử lý model lớn
+- Thêm `OLLAMA_NUM_PARALLEL=1` và `OLLAMA_KEEP_ALIVE=24h` vào Docker sidecar
+
+### 🤖 Multi-Bot Deployment (tối đa 5 bot Telegram trên mỗi workspace)
+
+OpenClaw giờ hỗ trợ triển khai **nhiều bot Telegram độc lập** từ một setup duy nhất — mỗi bot có identity, slash command, AI personality và thư mục workspace riêng biệt.
+
+- **Triển khai 1–5 bot cùng lúc** — Web Wizard và CLI đều hỗ trợ cấu hình multi-bot
+- **Workspace riêng biệt** — mỗi bot có thư mục `botN/` riêng với `.env` và cấu hình `.openclaw/` riêng, không gây xung đột token hay cấu hình
+- **Tự động gán cổng** — cổng bắt đầu từ `18791` và tăng dần cho mỗi bot (`18791`, `18792`, ...) để tránh xung đột binding host
+- **Docker Compose đa-service** — tự động sinh `docker-compose.yml` với một service cho mỗi bot, cộng thêm một container provider chung (9Router hoặc Ollama)
+- **Department Room Model** — khi các bot chia sẻ chung một nhóm Telegram, chúng hoạt động như một đội ngũ chuyên nghiệp:
+  - 🤫 **Mặc định im lặng** — bot phản hồi bằng emoji (👍 ❤️) với tin nhắn thông thường nhưng không bao giờ spam reply
+  - 📣 **Trigger bằng @mention hoặc /slash** — chỉ bot được nhắc tên hoặc được gọi lệnh mới phản hồi, giống như gọi tên đồng nghiệp trong phòng họp
+  - 🗃️ **Workspace chung** — tất cả bot đọc từ một thư mục workspace chung và có thể cộng tác trên các tác vụ, tệp và báo cáo
+- **Cấu hình botGroup** được inject vào `openclaw.json` của mỗi bot để chúng biết tên và lệnh slash của nhau khi runtime
+
+### 🔗 Trợ giúp lấy Telegram Group ID
+
+Lấy Group ID giờ trở nên cực kỳ đơn giản:
+
+- **Web Wizard**: card "Đã có group" giờ hiển thị nút inline `Lấy Group ID` mở thẳng **@userinfobot**, kèm hướng dẫn từng bước (forward tin nhắn nhóm → bot trả về Chat ID)
+- **CLI**: chọn "existing group" sẽ in ra hướng dẫn tương tác với các bước đánh số và link trực tiếp đến `https://t.me/userinfobot`
+
+### 🎨 Tinh chỉnh UI
+
+- **Bộ chọn tùy chọn nhóm** được thiết kế dạng **hai thẻ tương tác** với icon, mô tả, hiệu ứng hover glow và dấu tick chọn động
+- Trạng thái active của thẻ: màu xanh lá + viền cho "tạo sau", màu xanh chàm + viền cho "nhóm đã có"
+- Hàng nhập Group ID bao gồm nút trợ giúp inline — không cần tìm kiếm tài liệu nữa
+
+## [5.0.0] — 2026-04-04
+
+### 🚀 Hỗ trợ Gemma 4 — Model mới nhất của Google
+
+OpenClaw v5.0.0 cập nhật **Gemma 4** — dòng model open-weights mới của Google DeepMind, ra mắt 02/04/2026.
+
+- **Gemma 4 có sẵn 3 size qua Ollama** — `gemma4:4b` (~6 GB RAM), `gemma4` mặc định (~10 GB), `gemma4:27b` (~18 GB)
+- **Không cần cài Ollama thủ công** — Khi chọn Local Ollama + Gemma 4, setup tự động sinh **service `ollama` sát cạnh trong `docker-compose.yml`**. Docker tự pull model khi `docker compose up`. Không cần cài Ollama trước.
+- **OLLAMA_HOST tự cấu hình** — Trỏ thẳng vào sidecar container (`http://ollama:11434`).
+- **Cập nhật danh sách model** — Thêm `gemma4`, `gemma4:27b`, `gemma4:4b` vào Ollama provider trên cả CLI và Web Wizard.
+
+### 💻 Yêu cầu phần cứng cho Gemma 4
+
+| Model               | RAM/VRAM tối thiểu (4-bit) | Phù hợp                        |
+| ------------------- | -------------------------- | ------------------------------ |
+| `gemma4:4b`         | ~6 GB                      | Laptop thông thường, Mac M1/M2 |
+| `gemma4` (mặc định) | ~10 GB                     | PC 16 GB RAM                   |
+| `gemma4:27b`        | ~18 GB                     | Workstation 32 GB / GPU 24 GB  |
+
+> Gemma 4 **miễn phí, open-weights, giấy phép Apache 2.0**. Không cần API key — chạy 100% local qua Docker.
+
+## [4.1.4] — 2026-04-03
+
+### ✨ Cải tiến
+
+- CLI/Wizard đồng bộ đầy đủ skills (Browser Automation, Memory, RAG, Code Interpreter, v.v.)
+- Browser Automation: chọn chế độ Desktop (Host Chrome) hoặc Server (Headless Chromium) cho Linux/Ubuntu
+- Sửa lỗi Dockerfile WORKDIR gây lỗi build trên Linux
+- Skills install tại **runtime** container (không phải lúc build) để tránh lỗi ClawHub auth
+- TOOLS.md động: tự sinh theo danh sách skills đã chọn
+- Tự tạo `browser-tool.js` (Desktop mode) và `BROWSER.md`
+- Tự đăng ký skills vào `openclaw.json → skills.entries`
+- Bổ sung prompt cấu hình Email SMTP và inject vào `.env`
+- Single-source version qua `bump-version.mjs` — 1 lệnh cập nhật tất cả file
+
 ## [4.1.3] — 2026-04-02
 
 ### ✨ Cải tiến