create-openclaw-bot 5.4.2 → 5.5.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog (English)
 
+## [5.5.0] — 2026-04-15
+
+### 📄 Scaffold-Based Workspace Docs & OpenClaw 2026.4.14
+
+- **Scaffold-based generation** — Both Wizard and CLI now call shared scaffold builders from `scaffold-gen.js` instead of inline code, ensuring consistent workspace doc generation across all platforms and modes.
+- **Modular workspace docs** — Multi-bot (Telegram relay) deployments now generate `TEAM.md` (team roster & coordination rules) and `RELAY.md` (relay playbook) as separate files. Single-bot deployments do not create these files.
+- **Full security rules everywhere** — All generated `AGENTS.md` files now include the complete 4-section security ruleset (File System, API Key, Crypto Wallet, Docker) regardless of OS, deployment mode, or channel type.
+- **Removed `.yaml` agent file generation** — OpenClaw Core reads configuration exclusively from `openclaw.json → agents.list`. Orphaned `.yaml` agent files are no longer generated by any flow.
+- **Anti-hallucination handoff rules** — Relay-variant `AGENTS.md` now mandates tool-first `react` actions (👍 for every incoming message) and explicitly forbids LLM refusal of cross-agent handoffs.
+- **OpenClaw bumped to 2026.4.14** — Includes the new experimental Dreaming memory consolidation system, active-memory recall improvements, Telegram approval button deadlock fix, WebSocket keepalive stability, and idempotency key fix for dreaming narrative jobs.
+
 
 ## [5.4.2] — 2026-04-14
 

package/CHANGELOG.vi.md

@@ -1,5 +1,16 @@
 # Changelog (Tiếng Việt)
 
+## [5.5.0] — 2026-04-15
+
+### 📄 Tái Cấu Trúc Workspace Docs & OpenClaw 2026.4.14
+
+- **Scaffold-based generation** — Cả Wizard lẫn CLI giờ gọi chung scaffold builders từ `scaffold-gen.js` thay vì viết inline, đảm bảo workspace docs đồng nhất trên mọi nền tảng và chế độ cài đặt.
+- **Tách file workspace docs** — Triển khai multi-bot (Telegram relay) giờ sinh `TEAM.md` (roster đội + quy tắc phối hợp) và `RELAY.md` (sổ tay chuyển tiếp) thành file riêng. Single-bot không tạo các file này.
+- **Quy tắc bảo mật đầy đủ mọi nơi** — Tất cả `AGENTS.md` giờ có đủ 4 section bảo mật (File hệ thống, API Key, Ví Crypto, Docker) bất kể OS, chế độ cài đặt hay kênh chat.
+- **Xóa file `.yaml` agent** — OpenClaw Core chỉ đọc config từ `openclaw.json → agents.list`. File `.yaml` orphan không còn được sinh ra.
+- **Chống ảo giác handoff** — `AGENTS.md` variant relay bắt buộc `react` action (👍 mỗi tin nhắn đến) và cấm từ chối chuyển tiếp giữa các agent.
+- **Nâng OpenClaw lên 2026.4.14** — Bao gồm hệ thống Dreaming (thử nghiệm), cải thiện active-memory, sửa deadlock nút approve Telegram, ổn định WebSocket keepalive.
+
 
 ## [5.4.2] — 2026-04-14
 

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.2-0EA5E9?style=for-the-badge" alt="Version 5.4.2" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.5.0-0EA5E9?style=for-the-badge" alt="Version 5.5.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>
@@ -24,21 +24,23 @@ An interactive **CLI tool** and **Setup Wizard** to deploy your own free AI Bot
 
 ---
 
-## 🆕 What's new in v5.4.2
+## 🆕 What's new in v5.5.0
+
+- 📦 **OpenClaw 2026.4.14** — Bumped from 2026.4.5. Includes the new experimental Dreaming memory system, active-memory improvements, Telegram approval button deadlock fix, and WebSocket keepalive stability.
+- 📄 **Modular workspace docs** — Multi-bot deployments now generate `TEAM.md` (team roster & coordination) and `RELAY.md` (relay playbook) as separate files, giving clearer separation of concerns.
+- 🔐 **Full security rules everywhere** — All `AGENTS.md` files now include the complete 4-section security ruleset (File System, API Key, Crypto Wallet, Docker) regardless of OS, mode, or channel.
+- 🗑️ **Removed `.yaml` agent files** — OpenClaw Core reads config exclusively from `openclaw.json`. Orphaned `.yaml` files are no longer generated.
+- 🤖 **Anti-hallucination handoff** — Relay-variant `AGENTS.md` now mandates tool-first `react` actions and forbids LLM refusal of cross-agent handoffs.
+- 🏗️ **Scaffold-based generation** — Both Wizard and CLI now call shared scaffold builders from `scaffold-gen.js`, ensuring consistent doc generation across all platforms.
+
+<details>
+<summary><b>Previous: What's new in v5.5.0</b></summary>
 
 - 🏗️ **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.
 - 🤝 **Cross-workspace rules in `AGENTS.md`** — In multi-bot mode, each bot's `AGENTS.md` now includes a dedicated section describing which sibling workspace paths may be read and what write restrictions apply.
 - 🧹 **Cleaner config generation** — Per-agent `auth-profiles.json` is no longer created for 9Router/proxy setups. Native scripts no longer generate `.env` files; credentials are managed via `openclaw channels login`.
 
-<details>
-<summary><b>Previous: What's new in v5.3.5</b></summary>
-
-- 🐛 **Fix: Telegram token input missing in combo channel** — When selecting "Telegram + Zalo Personal", the wizard now shows the Telegram Bot Token input field AND the Zalo Personal warning side by side.
-- 🐛 **Fix: Next button stuck on step 4 for combo** — Validation now correctly requires a Telegram token before enabling "Generate Configs" in combo mode.
-- 🐛 **Fix: Windows Docker script crashes with "docker not recognized"** — The generated `.ps1` now uses `Get-Command` to locate Docker, checks that Docker Desktop is running, and calls it via `&` operator — works even when Docker isn't in the default PowerShell PATH.
-- 🐛 **Fix: Zalo QR login instructions missing for combo in Windows script** — Post-install notes now show the `docker compose exec` login command when the combo channel is selected.
-
 </details>
 
 ---

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.2-0EA5E9?style=for-the-badge" alt="Version 5.4.2" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.5.0-0EA5E9?style=for-the-badge" alt="Version 5.5.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>
@@ -24,21 +24,23 @@ Công cụ **CLI tương tác** và **Setup Wizard** để tự triển khai Bot
 
 ---
 
-## 🆕 Có gì mới trong v5.4.2
+## 🆕 Có gì mới trong v5.5.0
+
+- 📦 **OpenClaw 2026.4.14** — Nâng từ 2026.4.5. Bao gồm hệ thống Dreaming (thử nghiệm), cải thiện active-memory, sửa deadlock nút approve Telegram, ổn định WebSocket keepalive.
+- 📄 **Tách file workspace docs** — Multi-bot giờ sinh `TEAM.md` (roster đội + phối hợp) và `RELAY.md` (sổ tay chuyển tiếp) thành file riêng, rõ ràng hơn.
+- 🔐 **Quy tắc bảo mật đầy đủ mọi nơi** — Tất cả `AGENTS.md` giờ có đủ 4 section bảo mật (File hệ thống, API Key, Ví Crypto, Docker) bất kể OS, mode hay kênh.
+- 🗑️ **Xóa file `.yaml` agent** — OpenClaw Core chỉ đọc từ `openclaw.json`. File `.yaml` orphan không còn được sinh ra.
+- 🤖 **Chống ảo giác handoff** — `AGENTS.md` relay bắt buộc `react` action và cấm từ chối chuyển tiếp giữa các agent.
+- 🏗️ **Scaffold-based generation** — Cả Wizard lẫn CLI gọi chung scaffold builders, đồng nhất trên mọi platform.
+
+<details>
+<summary><b>Trước đó: Có gì mới ở v5.5.0</b></summary>
 
 - 🏗️ **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.
 - 🤝 **Quy tắc cross-workspace trong `AGENTS.md`** — Ở chế độ multi-bot, `AGENTS.md` của mỗi bot có thêm mục liệt kê đường dẫn workspace của các bot anh em và quy tắc phối hợp.
 - 🧹 **Config sạch hơn** — Không còn tạo `auth-profiles.json` per-agent cho 9Router; không còn tạo `.env` cho native scripts; không còn tạo `models.json` per-agent cho Ollama.
 
-<details>
-<summary><b>Trước đó: Có gì mới ở v5.3.5</b></summary>
-
-- 🐛 **Fix: Lỗi Syntax MEMORY.md trong Workspace Zalo** — Patch TOOLS.md trước đó được chèn sai vị trí, gây `SyntaxError` trên `setup.js`. Đã sửa.
-- 🐟 **Cải tiến: Script gỡ cài đặt nằm trong thư mục project** — Tất cả 4 OS native + Docker ZIP đều có `uninstall-*.{bat,sh}` ngay trong thư mục project sau khi setup xong.
-- 🐛 **Fix: Windows Docker script crashes với "docker not recognized"** — File `.ps1` được tạo giờ dùng `Get-Command` để tìm Docker, kiểm tra Docker Desktop đang chạy, và gọi lệnh qua toán tử `&` — hoạt động kể cả khi Docker không có trong PATH mặc định của PowerShell.
-- 🐛 **Fix: Thiếu hướng dẫn login Zalo QR cho combo trong script Windows** — Phần hướng dẫn sau cài đặt giờ hiển thị lệnh `docker compose exec` login khi chọn combo channel.
-
 </details>
 
 ---
@@ -111,7 +113,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.2 cho tôi.
+   Đọc SETUP.md và cài đặt OpenClaw v5.5.0 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/package.json

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

package/setup/data/channels.js

@@ -0,0 +1,164 @@
+// @ts-nocheck
+/* eslint-disable no-undef, no-unused-vars */
+/**
+ * @fileoverview Part of the OpenClaw Setup Wizard IIFE bundle.
+ * This file is concatenated (not imported) — globals are shared via setup.js IIFE scope.
+ * Do NOT add import/export statements. Edit, then run: node build.mjs
+ *
+ * @global {object}  state       - Wizard UI state
+ * @global {object}  PROVIDERS   - AI provider registry
+ * @global {Array}   SKILLS      - Available skills
+ * @global {Array}   PLUGINS     - Available plugins
+ * @global {object}  CHANNELS    - Channel definitions
+ * @global {boolean} isVi        - Vietnamese language mode
+ * @global {object}  provider    - Current primary provider config
+ * @global {boolean} isMultiBot  - Multi-bot mode flag
+ * @global {boolean} hasBrowser  - Browser plugin selected
+ * @global {boolean} is9Router   - 9Router proxy mode
+ * @global {string}  projectDir  - Output project directory path
+ * @global {Function} getGatewayAllowedOrigins
+ */
+  // ========== Channel definitions ==========
+  const CHANNELS = {
+    telegram: {
+      name: 'Telegram',
+      envKeys: [],
+      envExtra: 'TELEGRAM_BOT_TOKEN=<your_bot_token>',
+      credSteps: [
+        { textVi: 'Mở Telegram → tìm <a href="https://t.me/BotFather" target="_blank">@BotFather</a> → gửi <code>/newbot</code> → đặt tên bot → copy token', textEn: 'Open Telegram → find <a href="https://t.me/BotFather" target="_blank">@BotFather</a> → send <code>/newbot</code> → name bot → copy token' },
+      ],
+      channelConfig: {
+        telegram: {
+          enabled: true,
+          dmPolicy: 'open',
+          allowFrom: ['*'],
+          groupPolicy: 'allowlist',
+          streaming: 'partial',
+        },
+      },
+      pluginInstall: '',
+    },
+    'zalo-bot': {
+      name: 'Zalo Bot API',
+      envKeys: [],
+      envExtra: 'ZALO_BOT_TOKEN=<your_zalo_bot_token>',
+      credSteps: [
+        { textVi: '<span style="color: #fbbf24; font-weight: 500;">⚠️ LƯU Ý: Bot OA Zalo đòi hỏi bạn phải thiết lập Webhook Public (qua VPS/ngrok có HTTPS). Hãy cân nhắc dùng Zalo Personal nếu bạn chưa có Webhook.</span>', textEn: '<span style="color: #fbbf24; font-weight: 500;">⚠️ NOTE: Zalo OA Bot requires setting up a Public Webhook (using VPS/ngrok with HTTPS). Consider using Zalo Personal if you do not have a webhook.</span>' },
+        { textVi: 'Vào <a href="https://developers.zalo.me" target="_blank">Zalo Bot Platform</a> → Tạo bot mới → copy Bot Token', textEn: 'Go to <a href="https://developers.zalo.me" target="_blank">Zalo Bot Platform</a> → Create new bot → copy Bot Token' },
+      ],
+      channelConfig: {
+        zalo: {
+          enabled: true,
+        },
+      },
+      pluginInstall: '',
+    },
+    // 'telegram+zalo-personal' — Combo mode tạm ngưng, nghiên cứu thêm.
+    'zalo-personal': {
+      name: 'Zalo Personal',
+      envKeys: [],
+      envExtra: '',
+      credSteps: [
+        { textVi: '⚠️ Zalo Personal dùng <strong>unofficial API (zca-js)</strong> — chỉ nên dùng tài khoản phụ', textEn: '⚠️ Zalo Personal uses <strong>unofficial API (zca-js)</strong> — use an alternate account' },
+        { textVi: 'Native setup sẽ tự chạy login và copy QR về thư mục project. Nếu cần chạy lại thủ công, dùng <code>openclaw channels login --channel zalouser --verbose</code>.', textEn: 'Native setup now auto-runs the login flow and copies the QR into the project folder. If needed, rerun it manually with <code>openclaw channels login --channel zalouser --verbose</code>.' },
+      ],
+      channelConfig: {
+        zalouser: {
+          enabled: true,
+          accounts: {
+            default: {
+              dmPolicy: 'open',
+              allowFrom: ['*'],
+              groupPolicy: 'allowlist',
+            },
+          },
+          dmPolicy: 'open',
+          groupPolicy: 'allowlist',
+        },
+      },
+      pluginInstall: '@openclaw/zalouser',
+    },
+  };
+
+  // ========== Default system prompts ==========
+  const DEFAULT_PROMPTS = {
+    vi: `Bạn là {BOT_NAME}, {BOT_DESC}.
+
+## Tính cách
+- Thân thiện, hữu ích
+- Trả lời bằng tiếng Việt
+- Giọng văn tự nhiên, gần gũi
+
+## Quy tắc
+- Trả lời ngắn gọn, súc tích
+- Hỏi lại khi chưa rõ yêu cầu`,
+    en: `You are {BOT_NAME}, {BOT_DESC}.
+
+## Personality
+- Friendly and helpful
+- Reply in English
+- Natural, conversational tone
+
+## Rules
+- Keep answers concise
+- Ask for clarification when needed`,
+  };
+
+  // ========== Default Security Rules ==========
+  const DEFAULT_SECURITY_RULES = {
+    vi: `## 🔐 Quy Tắc Bảo Mật — BẮT BUỘC
+
+### File & thư mục hệ thống
+- ❌ KHÔNG đọc, sao chép, hoặc truy cập bất kỳ file nào ngoài thư mục project
+- ❌ KHÔNG quét hoặc liệt kê các thư mục hệ thống: Documents, Desktop, Downloads, AppData
+- ❌ KHÔNG truy cập registry, system32, hoặc Program Files
+- ❌ KHÔNG cài đặt phần mềm, driver, hoặc service ngoài Docker
+- ✅ CHỈ làm việc trong thư mục project
+
+### API key & credentials
+- ❌ KHÔNG BAO GIỜ hiển thị API key, token, hoặc mật khẩu trong chat
+- ❌ KHÔNG viết API key trực tiếp vào mã nguồn
+- ❌ KHÔNG commit file credentials lên Git
+- ✅ LUÔN lưu credentials trong file .env riêng
+- ✅ LUÔN dùng biến môi trường thay vì hardcode
+
+### Ví crypto & tài sản số
+- ❌ TUYỆT ĐỐI KHÔNG truy cập, đọc, hoặc quét các thư mục ví crypto
+- ❌ KHÔNG quét clipboard (có thể chứa seed phrases)
+- ❌ KHÔNG truy cập browser profile, cookie, hoặc mật khẩu đã lưu
+- ❌ KHÔNG cài đặt npm package lạ (chỉ openclaw và plugin chính thức)
+
+### Docker
+- ✅ Chỉ mount đúng thư mục cần thiết (config + workspace)
+- ❌ KHÔNG mount nguyên ổ đĩa (C:/ hoặc D:/)
+- ❌ KHÔNG chạy container với --privileged
+- ✅ Giới hạn port expose (chỉ 38789)`,
+    en: `## 🔐 Security Rules — MANDATORY
+
+### System files & directories
+- ❌ DO NOT read, copy, or access any file outside the project folder
+- ❌ DO NOT scan or list system directories: Documents, Desktop, Downloads, AppData
+- ❌ DO NOT access the registry, system32, or Program Files
+- ❌ DO NOT install software, drivers, or services outside Docker
+- ✅ ONLY work within the project folder
+
+### API keys & credentials
+- ❌ NEVER display API keys, tokens, or passwords in chat
+- ❌ DO NOT write API keys directly into source code
+- ❌ DO NOT commit credential files to Git
+- ✅ ALWAYS store credentials in a separate .env file
+- ✅ ALWAYS use environment variables instead of hardcoding
+
+### Crypto wallets & digital assets
+- ❌ ABSOLUTELY DO NOT access, read, or scan crypto wallet directories
+- ❌ DO NOT scan the clipboard (may contain seed phrases)
+- ❌ DO NOT access browser profiles, cookies, or saved passwords
+- ❌ DO NOT install unknown npm packages (only openclaw and official plugins)
+
+### Docker
+- ✅ Only mount required directories (config + workspace)
+- ❌ DO NOT mount entire drives (C:/ or D:/)
+- ❌ DO NOT run containers with --privileged
+- ✅ Limit exposed ports (only 38789)`,
+  };
+

package/setup/data/header.js

@@ -0,0 +1,80 @@
+// @ts-nocheck
+/* eslint-disable no-undef, no-unused-vars */
+/**
+ * @fileoverview Part of the OpenClaw Setup Wizard IIFE bundle.
+ * This file is concatenated (not imported) — globals are shared via setup.js IIFE scope.
+ * Do NOT add import/export statements. Edit, then run: node build.mjs
+ *
+ * @global {object}  state       - Wizard UI state
+ * @global {object}  PROVIDERS   - AI provider registry
+ * @global {Array}   SKILLS      - Available skills
+ * @global {Array}   PLUGINS     - Available plugins
+ * @global {object}  CHANNELS    - Channel definitions
+ * @global {boolean} isVi        - Vietnamese language mode
+ * @global {object}  provider    - Current primary provider config
+ * @global {boolean} isMultiBot  - Multi-bot mode flag
+ * @global {boolean} hasBrowser  - Browser plugin selected
+ * @global {boolean} is9Router   - 9Router proxy mode
+ * @global {string}  projectDir  - Output project directory path
+ * @global {Function} getGatewayAllowedOrigins
+ */
+  // ========== CDN Logo URLs (thesvg.org) ==========
+  const SVG_CDN = 'https://thesvg.org/icons';
+  const LOGO = {
+    gemini: `${SVG_CDN}/google-gemini/default.svg`,
+    anthropic: `${SVG_CDN}/anthropic/light.svg`,
+    openai: `${SVG_CDN}/openai/light.svg`,
+    openrouter: `${SVG_CDN}/openrouter/light.svg`,
+    ollama: `${SVG_CDN}/ollama/light.svg`,
+    '9router': null, // Uses emoji icon 🔀 instead of SVG
+  };
+
+  // Language flag icons (inline SVG circles with flag colors)
+  const FLAG_ICONS = {
+    vi: `<svg width="20" height="20" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg"><circle cx="10" cy="10" r="10" fill="#DA251D"/><polygon points="10,4 11.5,8.5 16,8.5 12.3,11.2 13.8,15.7 10,13 6.2,15.7 7.7,11.2 4,8.5 8.5,8.5" fill="#FFFF00"/></svg>`,
+    en: `<svg width="20" height="20" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg"><circle cx="10" cy="10" r="10" fill="#012169"/><path d="M0 0L20 20M20 0L0 20" stroke="white" stroke-width="3"/><path d="M0 0L20 20M20 0L0 20" stroke="#C8102E" stroke-width="1.5"/><path d="M10 0V20M0 10H20" stroke="white" stroke-width="5"/><path d="M10 0V20M0 10H20" stroke="#C8102E" stroke-width="3"/></svg>`,
+  };
+
+  // ========== State ==========
+  const state = {
+    currentStep: 1,
+    totalSteps: 5,
+    channel: null,
+    deployMode: 'docker', // 'docker' | 'native'
+    nativeOs: 'win',     // 'win' | 'linux' | 'vps' | 'linux-desktop'
+    config: {
+      botName: '',
+      description: '',
+      emoji: '🤖',
+      provider: 'google',
+      model: 'google/gemini-2.5-flash',
+      language: 'vi',
+      systemPrompt: '',
+      userInfo: '',
+      securityRules: '',
+      plugins: [],
+      skills: [],
+      // Persisted credential inputs (Bug 1+2 fix)
+      botToken: '',
+      apiKey: '',
+      projectPath: '',
+    },
+  };
+
+  // Runtime packages installed alongside openclaw in native and Docker flows.
+  const openClawRuntimePackages = globalThis.__openclawCommon?.OPENCLAW_RUNTIME_PACKAGES
+    || 'grammy @grammyjs/runner @grammyjs/transformer-throttler @buape/carbon @larksuiteoapi/node-sdk @slack/web-api';
+
+  function getGatewayAllowedOrigins(port) {
+    const normalizedPort = Number(port) || 18791;
+    const origins = new Set([
+      `http://localhost:${normalizedPort}`,
+      `http://127.0.0.1:${normalizedPort}`,
+      `http://0.0.0.0:${normalizedPort}`,
+    ]);
+    const currentHost = (window.location && window.location.hostname) ? window.location.hostname.trim() : '';
+    if (currentHost) {
+      origins.add(`http://${currentHost}:${normalizedPort}`);
+    }
+    return Array.from(origins);
+  }

package/setup/data/index.js

@@ -0,0 +1,73 @@
+// @ts-nocheck
+/**
+ * setup/data/index.js — Shared data for CLI + Wizard
+ *
+ * Provides CLI-compatible views of PROVIDERS, SKILLS, CHANNELS, and OLLAMA_MODELS.
+ * The wizard uses these via IIFE concatenation (providers.js, skills.js, channels.js).
+ * The CLI imports this file directly via createRequire.
+ *
+ * Structure deliberately kept flat & forward-compatible:
+ *   - PROVIDERS: { [key]: { name, icon, envKey?, isProxy?, isLocal? } }
+ *   - SKILLS:    [{ value, name, slug? }]
+ *   - CHANNELS:  { [key]: { name, type, icon } }
+ *   - OLLAMA_MODELS: [{ id, name, reasoning, input, cost, contextWindow, maxTokens }]
+ */
+(function (root) {
+  // ── CLI-facing PROVIDERS (display + config metadata) ──────────────────────────
+  // Keep in sync with setup/data/providers.js model IDs
+  const PROVIDERS = {
+    '9router':   { name: '9Router Proxy (Khuyên dùng)',  icon: '🔀', isProxy: true },
+    'openai':    { name: 'OpenAI (ChatGPT)',              icon: '🧠', envKey: 'OPENAI_API_KEY' },
+    'ollama':    { name: 'Local Ollama',                  icon: '🏠', isLocal: true },
+    'google':    { name: 'Google (Gemini)',               icon: '⚡', envKey: 'GEMINI_API_KEY' },
+    'anthropic': { name: 'Anthropic (Claude)',            icon: '🦄', envKey: 'ANTHROPIC_API_KEY' },
+    'xai':       { name: 'xAI (Grok)',                   icon: '✖️', envKey: 'XAI_API_KEY' },
+    'groq':      { name: 'Groq (LPU)',                   icon: '🏎️', envKey: 'GROQ_API_KEY' },
+    'openrouter':{ name: 'OpenRouter',                   icon: '🌐', envKey: 'OPENROUTER_API_KEY' },
+  };
+
+  // ── CLI-facing SKILLS (value = selection key, slug = ClawHub package name) ────
+  // Keep in sync with setup/data/skills.js skill IDs
+  const SKILLS = [
+    { value: 'browser',          name: '🌐 Browser Automation (Playwright) (⭐ Khuyên dùng)', slug: null },
+    { value: 'memory',           name: '🧠 Long-term Memory (⭐ Khuyên dùng)',                 slug: 'memory' },
+    { value: 'scheduler',        name: '⏰ Native Cron Scheduler (⭐ Khuyên dùng)',             slug: null },
+    { value: 'rag',              name: '📚 RAG / Knowledge Base',                              slug: 'rag' },
+    { value: 'image-gen',        name: '🎨 Image Generation (DALL·E / Flux)',                  slug: 'image-gen' },
+    { value: 'code-interpreter', name: '💻 Code Interpreter (Python/JS)',                      slug: 'code-interpreter' },
+    { value: 'email',            name: '📧 Email Assistant',                                   slug: 'email-assistant' },
+    { value: 'tts',              name: '🔊 Text-To-Speech (OpenAI/ElevenLabs)',                slug: 'tts' },
+    { value: 'web-search',       name: '🔍 Web Search',                                        slug: 'web-search' },
+  ];
+
+  // ── CLI-facing CHANNELS ───────────────────────────────────────────────────────
+  // Keep in sync with setup/data/channels.js channel keys
+  const CHANNELS = {
+    'telegram':           { name: 'Telegram',                     type: 'telegram',           icon: '🤖' },
+    'zalo-bot':           { name: 'Zalo OA (Bot Platform)',        type: 'zalo-bot',           icon: '🔑' },
+    'zalo-personal':      { name: 'Zalo Personal (Quét QR)',       type: 'zalo-personal',      icon: '📱' },
+  };
+
+  // ── Ollama model definitions (single source of truth for all config JSON writes) ──
+  // Used in: models.json per-agent, openclaw.json models.providers.ollama
+  const OLLAMA_MODELS = [
+    { id: 'gemma4:e2b',     name: 'Gemma 4 E2B',    reasoning: false, input: ['text'], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 128000, maxTokens: 8192 },
+    { id: 'gemma4:e4b',     name: 'Gemma 4 E4B',    reasoning: false, input: ['text'], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 128000, maxTokens: 8192 },
+    { id: 'gemma4:26b',     name: 'Gemma 4 26B',    reasoning: false, input: ['text'], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 128000, maxTokens: 8192 },
+    { id: 'gemma4:31b',     name: 'Gemma 4 31B',    reasoning: false, input: ['text'], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 128000, maxTokens: 8192 },
+    { id: 'qwen3:8b',       name: 'Qwen 3 8B',      reasoning: false, input: ['text'], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 128000, maxTokens: 8192 },
+    { id: 'deepseek-r1:8b', name: 'DeepSeek R1 8B', reasoning: true,  input: ['text'], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 64000,  maxTokens: 8192 },
+    { id: 'llama3.3:8b',    name: 'Llama 3.3 8B',   reasoning: false, input: ['text'], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 128000, maxTokens: 8192 },
+    { id: 'gemma3:12b',     name: 'Gemma 3 12B',    reasoning: false, input: ['text'], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 128000, maxTokens: 8192 },
+  ];
+
+  // ── Node.js export (for CLI via createRequire) ────────────────────────────────
+  if (typeof module !== 'undefined' && module.exports) {
+    module.exports = { PROVIDERS, SKILLS, CHANNELS, OLLAMA_MODELS };
+  }
+
+  // ── Browser global (future use if wizard imports this directly) ───────────────
+  if (typeof root !== 'undefined') {
+    root.__openclawData = { PROVIDERS, SKILLS, CHANNELS, OLLAMA_MODELS };
+  }
+})(typeof globalThis !== 'undefined' ? globalThis : (typeof window !== 'undefined' ? window : {}));

package/setup/data/plugins.js

@@ -0,0 +1,60 @@
+// @ts-nocheck
+/* eslint-disable no-undef, no-unused-vars */
+/**
+ * @fileoverview Part of the OpenClaw Setup Wizard IIFE bundle.
+ * This file is concatenated (not imported) — globals are shared via setup.js IIFE scope.
+ * Do NOT add import/export statements. Edit, then run: node build.mjs
+ *
+ * @global {object}  state       - Wizard UI state
+ * @global {object}  PROVIDERS   - AI provider registry
+ * @global {Array}   SKILLS      - Available skills
+ * @global {Array}   PLUGINS     - Available plugins
+ * @global {object}  CHANNELS    - Channel definitions
+ * @global {boolean} isVi        - Vietnamese language mode
+ * @global {object}  provider    - Current primary provider config
+ * @global {boolean} isMultiBot  - Multi-bot mode flag
+ * @global {boolean} hasBrowser  - Browser plugin selected
+ * @global {boolean} is9Router   - 9Router proxy mode
+ * @global {string}  projectDir  - Output project directory path
+ * @global {Function} getGatewayAllowedOrigins
+ */
+  // ========== Available Plugins (npm packages — runtime/channel extensions) ==========
+  const PLUGINS = [
+    {
+      id: 'telegram-multibot-relay',
+      name: 'Telegram Multi-Bot Relay',
+      icon: '🤝',
+      descVi: 'Điều phối nhiều bot Telegram trong cùng group — tự động khi chọn nhiều bot', descEn: 'Coordinate multiple Telegram bots in one group — auto-selected with multi-bot',
+      package: 'openclaw-telegram-multibot-relay',
+      hidden: true, // hidden in UI, auto-selected programmatically
+    },
+    {
+      id: 'voice-call',
+      name: 'Voice Call',
+      icon: '📞',
+      descVi: 'Gọi thoại AI qua điện thoại', descEn: 'AI voice calls via phone',
+      package: '@openclaw/voice-call',
+    },
+    {
+      id: 'matrix',
+      name: 'Matrix Chat',
+      icon: '💬',
+      descVi: 'Kết nối thêm kênh Matrix/Element', descEn: 'Connect to Matrix/Element channels',
+      package: '@openclaw/matrix',
+    },
+    {
+      id: 'msteams',
+      name: 'MS Teams',
+      icon: '🏢',
+      descVi: 'Kết nối Microsoft Teams', descEn: 'Connect Microsoft Teams',
+      package: '@openclaw/msteams',
+    },
+    {
+      id: 'nostr',
+      name: 'Nostr',
+      icon: '🟣',
+      descVi: 'Kết nối mạng xã hội Nostr', descEn: 'Connect Nostr social network',
+      package: '@openclaw/nostr',
+    },
+  ];
+