create-openclaw-bot 5.4.0 → 5.4.1

package/CHANGELOG.md

@@ -1,6 +1,19 @@
 # Changelog (English)
 
 
+## [5.4.1] — 2026-04-14
+
+### 🐛 Docker CLI Generation Fixes
+
+- **Browser Automation Restoration**: Reintroduced `xvfb` APT installation and the background Xvfb frame buffer execution (`Xvfb :99 -screen...`) to the generated Dockerfile `CMD`. This prevents headful Playwright processes from crashing on startup within the container.
+- **REST API CORS Hotfix**: Reintroduced the runtime Internal IP injector script. It correctly patches `openclaw.json` at container startup strictly mapping Docker internal bridge IPs (`172...`) into `allowedOrigins`, eliminating 403 CORS blocks inside Docker Web Control UIs.
+
+### 🧹 Automated Uninstall Scripts
+
+- **Wizard UI Generation**: The HTML setup wizard now generates a matching `uninstall-openclaw-*.bat/sh` script when downloading the configuration for Native or Docker deployments.
+- **Complete Cleanup**: The generated scripts cleanly kill 9Router/OpenClaw background processes, uninstall global npm packages, and safely remove the project and `.9router` data directories, allowing for a fresh start whenever needed.
+
+
 ## [5.4.0] — 2026-04-14
 
 ### 🗑️ Remove: Telegram + Zalo Combo Channel

package/CHANGELOG.vi.md

@@ -1,6 +1,19 @@
 # Changelog (Tiếng Việt)
 
 
+## [5.4.1] — 2026-04-14
+
+### 🐛 Sửa Lỗi Build Dockerfile
+
+- **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.
+- **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.
+
+### 🧹 Tự Động Tạo Script Gỡ Cài Đặt
+
+- **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.
+- **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.
+
+
 ## [5.4.0] — 2026-04-14
 
 ### 🗑️ Xóa: Kênh Combo Telegram + Zalo

package/README.md

@@ -3,7 +3,7 @@
 # 🦞 OpenClaw Setup
 
 <p align="center">
-  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.4.0-0EA5E9?style=for-the-badge" alt="Version 5.4.0" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.4.1-0EA5E9?style=for-the-badge" alt="Version 5.4.1" /></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>
@@ -24,7 +24,7 @@ An interactive **CLI tool** and **Setup Wizard** to deploy your own free AI Bot
 
 ---
 
-## 🆕 What's new in v5.4.0
+## 🆕 What's new in v5.4.1
 
 - 🏗️ **Multi-bot architecture refactored** — All duplicate flags (`isTelegramMultiBot`, `isSharedMultiBot`, `isMultiBotWizard`) merged into a single `isMultiBot`. Generated `agentDir` paths now correctly point to `.openclaw/agents/{slug}/agent` relative to `OPENCLAW_HOME`.
 - 🗑️ **Telegram + Zalo combo channel removed** — Combo mode has been deprecated and removed from both the Web Wizard and CLI. It will be redesigned in a future release.

package/README.vi.md

@@ -3,7 +3,7 @@
 # 🦞 OpenClaw Setup
 
 <p align="center">
-  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.4.0-0EA5E9?style=for-the-badge" alt="Version 5.4.0" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.4.1-0EA5E9?style=for-the-badge" alt="Version 5.4.1" /></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>
@@ -24,7 +24,7 @@ Công cụ **CLI tương tác** và **Setup Wizard** để tự triển khai Bot
 
 ---
 
-## 🆕 Có gì mới trong v5.4.0
+## 🆕 Có gì mới trong v5.4.1
 
 - 🏗️ **Tái cấu trúc kiến trúc multi-bot** — Các flag `isTelegramMultiBot`, `isSharedMultiBot`, `isMultiBotWizard` được gộp thành một biến `isMultiBot` duy nhất. Đường dẫn `agentDir` trong `openclaw.json` được tạo ra nay đúng chuẩn `.openclaw/agents/{slug}/agent` (tương đối với `OPENCLAW_HOME`).
 - 🗑️ **Xóa hoàn toàn kênh combo Telegram + Zalo** — Combo mode đã được gỡ bỏ khỏi cả Web Wizard lẫn CLI. Sẽ được thiết kế lại trong bản phát hành sau.
@@ -111,7 +111,7 @@ Chạy trong terminal → làm theo hướng dẫn → script khởi động đ
 2. Mở repo này làm workspace
 3. Paste vào chat:
    ```
-   Đọc SETUP.md và cài đặt OpenClaw v5.4.0 cho tôi.
+   Đọc SETUP.md và cài đặt OpenClaw v5.4.1 cho tôi.
    Bot token của tôi là X. Dùng 9Router (không cần API key).
    Thư mục project: <ĐƯỜNG_DẪN_CỦA_BẠN>
    ```

package/cli.js

@@ -44,24 +44,22 @@ const {
   buildToolsDoc,
   buildRelayDoc,
 } = _require('./setup/shared/scaffold-gen.js');
-
-const {
-  PROVIDERS: _PROVIDERS,
-  SKILLS: _SKILLS,
-  CHANNELS: _CHANNELS,
-  OLLAMA_MODELS,
-} = _require('../setup/data/index.js');
-
-const {
-  buildChromeDebugBat,
-  buildChromeDebugSh,
-} = _require('./setup/shared/runtime-gen.js');
-
-/**
- * Pure uninstall script generator for CLI (no DOM dependency).
- * @param {{os:'win'|'linux'|'linux-desktop', projectDir:string, botName:string, isDocker?:boolean}} opts
- * @returns {{name:string, content:string}|null}
- */
+
+let dataExport = _require('./setup/data/index.js');
+if (!dataExport.CHANNELS) dataExport = globalThis.__openclawData || {};
+
+const {
+  PROVIDERS: _PROVIDERS,
+  SKILLS: _SKILLS,
+  CHANNELS: _CHANNELS,
+  OLLAMA_MODELS,
+} = dataExport;
+
+const {
+  buildChromeDebugBat,
+  buildChromeDebugSh,
+} = _require('./setup/shared/runtime-gen.js');
+
 function buildCLIUninstallScript({ os, projectDir, botName = 'openclaw', isDocker = false }) {
   const absWin = projectDir.replace(/\//g, '\\');
   const absUnix = projectDir.replace(/\\/g, '/');
@@ -1824,7 +1822,7 @@ async function main() {
   // ── start-bot.bat / start-bot.sh — one-click restart scripts ─────────────
   // Generated for native deployments only (docker has docker compose up)
   if (deployMode !== 'docker') {
-    const { generateStartBotBat, generateStartBotSh } = _require('../setup/generators/gateway-start-gen.js');
+    const { generateStartBotBat, generateStartBotSh } = _require('./setup/generators/gateway-start-gen.js');
 
     // Windows: start-bot.bat
     const startBotBatPath = path.join(projectDir, 'start-bot.bat');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-openclaw-bot",
-  "version": "5.4.0",
+  "version": "5.4.1",
   "description": "Interactive CLI installer for OpenClaw Bot",
   "main": "cli.js",
   "bin": {

package/setup.js

@@ -1863,7 +1863,7 @@
         emitBrowserInstall = true,
       } = options;
 
-      const browserAptExtra = hasBrowser ? ' socat' : '';
+      const browserAptExtra = hasBrowser ? ' xvfb' : '';
       const browserInstallLines = hasBrowser && emitBrowserInstall
         ? [
             '',
@@ -1879,8 +1879,18 @@
         ? `\n# Install skills (ClawHub)\n${allSkills.map((skill) => `RUN openclaw skills install ${skill} || echo "Warning: Failed to install ${skill} due to rate limits."`).join('\n')}\n`
         : '';
       const patchLine = `RUN node -e "const fs=require('fs');const path=require('path');const dir='/usr/local/lib/node_modules/openclaw/dist';const from='\\t\\t\\t\\t\\tonAgentRunStart: (runId) => {';const to='\\t\\t\\t\\t\\ttimeoutOverrideSeconds: Math.max(1, Math.ceil(timeoutMs / 1e3)),\\n\\t\\t\\t\\t\\tonAgentRunStart: (runId) => {';const files=fs.readdirSync(dir).filter(n=>/\\.js$/.test(n));let patched=0;for(const file of files){const p=path.join(dir,file);let s='';try{s=fs.readFileSync(p,'utf8');}catch{continue;}if(s.includes(to)||!s.includes(from))continue;s=s.replace(from,to);fs.writeFileSync(p,s);patched++;}if(!patched){process.exit(0);}"`;
+      
+      // Dynamic runtime configuration injection for container internal IPs
+      const setupInternalIpScript = `const fs=require('fs'),os=require('os'),p='/root/.openclaw/openclaw.json';if(fs.existsSync(p)){const c=JSON.parse(fs.readFileSync(p,'utf8'));const a=new Set(['http://localhost:18791','http://127.0.0.1:18791','http://0.0.0.0:18791']);for(const entries of Object.values(os.networkInterfaces()||{})){for(const entry of entries||[]){if(!entry||entry.internal||entry.family!=='IPv4'||!entry.address)continue;a.add('http://' + entry.address + ':18791');}}c.tools=Object.assign({},c.tools,{profile:'full',exec:{host:'gateway',security:'full',ask:'off'}});c.gateway=Object.assign({},c.gateway,{port:18791,bind:'custom',customBindHost:'0.0.0.0',controlUi:Object.assign({},c.gateway?.controlUi,{allowedOrigins:Array.from(a).filter(Boolean)})});fs.writeFileSync(p,JSON.stringify(c,null,2));}`;
+      const setupInternalIpB64 = encodeBase64Utf8(setupInternalIpScript);
+
       const runtimeParts = runtimeCommandParts.filter(Boolean);
-      runtimeParts.push('openclaw gateway run');
+      runtimeParts.unshift(`node -e "eval(Buffer.from('${setupInternalIpB64}','base64').toString())" &&`);
+      if (hasBrowser) {
+        runtimeParts.push('(Xvfb :99 -screen 0 1280x720x24 > /dev/null 2>&1 &) && export DISPLAY=:99 && openclaw gateway run');
+      } else {
+        runtimeParts.push('openclaw gateway run');
+      }
       const dockerfile = `FROM node:22-slim
 
   RUN apt-get update && apt-get install -y git curl${browserAptExtra} && rm -rf /var/lib/apt/lists/*
@@ -2147,7 +2157,7 @@
       if (p) allPlugins.push(p.package);
     });
     if (isMultiBot && state.channel === 'telegram') allPlugins.push(relayPluginSpec);
-    const pluginCmd = allPlugins.length > 0 ? ('call npm exec -- openclaw plugins install ' + allPlugins.join(' ') + ' || goto :fail') : '';
+    const pluginCmd = allPlugins.length > 0 ? allPlugins.map(function(pkg) { return 'call npm exec -- openclaw plugins install ' + pkg + ' || goto :fail'; }).join('\r\n') : '';
     const nativeSkillInstallCmds = nativeSkillConfigs.map((skill) => `call openclaw skills install ${skill.slug} || echo Warning: Failed to install skill ${skill.slug}`);
 
     Object.assign(globalThis, {
@@ -5250,7 +5260,7 @@
       const dockerGen = globalThis.__openclawDockerGen;
       const relayPluginInstallCmd = isMultiBot ? `${buildRelayPluginInstallCommand('openclaw')} && ` : '';
       const pluginInstallCmd = allPlugins.length > 0
-        ? `openclaw plugins install ${allPlugins.join(' ')} 2>/dev/null || true && ${relayPluginInstallCmd}`
+        ? `${allPlugins.map((p) => `openclaw plugins install ${p} 2>/dev/null || true`).join(' && ')} && ${relayPluginInstallCmd}`
         : relayPluginInstallCmd;
       const dockerArtifacts = dockerGen.buildDockerArtifacts({
         openClawNpmSpec: 'openclaw@2026.4.5',
@@ -6008,7 +6018,7 @@
     // ========== Zalo Personal Login Guide (post-setup) ==========
     function generateZaloOnboardGuide() {
       const lang = document.getElementById('cfg-language')?.value || 'vi';
-      setOutput('out-zalo-onboard-cmd', `docker compose exec -it ai-bot openclaw channels login --channel zalouser --instance default --verbose`);
+      setOutput('out-zalo-onboard-cmd', `docker compose exec -it ai-bot openclaw channels login --channel zalouser --verbose`);
 
       if (lang === 'vi') {
         setOutput('out-zalo-onboard-guide', `┌─────────────────────────────────────────────────────┐

package/openclaw_correct_structure.md

@@ -1,203 +0,0 @@
-# OpenClaw - Kien truc thu muc va secrets hien tai
-
-Tai lieu nay mo ta dung behavior code hien tai cua wizard sau khi da dong bo lai native/docker va logic `.env`.
-
-## Pham vi ho tro hien tai
-
-- Native: `win`, `macos`, `linux-desktop`, `vps`
-- Docker: cung mot cau truc file cho moi OS, chi khac launcher script tai ve
-- Channel ho tro:
-  - `telegram`
-  - `zalo-bot`
-  - `zalo-personal`
-- Multi-bot: chi ap dung cho `telegram`
-- Combo `telegram + zalo-*`: hien khong duoc wizard UI mo ra
-
-## Nguyen tac chung
-
-- `OPENCLAW_HOME = {projectDir}/.openclaw`
-- `OPENCLAW_STATE_DIR = {projectDir}/.openclaw`
-- `DATA_DIR = {projectDir}/.9router`
-- `agents.list[].agentDir` la duong dan relative theo `OPENCLAW_HOME`
-- `agents.list[].workspace` cung la duong dan relative theo `OPENCLAW_HOME`
-- Workspace luon dung format `workspace-{slug}`, ke ca single bot
-
-## Secrets va .env
-
-### Native
-
-Native setup hien tai tao `{projectDir}/.env` va cac script native deu load file nay truoc khi chay `openclaw gateway run`.
-
-`.env` trong native dung de luu:
-
-- API key cua direct provider, vd `OPENAI_API_KEY`, `GEMINI_API_KEY`, ...
-- channel token khi can:
-  - `TELEGRAM_BOT_TOKEN`
-  - `TELEGRAM_BOT_TOKEN_1..N` cho telegram multi-bot
-  - `ZALO_BOT_TOKEN` cho `zalo-bot`
-- `TELEGRAM_GROUP_ID` neu user nhap group id
-- env vars cua skills da chon
-
-Luu y:
-
-- `9router` khong can AI API key trong `.env`
-- nhung neu channel la `telegram` hoac `zalo-bot` thi `.env` van co token channel
-- `zalo-personal` khong dung bot token; login bang `openclaw channels login --channel zalouser --verbose`
-
-### Docker
-
-Docker setup hien tai tao ca hai file:
-
-- `{projectDir}/.env`
-- `{projectDir}/docker/openclaw/.env`
-
-Trong do:
-
-- root `.env` la ban ghi secrets tai project root de user de theo doi/chinh sua
-- `docker/openclaw/.env` la file duoc `docker compose` nap vao container
-
-## Provider auth
-
-- Direct provider va provider local van co `.openclaw/auth-profiles.json`
-- Per-agent `auth-profiles.json` duoc tao trong `.openclaw/agents/{slug}/agent/` khi khong dung `9router`
-- Khi dung `9router`, khong tao root/per-agent `auth-profiles.json`
-- Khi dung `9router`, provider endpoint duoc khai bao trong `.openclaw/openclaw.json -> models.providers.9router`
-
-## Cau truc chuan theo case
-
-### Case 1: Single bot
-
-Ap dung cho:
-
-- `telegram` single bot
-- `zalo-bot`
-- `zalo-personal`
-
-```text
-{projectDir}/
-|-- .env                              # native secrets; docker cung co ban root nay
-|-- .openclaw/
-|   |-- openclaw.json
-|   |-- exec-approvals.json
-|   |-- auth-profiles.json            # chi khi khong dung 9router
-|   |-- agents/
-|   |   |-- {slug}.yaml
-|   |   `-- {slug}/agent/
-|   |       `-- auth-profiles.json    # chi khi khong dung 9router
-|   `-- workspace-{slug}/
-|       |-- IDENTITY.md
-|       |-- SOUL.md
-|       |-- AGENTS.md
-|       |-- USER.md
-|       |-- TOOLS.md
-|       |-- MEMORY.md
-|       |-- browser-tool.js           # neu bat browser
-|       `-- BROWSER.md                # neu bat browser
-|-- .9router/
-|   `-- 9router-smart-route-sync.js   # chi khi provider = 9router
-|-- start-bot.bat / start-bot.sh      # chi native
-|-- start-chrome-debug.bat/sh         # neu bat browser va native
-|-- uninstall-openclaw-*.bat/sh
-`-- docker/
-    `-- openclaw/
-        |-- Dockerfile                # chi docker mode
-        |-- docker-compose.yml        # chi docker mode
-        `-- .env                      # chi docker mode
-```
-
-### Case 2: Telegram multi-bot
-
-```text
-{projectDir}/
-|-- .env
-|-- .openclaw/
-|   |-- openclaw.json
-|   |-- exec-approvals.json
-|   |-- auth-profiles.json            # chi khi khong dung 9router
-|   |-- agents/
-|   |   |-- {bot1}.yaml
-|   |   |-- {bot2}.yaml
-|   |   |-- {bot1}/agent/auth-profiles.json   # chi khi khong dung 9router
-|   |   `-- {bot2}/agent/auth-profiles.json   # chi khi khong dung 9router
-|   |-- workspace-{bot1}/
-|   |   |-- IDENTITY.md
-|   |   |-- SOUL.md
-|   |   |-- AGENTS.md
-|   |   |-- USER.md
-|   |   |-- TOOLS.md
-|   |   |-- MEMORY.md
-|   |   |-- browser-tool.js           # neu bat browser
-|   |   `-- BROWSER.md                # neu bat browser
-|   `-- workspace-{bot2}/
-|       |-- IDENTITY.md
-|       |-- SOUL.md
-|       |-- AGENTS.md
-|       |-- USER.md
-|       |-- TOOLS.md
-|       |-- MEMORY.md
-|       |-- browser-tool.js           # neu bat browser
-|       `-- BROWSER.md                # neu bat browser
-|-- TELEGRAM-POST-INSTALL.md
-|-- .9router/
-|   `-- 9router-smart-route-sync.js   # chi khi provider = 9router
-|-- start-bot.bat / start-bot.sh      # chi native
-|-- uninstall-openclaw-*.bat/sh
-`-- docker/
-    `-- openclaw/
-        |-- Dockerfile                # chi docker mode
-        |-- docker-compose.yml        # chi docker mode
-        `-- .env                      # chi docker mode
-```
-
-Ghi chu multi-bot:
-
-- `openclaw.json` co `channels.telegram.accounts` cho tung bot
-- moi workspace co `AGENTS.md` mo ta handoff/routing
-- wizard hien khong tao file rieng `TEAM.md` hay `RELAY.md`
-- noi dung team coordination da duoc nhap vao `AGENTS.md`
-- noi dung security da duoc nhap vao `AGENTS.md`
-- noi dung relay da duoc nhap vao `TOOLS.md`
-
-## Hanh vi theo channel
-
-### Telegram single
-
-- co `TELEGRAM_BOT_TOKEN` trong `.env`
-- native script load `.env` roi chay gateway
-- docker dung `docker/openclaw/.env`
-
-### Telegram multi-bot
-
-- co `TELEGRAM_BOT_TOKEN_1..N` va co the co `TELEGRAM_GROUP_ID` trong `.env`
-- `openclaw.json` van co `channels.telegram.accounts` cho tung bot
-- relay plugin `openclaw-telegram-multibot-relay` duoc bat
-
-### Zalo Bot API
-
-- co `ZALO_BOT_TOKEN` trong `.env`
-- code hien cung de san `ZALO_APP_ID` va `ZALO_APP_SECRET` placeholder
-- native va docker deu can secrets nay
-
-### Zalo Personal
-
-- khong co bot token trong `.env`
-- native: script tu dong mo flow login `zalouser`
-- docker: user chay lenh login sau khi container da len
-
-## Danh sach file khong nen tao
-
-- khong tao `agents/` o project root
-- khong tao `.openclaw/workspace` chung kieu cu
-- khong tao `models.json` trong agent dir khi dung `9router`
-- khong tao Docker artifacts trong native mode
-- khong tao root/per-agent `auth-profiles.json` khi dung `9router`
-- khong tao file rieng `TEAM.md` / `RELAY.md` trong wizard hien tai
-
-## Ket luan thuc te hien tai
-
-Sau khi chinh code:
-
-- logic tao thu muc `.openclaw`, `workspace-{slug}`, `auth-profiles.json` da dong bo hon giua native va docker
-- native va docker deu co `.env` de ghi nhan secrets theo provider/channel
-- 4 OS native deu load project `.env` truoc khi start gateway
-- tai lieu nay mo ta code thuc te hien tai, khong mo ta combo modes dang tam ngung trong UI