create-openclaw-bot 5.0.8 → 5.1.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Changelog (English)
 
-## [5.0.8] — 2026-04-06
+## [5.0.9] — 2026-04-06
 
 ### 🚀 Native Install Mode — No Docker Required
 

package/CHANGELOG.vi.md

@@ -1,6 +1,6 @@
 # Changelog (Tiếng Việt)
 
-## [5.0.8] — 2026-04-06
+## [5.0.9] — 2026-04-06
 
 ### 🚀 Chế độ Native Install — Không cần Docker
 

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.0.8-0EA5E9?style=for-the-badge" alt="Version 5.0.8" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.1.0-0EA5E9?style=for-the-badge" alt="Version 5.1.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,7 +24,7 @@ An interactive **CLI tool** and **Setup Wizard** to deploy your own free AI Bot
 
 ---
 
-## 🆕 What's new in v5.0.8
+## 🆕 What's new in v5.1.0
 
 - 💻 **OS-First Setup** — Step 1 is now choosing your OS (Windows, macOS, Ubuntu, VPS). All scripts, configs, and instructions are generated to match.
 - 🧠 **Gemma 4 — 4 sizes** — `gemma4:e2b` (~4 GB), `gemma4:e4b` (~8 GB), `gemma4:26b` (~18 GB), `gemma4:31b` (~24 GB). Auto-pulled on first launch.
@@ -111,7 +111,7 @@ Run in your terminal → follow the interactive prompts → startup script is ge
 2. Open this repo as your workspace
 3. Paste into chat:
    ```
-   Read SETUP.md and set up OpenClaw v5.0.8 for me.
+   Read SETUP.md and set up OpenClaw v5.1.0 for me.
    My bot token is X. Use 9Router (no API key).
    My project folder: <YOUR_PATH>
    ```

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.0.8-0EA5E9?style=for-the-badge" alt="Version 5.0.8" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.1.0-0EA5E9?style=for-the-badge" alt="Version 5.1.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,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.0.8
+## 🆕 Có gì mới trong v5.1.0
 
 - 💻 **OS-First Setup** — Bước đầu tiên bây giờ là chọn hệ điều hành của bạn (Windows, macOS, Ubuntu, VPS). Toàn bộ script, cấu hình và hướng dẫn được tạo ra phù hợp với lựa chọn đó.
 - 🧠 **Gemma 4 — 4 kích thước** — `gemma4:e2b` (~4 GB), `gemma4:e4b` (~8 GB), `gemma4:26b` (~18 GB), `gemma4:31b` (~24 GB). Tự pull về khi bot khởi động lần đầu.
@@ -111,7 +111,7 @@ Chạy lệnh trên trong Terminal → làm theo các prompt tương tác → sc
 2. Mở repo này làm workspace
 3. Paste vào chat:
    ```
-   Read SETUP.md and set up OpenClaw v5.0.8 for me.
+   Read SETUP.md and set up OpenClaw v5.1.0 for me.
    My bot token is X. Use 9Router (no API key).
    My project folder: <THƯ_MỤC_CỦA_BẠN>
    ```

package/cli.js

@@ -160,6 +160,23 @@ function installGlobalPackage(pkg, { isVi, osChoice, displayName }) {
   return false;
 }
 
+function build9RouterSmartRouteSyncScript(dbPath) {
+  const safeDbPath = JSON.stringify(dbPath);
+  return `const fs=require('fs');
+const INTERVAL=30000;
+const p=${safeDbPath};
+const PM={codex:['cx/gpt-5.4','cx/gpt-5.3-codex','cx/gpt-5.3-codex-high','cx/gpt-5.2-codex','cx/gpt-5.2','cx/gpt-5.1-codex-max','cx/gpt-5.1-codex','cx/gpt-5.1','cx/gpt-5-codex'],claude-code:['cc/claude-opus-4-6','cc/claude-sonnet-4-6','cc/claude-opus-4-5-20251101','cc/claude-sonnet-4-5-20250929','cc/claude-haiku-4-5-20251001'],github:['gh/gpt-5.4','gh/gpt-5.3-codex','gh/gpt-5.2-codex','gh/gpt-5.2','gh/gpt-5.1-codex-max','gh/gpt-5.1-codex','gh/gpt-5.1','gh/gpt-5','gh/gpt-4.1','gh/gpt-4o','gh/claude-opus-4.6','gh/claude-sonnet-4.6','gh/claude-sonnet-4.5','gh/claude-opus-4.5','gh/claude-haiku-4.5','gh/gemini-3-pro-preview','gh/gemini-3-flash-preview','gh/gemini-2.5-pro'],cursor:['cu/default','cu/claude-4.6-opus-max','cu/claude-4.5-opus-high-thinking','cu/claude-4.5-sonnet-thinking','cu/claude-4.5-sonnet','cu/gpt-5.3-codex','cu/gpt-5.2-codex','cu/gemini-3-flash-preview'],kilo:['kc/anthropic/claude-sonnet-4-20250514','kc/anthropic/claude-opus-4-20250514','kc/google/gemini-2.5-pro','kc/google/gemini-2.5-flash','kc/openai/gpt-4.1','kc/deepseek/deepseek-chat'],cline:['cl/anthropic/claude-sonnet-4.6','cl/anthropic/claude-opus-4.6','cl/openai/gpt-5.3-codex','cl/openai/gpt-5.4','cl/google/gemini-3.1-pro-preview'],'gemini-cli':['gc/gemini-3-flash-preview','gc/gemini-3-pro-preview'],iflow:['if/qwen3-coder-plus','if/kimi-k2','if/kimi-k2-thinking','if/glm-4.7','if/deepseek-r1','if/deepseek-v3.2','if/deepseek-v3','if/qwen3-max','if/qwen3-235b','if/iflow-rome-30ba3b'],qwen:['qw/qwen3-coder-plus','qw/qwen3-coder-flash','qw/vision-model','qw/coder-model'],kiro:['kr/claude-sonnet-4.5','kr/claude-haiku-4.5','kr/deepseek-3.2','kr/deepseek-3.1','kr/qwen3-coder-next'],ollama:['ollama/gemma4:e2b','ollama/gemma4:e4b','ollama/gemma4:26b','ollama/gemma4:31b','ollama/qwen3.5','ollama/kimi-k2.5','ollama/glm-5','ollama/glm-4.7-flash','ollama/minimax-m2.5','ollama/gpt-oss:120b'],'kimi-coding':['kmc/kimi-k2.5','kmc/kimi-k2.5-thinking','kmc/kimi-latest'],glm:['glm/glm-5.1','glm/glm-5','glm/glm-4.7'],'glm-cn':['glm/glm-5.1','glm/glm-5','glm/glm-4.7'],minimax:['minimax/MiniMax-M2.7','minimax/MiniMax-M2.5','minimax/MiniMax-M2.1'],kimi:['kimi/kimi-k2.5','kimi/kimi-k2.5-thinking','kimi/kimi-latest'],deepseek:['deepseek/deepseek-chat','deepseek/deepseek-reasoner'],xai:['xai/grok-4','xai/grok-4-fast-reasoning','xai/grok-code-fast-1'],mistral:['mistral/mistral-large-latest','mistral/codestral-latest'],groq:['groq/llama-3.3-70b-versatile','groq/openai/gpt-oss-120b'],cerebras:['cerebras/gpt-oss-120b'],alicode:['alicode/qwen3.5-plus','alicode/qwen3-coder-plus'],openai:['openai/gpt-4o','openai/gpt-4.1'],anthropic:['anthropic/claude-sonnet-4','anthropic/claude-haiku-3.5'],gemini:['gemini/gemini-2.5-flash','gemini/gemini-2.5-pro']};
+console.log('[sync-combo] 9Router sync loop started...');
+const sync=()=>{try{let db={};try{db=JSON.parse(fs.readFileSync(p,'utf8'));}catch{}if(!db.combos)db.combos=[];const removeSmartRoute=()=>{const next=db.combos.filter(x=>x.id!=='smart-route');if(next.length!==db.combos.length){db.combos=next;fs.writeFileSync(p,JSON.stringify(db,null,2));console.log('[sync-combo] Removed smart-route (no active providers)');}};const a=(db.providerConnections||[]).filter(c=>c&&c.provider&&c.isActive!==false&&!c.disabled).map(c=>c.provider);if(!a.length){removeSmartRoute();return;}const PREF=['openai','anthropic','claude-code','codex','cursor','github','cline','kimi','minimax','deepseek','glm','alicode','xai','mistral','kilo','kiro','iflow','qwen','gemini-cli','ollama'];a.sort((x,y)=>(PREF.indexOf(x)===-1?99:PREF.indexOf(x))-(PREF.indexOf(y)===-1?99:PREF.indexOf(y)));const m=a.flatMap(provider=>PM[provider]||[]);if(!m.length){removeSmartRoute();return;}const c={id:'smart-route',name:'smart-route',alias:'smart-route',models:m};const i=db.combos.findIndex(x=>x.id==='smart-route');if(i>=0){if(JSON.stringify(db.combos[i].models)!==JSON.stringify(c.models)){db.combos[i]=c;fs.writeFileSync(p,JSON.stringify(db,null,2));console.log('[sync-combo] Updated smart-route: '+c.models.length+' models');}}else{db.combos.push(c);fs.writeFileSync(p,JSON.stringify(db,null,2));console.log('[sync-combo] Created smart-route: '+c.models.length+' models');}}catch{}};sync();setInterval(sync,INTERVAL);`;
+}
+
+async function writeNative9RouterSyncScript(projectDir) {
+  const syncScriptPath = path.join(projectDir, '.openclaw', '9router-smart-route-sync.js');
+  await fs.ensureDir(path.dirname(syncScriptPath));
+  await fs.writeFile(syncScriptPath, build9RouterSmartRouteSyncScript(path.join(os.homedir(), '.9router', 'db.json')));
+  return syncScriptPath;
+}
+
 function extractFirstHttpUrl(text) {
   const match = String(text || '').match(/https?:\/\/[^\s"'`]+/);
   return match ? match[0] : null;
@@ -209,10 +226,44 @@ function printNativeDashboardAccessInfo({ isVi, providerKey, projectDir, gateway
   }
 }
 
-function startNative9RouterPm2({ isVi, projectDir, appName }) {
+function printZaloPersonalLoginInfo({ isVi, deployMode, projectDir }) {
+  const nativeCmd = 'openclaw channels login --channel zalouser --verbose';
+  const dockerCmd = 'docker compose exec -it ai-bot openclaw channels login --channel zalouser --verbose';
+  const cmd = deployMode === 'native' ? nativeCmd : dockerCmd;
+  const qrPath = '/tmp/openclaw/openclaw-zalouser-qr-default.png';
+  const copyCmd = deployMode === 'native'
+    ? `cp ${qrPath} ./zalo-login-qr.png`
+    : `docker compose cp ai-bot:${qrPath} ./zalo-login-qr.png`;
+
+  console.log(chalk.yellow(`\n📱 ${isVi ? 'Đăng nhập Zalo Personal (1 lần):' : 'Zalo Personal login (one time):'}`));
+  console.log(chalk.white(`   cd ${projectDir}${deployMode === 'native' ? '' : '/docker/openclaw'} && ${cmd}`));
+  console.log(chalk.gray(isVi
+    ? `   → OpenClaw sẽ tạo file QR tại: ${qrPath}`
+    : `   → OpenClaw will generate a QR image at: ${qrPath}`));
+  console.log(chalk.gray(isVi
+    ? `   → Nếu cần copy QR ra ngoài, dùng: ${copyCmd}`
+    : `   → If needed, copy the QR out with: ${copyCmd}`));
+}
+
+function runPm2Save({ projectDir, isVi }) {
+  try {
+    execSync('pm2 save', {
+      cwd: projectDir,
+      stdio: 'inherit',
+      shell: true,
+      env: process.env
+    });
+  } catch {
+    console.log(chalk.yellow(isVi
+      ? '⚠️  PM2 save khong hoan tat. Bot van co the dang chay, nhung hay thu chay lai `pm2 save` sau.'
+      : '⚠️  PM2 save did not complete. The app may still be running, but try `pm2 save` again afterwards.'));
+  }
+}
+
+function startNative9RouterPm2({ isVi, projectDir, appName, syncScriptPath }) {
   const routerAppName = `${appName}-9router`;
   execSync(
-    `pm2 start "9router -n -t -l -H 0.0.0.0 -p 20128 --skip-update" --name "${routerAppName}" --cwd "${projectDir.replace(/\\/g, '/')}" && pm2 save`,
+    `pm2 start "9router -n -t -l -H 0.0.0.0 -p 20128 --skip-update" --name "${routerAppName}" --cwd "${projectDir.replace(/\\/g, '/')}"`,
     {
       cwd: projectDir,
       stdio: 'inherit',
@@ -220,6 +271,19 @@ function startNative9RouterPm2({ isVi, projectDir, appName }) {
       env: process.env
     }
   );
+  if (syncScriptPath) {
+    const syncAppName = `${appName}-9router-sync`;
+    execSync(
+      `pm2 start "${syncScriptPath.replace(/\\/g, '/')}" --name "${syncAppName}" --cwd "${projectDir.replace(/\\/g, '/')}"`,
+      {
+        cwd: projectDir,
+        stdio: 'inherit',
+        shell: true,
+        env: process.env
+      }
+    );
+  }
+  runPm2Save({ projectDir, isVi });
   console.log(chalk.green(`\n✅ ${isVi ? '9Router da duoc khoi dong qua PM2.' : '9Router is running via PM2.'}`));
   console.log(chalk.gray(isVi ? `   Xem log: pm2 logs ${routerAppName}` : `   View logs: pm2 logs ${routerAppName}`));
 }
@@ -877,17 +941,31 @@ const sync = async () => {
   try {
     let db = {};
     try { db = JSON.parse(fs.readFileSync(p, 'utf8')); } catch(e){}
+    if (!db.combos) db.combos = [];
+    const removeSmartRoute = () => {
+      const next = db.combos.filter(x => x.id !== 'smart-route');
+      if (next.length !== db.combos.length) {
+        db.combos = next;
+        fs.writeFileSync(p, JSON.stringify(db, null, 2));
+        console.log('[sync-combo] Removed smart-route (no active providers)');
+      }
+    };
     const a = (db.providerConnections || [])
       .filter(c => c && c.provider && c.isActive !== false && !c.disabled)
       .map(c => c.provider);
-    if (!a.length) return;
+    if (!a.length) {
+      removeSmartRoute();
+      return;
+    }
     
     const PREF = ['openai','anthropic','claude-code','codex','cursor','github','cline','kimi','minimax','deepseek','glm','alicode','xai','mistral','kilo','kiro','iflow','qwen','gemini-cli','ollama'];
     a.sort((x, y) => (PREF.indexOf(x) === -1 ? 99 : PREF.indexOf(x)) - (PREF.indexOf(y) === -1 ? 99 : PREF.indexOf(y)));
     
     const m = a.flatMap(p => PM[p] || []);
-    if (!m.length) return;
-    if (!db.combos) db.combos = [];
+    if (!m.length) {
+      removeSmartRoute();
+      return;
+    }
 
     const c = { id: 'smart-route', name: 'smart-route', alias: 'smart-route', models: m };
     const i = db.combos.findIndex(x => x.id === 'smart-route');
@@ -1580,7 +1658,11 @@ ${hasBrowserDesktop ? `    extra_hosts:
       }
       botConfig.channels['telegram'] = telegramConfig;
     } else if (channelKey === 'zalo-personal') {
-      botConfig.channels['zalo'] = { enabled: true, provider: 'client', autoReply: true };
+      botConfig.channels['zalouser'] = {
+        enabled: true,
+        dmPolicy: 'pairing',
+        autoReply: true
+      };
     } else if (channelKey === 'zalo-bot') {
       botConfig.channels['zalo'] = { enabled: true, provider: 'official_account' };
     }
@@ -1817,8 +1899,7 @@ fi
               : '   → Run scripts/telegram-post-install-check.mjs to get the real links, verify group/privacy, then add the bots and disable privacy mode.'));
           }
         } else if (channelKey === 'zalo-personal') {
-          console.log(chalk.yellow(`\n📱 ${isVi ? 'Vui lòng chạy lệnh sau để đăng nhập Zalo Personal (1 lần duy nhất):' : 'Please run this command to login to Zalo Personal (once):'}`));
-          console.log(`cd ${projectDir} && docker compose exec -it openclaw bun run core:onboard`);
+          printZaloPersonalLoginInfo({ isVi, deployMode: 'docker', projectDir });
         }
       } else {
         console.log(chalk.red(`\n\u274c Docker exited with code ${code}`));
@@ -1906,6 +1987,11 @@ fi
       console.log(chalk.green(isVi ? '✅ 9Router da cai xong!' : '✅ 9Router installed!'));
     }
 
+    let native9RouterSyncScriptPath = null;
+    if (providerKey === '9router') {
+      native9RouterSyncScriptPath = await writeNative9RouterSyncScript(projectDir);
+    }
+
     await syncLocalConfigToHome(projectDir, isVi);
 
     if (isMultiBot && channelKey === 'telegram') {
@@ -1922,7 +2008,7 @@ fi
 
       if (isMultiBot && channelKey === 'telegram') {
         if (providerKey === '9router') {
-          startNative9RouterPm2({ isVi, projectDir, appName: botName || 'openclaw-multibot' });
+          startNative9RouterPm2({ isVi, projectDir, appName: botName || 'openclaw-multibot', syncScriptPath: native9RouterSyncScriptPath });
         }
         execSync('pm2 start ecosystem.config.js && pm2 save', {
           cwd: projectDir,
@@ -1932,10 +2018,13 @@ fi
         console.log(chalk.green(`\n🎉 ${isVi ? 'Setup hoan tat! Multi-bot native dang chay qua PM2.' : 'Setup complete! Native multi-bot is running via PM2.'}`));
         console.log(chalk.gray(isVi ? `   Xem log: pm2 logs ${botName || 'openclaw-multibot'}` : `   View logs: pm2 logs ${botName || 'openclaw-multibot'}`));
         printNativeDashboardAccessInfo({ isVi, providerKey, projectDir });
+        if (channelKey === 'zalo-personal') {
+          printZaloPersonalLoginInfo({ isVi, deployMode: 'native', projectDir });
+        }
       } else {
         const appName = botName || 'openclaw';
         if (providerKey === '9router') {
-          startNative9RouterPm2({ isVi, projectDir, appName });
+          startNative9RouterPm2({ isVi, projectDir, appName, syncScriptPath: native9RouterSyncScriptPath });
         }
         execSync(`pm2 start "openclaw gateway run" --name "${appName}" --cwd "${projectDir.replace(/\\/g, '/')}" && pm2 save`, {
           cwd: projectDir,
@@ -1945,6 +2034,9 @@ fi
         console.log(chalk.green(`\n🎉 ${isVi ? 'Setup hoan tat! Bot native dang chay qua PM2.' : 'Setup complete! Native bot is running via PM2.'}`));
         console.log(chalk.gray(isVi ? `   Xem log: pm2 logs ${appName}` : `   View logs: pm2 logs ${appName}`));
         printNativeDashboardAccessInfo({ isVi, providerKey, projectDir });
+        if (channelKey === 'zalo-personal') {
+          printZaloPersonalLoginInfo({ isVi, deployMode: 'native', projectDir });
+        }
       }
     } else {
       if (providerKey === '9router') {
@@ -1955,10 +2047,21 @@ fi
           stdio: 'ignore',
           shell: process.platform === 'win32'
         }).unref();
+        if (native9RouterSyncScriptPath) {
+          spawn('node', [native9RouterSyncScriptPath], {
+            cwd: projectDir,
+            detached: true,
+            stdio: 'ignore',
+            shell: process.platform === 'win32'
+          }).unref();
+        }
         console.log(chalk.gray(isVi
           ? '   9Router dashboard: http://localhost:20128/dashboard'
           : '   9Router dashboard: http://localhost:20128/dashboard'));
       }
+      if (channelKey === 'zalo-personal') {
+        printZaloPersonalLoginInfo({ isVi, deployMode: 'native', projectDir });
+      }
       console.log(chalk.yellow(`\n${isVi ? 'Khoi dong native bot (foreground)...' : 'Starting native bot (foreground)...'}`));
       const child = spawn('openclaw', ['gateway', 'run'], {
         cwd: projectDir,

package/docs/install-native.md

@@ -2,7 +2,7 @@
 
 Native installation is designed for users who cannot or prefer not to use Docker. This includes deployments on Shared Hosting (cPanel), low-tier VPS environments, or Windows desktops for direct access.
 
-OpenClaw v5.0.8+ natively supports deployment script generation for Windows, Linux, VPS, and Hosting environments.
+OpenClaw v5.1.0+ natively supports deployment script generation for Windows, Linux, VPS, and Hosting environments.
 
 ---
 

package/docs/install-native.vi.md

@@ -2,7 +2,7 @@
 
 Chế độ Native được thiết kế dành cho những ai không thể hoặc không muốn cài Docker. Chế độ này thường tối ưu cho Shared Hosting (cPanel), các gói VPS cấu hình rất thấp, hoặc cài trực tiếp trên máy Window để chạy cá nhân.
 
-OpenClaw v5.0.8+ tự động sinh sẵn các script cài đặt dành riêng cho Windows, Linux, VPS và Hosting.
+OpenClaw v5.1.0+ tự động sinh sẵn các script cài đặt dành riêng cho Windows, Linux, VPS và Hosting.
 
 ---
 

package/package.json

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

package/setup.js

@@ -271,16 +271,16 @@
       },
       pluginInstall: '',
     },
-    '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: 'Sau khi Docker chạy, chạy <code>docker exec -it openclaw-bot openclaw onboard</code> để <strong>quét QR code</strong> login Zalo.', textEn: 'After Docker starts, run <code>docker exec -it openclaw-bot openclaw onboard</code> to <strong>scan QR code</strong> and login Zalo. 1-time setup.' },
-      ],
-      channelConfig: {
-        zalouser: {
+    '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: 'Sau khi runtime chạy, dùng <code>openclaw channels login --channel zalouser --verbose</code> để tạo <strong>mã QR đăng nhập Zalo</strong>. Không cần onboard lại.', textEn: 'After the runtime is up, use <code>openclaw channels login --channel zalouser --verbose</code> to generate the <strong>Zalo login QR</strong>. No full onboard needed.' },
+      ],
+      channelConfig: {
+        zalouser: {
           enabled: true,
           accounts: {
             default: {
@@ -1520,7 +1520,7 @@ Write-Host "Chrome se tu dong bat Debug Mode moi khi ban dang nhap Windows (dela
     // Generate native script if native mode
     if (isNativeMode) generateNativeScript();
 
-    // Show/hide Zalo Personal onboard notice
+    // Show/hide Zalo Personal login notice
     const zaloNotice = document.getElementById('zalo-onboard-notice');
     const isZaloPersonal = state.channel === 'zalo-personal';
     if (zaloNotice) {
@@ -1802,7 +1802,7 @@ model:
     const browserPrefix = hasBrowser
       ? 'socat TCP-LISTEN:9222,fork,reuseaddr TCP:host.docker.internal:9222 & '
       : '';
-    // Patch config on every startup to survive openclaw onboard overwrites
+    // Patch config on every startup to keep gateway settings stable
     const patchCmd = `node -e \\"const fs=require('fs'),p='/root/.openclaw/openclaw.json';if(fs.existsSync(p)){const c=JSON.parse(fs.readFileSync(p,'utf8'));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'});fs.writeFileSync(p,JSON.stringify(c,null,2));}\\" && `;
     // Auto-approve device pairing after gateway starts (required since v2026.3.x)
     const autoApproveCmd = '(while true; do sleep 5; openclaw devices approve --latest 2>/dev/null || true; done) & ';
@@ -1841,17 +1841,31 @@ const sync = async () => {
   try {
     let db = {};
     try { db = JSON.parse(fs.readFileSync(p, 'utf8')); } catch(e){}
-    const a = (db.providerConnections || [])
-      .filter(c => c && c.provider && c.isActive !== false && !c.disabled)
-      .map(c => c.provider);
-    if (!a.length) return;
+    if (!db.combos) db.combos = [];
+    const removeSmartRoute = () => {
+      const next = db.combos.filter(x => x.id !== 'smart-route');
+      if (next.length !== db.combos.length) {
+        db.combos = next;
+        fs.writeFileSync(p, JSON.stringify(db, null, 2));
+        console.log('[sync-combo] Removed smart-route (no active providers)');
+      }
+    };
+    const a = (db.providerConnections || [])
+      .filter(c => c && c.provider && c.isActive !== false && !c.disabled)
+      .map(c => c.provider);
+    if (!a.length) {
+      removeSmartRoute();
+      return;
+    }
     
     const PREF = ['openai','anthropic','claude-code','codex','cursor','github','cline','kimi','minimax','deepseek','glm','alicode','xai','mistral','kilo','kiro','iflow','qwen','gemini-cli','ollama'];
     a.sort((x, y) => (PREF.indexOf(x) === -1 ? 99 : PREF.indexOf(x)) - (PREF.indexOf(y) === -1 ? 99 : PREF.indexOf(y)));
     
-    const m = a.flatMap(p => PM[p] || []);
-    if (!m.length) return;
-    if (!db.combos) db.combos = [];
+    const m = a.flatMap(p => PM[p] || []);
+    if (!m.length) {
+      removeSmartRoute();
+      return;
+    }
 
     const c = { id: 'smart-route', name: 'smart-route', alias: 'smart-route', models: m };
     const i = db.combos.findIndex(x => x.id === 'smart-route');
@@ -2832,8 +2846,17 @@ I am **${botName}**. When asked my name, I answer: _"I'm ${botName}"_.`;
       const p = PLUGINS.find((x) => x.id === pid);
       if (p) allPlugins.push(p.package);
     });
-    if (isMultiBot && state.channel === 'telegram') allPlugins.push(relayPluginSpec);
-    const pluginCmd = allPlugins.length > 0 ? ('npm exec openclaw plugins install ' + allPlugins.join(' ')) : '';
+    if (isMultiBot && state.channel === 'telegram') allPlugins.push(relayPluginSpec);
+    const pluginCmd = allPlugins.length > 0 ? ('npm exec openclaw plugins install ' + allPlugins.join(' ')) : '';
+
+    function native9RouterSyncScriptContent() {
+      return `const fs=require('fs');
+const path=require('path');
+const INTERVAL=30000;
+const p=path.join(process.env.HOME||process.env.USERPROFILE||'.','.9router','db.json');
+const PM={codex:['cx/gpt-5.4','cx/gpt-5.3-codex','cx/gpt-5.3-codex-high','cx/gpt-5.2-codex','cx/gpt-5.2','cx/gpt-5.1-codex-max','cx/gpt-5.1-codex','cx/gpt-5.1','cx/gpt-5-codex'],claude-code:['cc/claude-opus-4-6','cc/claude-sonnet-4-6','cc/claude-opus-4-5-20251101','cc/claude-sonnet-4-5-20250929','cc/claude-haiku-4-5-20251001'],github:['gh/gpt-5.4','gh/gpt-5.3-codex','gh/gpt-5.2-codex','gh/gpt-5.2','gh/gpt-5.1-codex-max','gh/gpt-5.1-codex','gh/gpt-5.1','gh/gpt-5','gh/gpt-4.1','gh/gpt-4o','gh/claude-opus-4.6','gh/claude-sonnet-4.6','gh/claude-sonnet-4.5','gh/claude-opus-4.5','gh/claude-haiku-4.5','gh/gemini-3-pro-preview','gh/gemini-3-flash-preview','gh/gemini-2.5-pro'],cursor:['cu/default','cu/claude-4.6-opus-max','cu/claude-4.5-opus-high-thinking','cu/claude-4.5-sonnet-thinking','cu/claude-4.5-sonnet','cu/gpt-5.3-codex','cu/gpt-5.2-codex','cu/gemini-3-flash-preview'],kilo:['kc/anthropic/claude-sonnet-4-20250514','kc/anthropic/claude-opus-4-20250514','kc/google/gemini-2.5-pro','kc/google/gemini-2.5-flash','kc/openai/gpt-4.1','kc/deepseek/deepseek-chat'],cline:['cl/anthropic/claude-sonnet-4.6','cl/anthropic/claude-opus-4.6','cl/openai/gpt-5.3-codex','cl/openai/gpt-5.4','cl/google/gemini-3.1-pro-preview'],'gemini-cli':['gc/gemini-3-flash-preview','gc/gemini-3-pro-preview'],iflow:['if/qwen3-coder-plus','if/kimi-k2','if/kimi-k2-thinking','if/glm-4.7','if/deepseek-r1','if/deepseek-v3.2','if/deepseek-v3','if/qwen3-max','if/qwen3-235b','if/iflow-rome-30ba3b'],qwen:['qw/qwen3-coder-plus','qw/qwen3-coder-flash','qw/vision-model','qw/coder-model'],kiro:['kr/claude-sonnet-4.5','kr/claude-haiku-4.5','kr/deepseek-3.2','kr/deepseek-3.1','kr/qwen3-coder-next'],ollama:['ollama/gemma4:e2b','ollama/gemma4:e4b','ollama/gemma4:26b','ollama/gemma4:31b','ollama/qwen3.5','ollama/kimi-k2.5','ollama/glm-5','ollama/glm-4.7-flash','ollama/minimax-m2.5','ollama/gpt-oss:120b'],'kimi-coding':['kmc/kimi-k2.5','kmc/kimi-k2.5-thinking','kmc/kimi-latest'],glm:['glm/glm-5.1','glm/glm-5','glm/glm-4.7'],'glm-cn':['glm/glm-5.1','glm/glm-5','glm/glm-4.7'],minimax:['minimax/MiniMax-M2.7','minimax/MiniMax-M2.5','minimax/MiniMax-M2.1'],kimi:['kimi/kimi-k2.5','kimi/kimi-k2.5-thinking','kimi/kimi-latest'],deepseek:['deepseek/deepseek-chat','deepseek/deepseek-reasoner'],xai:['xai/grok-4','xai/grok-4-fast-reasoning','xai/grok-code-fast-1'],mistral:['mistral/mistral-large-latest','mistral/codestral-latest'],groq:['groq/llama-3.3-70b-versatile','groq/openai/gpt-oss-120b'],cerebras:['cerebras/gpt-oss-120b'],alicode:['alicode/qwen3.5-plus','alicode/qwen3-coder-plus'],openai:['openai/gpt-4o','openai/gpt-4.1'],anthropic:['anthropic/claude-sonnet-4','anthropic/claude-haiku-3.5'],gemini:['gemini/gemini-2.5-flash','gemini/gemini-2.5-pro']};
+const sync=()=>{try{let db={};try{db=JSON.parse(fs.readFileSync(p,'utf8'));}catch{}if(!db.combos)db.combos=[];const removeSmartRoute=()=>{const next=db.combos.filter(x=>x.id!=='smart-route');if(next.length!==db.combos.length){db.combos=next;fs.writeFileSync(p,JSON.stringify(db,null,2));}};const a=(db.providerConnections||[]).filter(c=>c&&c.provider&&c.isActive!==false&&!c.disabled).map(c=>c.provider);if(!a.length){removeSmartRoute();return;}const PREF=['openai','anthropic','claude-code','codex','cursor','github','cline','kimi','minimax','deepseek','glm','alicode','xai','mistral','kilo','kiro','iflow','qwen','gemini-cli','ollama'];a.sort((x,y)=>(PREF.indexOf(x)===-1?99:PREF.indexOf(x))-(PREF.indexOf(y)===-1?99:PREF.indexOf(y)));const m=a.flatMap(provider=>PM[provider]||[]);if(!m.length){removeSmartRoute();return;}const c={id:'smart-route',name:'smart-route',alias:'smart-route',models:m};const i=db.combos.findIndex(x=>x.id==='smart-route');if(i>=0){if(JSON.stringify(db.combos[i].models)!==JSON.stringify(c.models)){db.combos[i]=c;fs.writeFileSync(p,JSON.stringify(db,null,2));}}else{db.combos.push(c);fs.writeFileSync(p,JSON.stringify(db,null,2));}}catch{}};sync();setInterval(sync,INTERVAL);`;
+    }
 
     // ─── Shared initializer (provider install) ───────────────────────────────
     function providerLines(arr, shell) {
@@ -2841,10 +2864,12 @@ I am **${botName}**. When asked my name, I answer: _"I'm ${botName}"_.`;
         if (shell === 'bat') {
           arr.push('npm install -g 9router');
           arr.push('start "9Router" cmd /k "9router -n -t -l -H 0.0.0.0 -p 20128 --skip-update"');
+          arr.push('start "9Router Smart Route Sync" cmd /k "node .\\.openclaw\\9router-smart-route-sync.js"');
           arr.push('timeout /t 5 /nobreak >nul');
         } else {
           arr.push('npm install -g 9router');
           arr.push('nohup 9router -n -t -l -H 0.0.0.0 -p 20128 --skip-update >/tmp/9router.log 2>&1 &');
+          arr.push('nohup node ./.openclaw/9router-smart-route-sync.js >/tmp/9router-sync.log 2>&1 &');
           arr.push('sleep 3');
         }
       } else if (isOllama) {
@@ -3015,13 +3040,14 @@ I am **${botName}**. When asked my name, I answer: _"I'm ${botName}"_.`;
     }
 
     function sharedNativeFileMap() {
-      const files = {
-        '.env': sharedNativeEnvContent(),
-        '.openclaw/openclaw.json': sharedNativeConfigContent(),
-        '.openclaw/exec-approvals.json': sharedNativeExecApprovalsContent(),
-        '.openclaw/auth-profiles.json': sharedNativeAuthProfilesContent(),
-        'TELEGRAM-POST-INSTALL.md': buildTelegramPostInstallChecklist(),
-      };
+      const files = {
+        '.env': sharedNativeEnvContent(),
+        '.openclaw/openclaw.json': sharedNativeConfigContent(),
+        '.openclaw/exec-approvals.json': sharedNativeExecApprovalsContent(),
+        '.openclaw/auth-profiles.json': sharedNativeAuthProfilesContent(),
+        'TELEGRAM-POST-INSTALL.md': buildTelegramPostInstallChecklist(),
+      };
+      if (is9Router) files['.openclaw/9router-smart-route-sync.js'] = native9RouterSyncScriptContent();
       const teamMd = isVi
         ? `# Doi Bot\n\n${multiBotAgentMetas.map((meta) => `## ${meta.name}\n- Vai tro: ${meta.desc}\n- Agent ID: \`${meta.agentId}\`\n- Telegram accountId: \`${meta.accountId}\`\n- Slash command: ${meta.slashCmd || '_(chua co)_'}\n- Tinh cach: ${meta.persona || '_(khong ghi ro)_'}`).join('\n\n')}\n\n## Quy uoc phoi hop\n- Tat ca bot trong doi biet ro vai tro cua nhau.\n- Neu user bao ban hoi mot bot khac, hay dung agent-to-agent noi bo thay vi doi Telegram chuyen tin cua bot.\n- Bot mo loi chi noi 1 cau ngan, sau do chuyen turn noi bo cho bot dich.\n- Bot dich phai tra loi cong khai bang chinh Telegram account cua minh trong cung chat/thread hien tai.\n- Neu can fallback, chi bot mo loi moi duoc phep tom tat thay.`
         : `# Bot Team\n\n${multiBotAgentMetas.map((meta) => `## ${meta.name}\n- Role: ${meta.desc}\n- Agent ID: \`${meta.agentId}\`\n- Telegram accountId: \`${meta.accountId}\`\n- Slash command: ${meta.slashCmd || '_(not set)_'}\n- Persona: ${meta.persona || '_(not specified)_'}`).join('\n\n')}\n\n## Coordination Rules\n- Every bot knows the full roster.\n- If the user asks you to consult another bot, use internal agent-to-agent handoff instead of waiting for Telegram bot-to-bot delivery.\n- The caller bot only sends one short opener, then hands off internally.\n- The target bot must publish the real answer with its own Telegram account in the same chat/thread.\n- If a fallback is needed, only the caller bot may summarize on behalf of the target.`;
@@ -3369,10 +3395,11 @@ ${selectedSkillNames.length ? selectedSkillNames.join('\n') : '- _(No skills ins
       const base = '.';
       const files = {};
       files[`${base}/.env`] = botEnvContent(botIndex);
-      files[`${base}/.openclaw/openclaw.json`] = botConfigContent(botIndex);
-      files[`${base}/.openclaw/exec-approvals.json`] = botExecApprovalsContent(botIndex);
-      files[`${base}/.openclaw/auth-profiles.json`] = botAuthProfilesContent(botIndex);
-      files[`${base}/.openclaw/agents/${agentId}.yaml`] = botAgentYamlContent(botIndex);
+      files[`${base}/.openclaw/openclaw.json`] = botConfigContent(botIndex);
+      files[`${base}/.openclaw/exec-approvals.json`] = botExecApprovalsContent(botIndex);
+      files[`${base}/.openclaw/auth-profiles.json`] = botAuthProfilesContent(botIndex);
+      if (is9Router) files[`${base}/.openclaw/9router-smart-route-sync.js`] = native9RouterSyncScriptContent();
+      files[`${base}/.openclaw/agents/${agentId}.yaml`] = botAgentYamlContent(botIndex);
       files[`${base}/.openclaw/agents/${agentId}/agent/auth-profiles.json`] = botAuthProfilesContent(botIndex);
       Object.entries(botWorkspaceFiles(botIndex)).forEach(([name, content]) => {
         files[`${base}/.openclaw/workspace/${name}`] = content;
@@ -3497,21 +3524,29 @@ ${selectedSkillNames.length ? selectedSkillNames.join('\n') : '- _(No skills ins
       providerLines(vps, 'sh');
       if (pluginCmd) vps.push(pluginCmd);
 
-      if (isMultiBot) {
-        vps.push('echo "--- Creating shared multi-agent runtime ---"');
-        appendShWriteCommands(vps, sharedNativeFileMap());
-        vps.push('echo "--- Starting shared gateway via PM2 ---"');
-        vps.push('pm2 start --name openclaw-multibot -- sh -c "openclaw gateway run"');
-        vps.push('pm2 save && pm2 startup');
+      if (isMultiBot) {
+        vps.push('echo "--- Creating shared multi-agent runtime ---"');
+        appendShWriteCommands(vps, sharedNativeFileMap());
+        vps.push('echo "--- Starting shared gateway via PM2 ---"');
+        if (is9Router) {
+          vps.push('pm2 start --name openclaw-multibot-9router -- sh -c "9router -n -t -l -H 0.0.0.0 -p 20128 --skip-update"');
+          vps.push('pm2 start --name openclaw-multibot-9router-sync -- sh -c "node ./.openclaw/9router-smart-route-sync.js"');
+        }
+        vps.push('pm2 start --name openclaw-multibot -- sh -c "openclaw gateway run"');
+        vps.push('pm2 save && pm2 startup');
         vps.push(`echo ""`);
         vps.push(`echo "=== ✅ Shared multi-bot gateway running via PM2 ==="`);
         vps.push(`echo "Commands:"`);
         vps.push(`echo "  pm2 status            # Status gateway"`);
         vps.push(`echo "  pm2 logs openclaw-multibot"`);
-      } else {
-        appendShWriteCommands(vps, botFiles(0));
-        vps.push('pm2 start --name openclaw -- sh -c "openclaw gateway run"');
-        vps.push('pm2 save && pm2 startup');
+      } else {
+        appendShWriteCommands(vps, botFiles(0));
+        if (is9Router) {
+          vps.push('pm2 start --name openclaw-9router -- sh -c "9router -n -t -l -H 0.0.0.0 -p 20128 --skip-update"');
+          vps.push('pm2 start --name openclaw-9router-sync -- sh -c "node ./.openclaw/9router-smart-route-sync.js"');
+        }
+        vps.push('pm2 start --name openclaw -- sh -c "openclaw gateway run"');
+        vps.push('pm2 save && pm2 startup');
         vps.push('echo "Bot dang chay! Xem log: pm2 logs openclaw"');
       }
       scriptContent = vps.filter(Boolean).join('\n');
@@ -3683,9 +3718,11 @@ Write-Host "  🎉 ${isVi ? 'Setup hoàn tất!' : 'Setup complete!'}" -Foregrou
     if (is9Router) {
       ps += `Write-Host "  ${isVi ? 'Mở http://localhost:30128/dashboard để login OAuth' : 'Open http://localhost:30128/dashboard to login OAuth'}" -ForegroundColor White\n`;
     }
-    if (state.channel === 'zalo-personal') {
-      ps += `Write-Host "  ${isVi ? 'Chạy: docker exec -it openclaw-bot openclaw onboard (quét QR)' : 'Run: docker exec -it openclaw-bot openclaw onboard (scan QR)'}" -ForegroundColor White\n`;
-    }
+    if (state.channel === 'zalo-personal') {
+      ps += `Write-Host "  ${isVi ? 'Chạy: docker compose exec -it ai-bot openclaw channels login --channel zalouser --verbose' : 'Run: docker compose exec -it ai-bot openclaw channels login --channel zalouser --verbose'}" -ForegroundColor White\n`;
+      ps += `Write-Host "  ${isVi ? 'QR sẽ nằm tại /tmp/openclaw/openclaw-zalouser-qr-default.png' : 'QR will be written to /tmp/openclaw/openclaw-zalouser-qr-default.png'}" -ForegroundColor DarkGray\n`;
+      ps += `Write-Host "  ${isVi ? 'Copy QR ra ngoài: docker compose cp ai-bot:/tmp/openclaw/openclaw-zalouser-qr-default.png ./zalo-login-qr.png' : 'Copy the QR out: docker compose cp ai-bot:/tmp/openclaw/openclaw-zalouser-qr-default.png ./zalo-login-qr.png'}" -ForegroundColor DarkGray\n`;
+    }
 
     ps += `Write-Host ""
 } catch {
@@ -3858,72 +3895,40 @@ echo ""
   }
 
 
-  // ========== Zalo Personal Onboard Guide (post-Docker-setup) ==========
-
-  function generateZaloOnboardGuide() {
-    const lang = document.getElementById('cfg-language')?.value || 'vi';
-    setOutput('out-zalo-onboard-cmd', `docker exec -it openclaw-bot openclaw onboard`);
-
-    if (lang === 'vi') {
-      setOutput('out-zalo-onboard-guide', `┌─────────────────────────────────────────────────────┐
-│  OpenClaw sẽ hỏi lần lượt — chọn như sau:          │
-├──────────────────────┬──────────────────────────────┤
-│  Câu hỏi             │  Chọn                        │
-├──────────────────────┼──────────────────────────────┤
-│  Security warning    │  ✅ Yes                       │
-│  Setup mode          │  ✅ QuickStart                │
-│  Config handling     │  ✅ Use existing values       │
-│  Model/auth provider │  Chọn tuỳ ý (VD: Google)     │
-│  API key             │  Nhập key (hoặc Enter nếu    │
-│                      │  đã có trong .env)            │
-│  Select channel      │  ✅ Zalo (Personal Account)   │
-│  Login via QR?       │  ✅ Yes                       │
-│  ─── QR LOGIN ───    │  📱 Mở file QR → Quét Zalo   │
-│  Did you scan QR?    │  ✅ Yes                       │
-│  DM policy           │  ✅ Pairing (recommended)     │
-│  Configure groups?   │  ✅ No                        │
-│  Configure skills?   │  ✅ No                        │
-│  Enable hooks?       │  ✅ Enter (chọn mặc định)     │
-│  Hatch your bot?     │  ✅ Do this later             │
-├──────────────────────┴──────────────────────────────┤
-│  💡 Bước QR Login:                                  │
-│  Khi bước QR hiện ra, test_openclaw sẽ lưu file QR │
-│  vào thư mục /tmp trong container.                  │
-│  Dùng lệnh: docker cp openclaw-bot:/tmp/qr.png .   │
-│  Mở file ảnh → quét bằng Zalo điện thoại →          │
-│  xác nhận kết nối → quay lại chọn Yes.              │
-└─────────────────────────────────────────────────────┘`);
-    } else {
-      setOutput('out-zalo-onboard-guide', `┌─────────────────────────────────────────────────────┐
-│  OpenClaw will prompt you — choose as follows:     │
-├──────────────────────┬──────────────────────────────┤
-│  Prompt              │  Choice                      │
-├──────────────────────┼──────────────────────────────┤
-│  Security warning    │  ✅ Yes                       │
-│  Setup mode          │  ✅ QuickStart                │
-│  Config handling     │  ✅ Use existing values       │
-│  Model/auth provider │  Choose any (e.g. Google)    │
-│  API key             │  Enter key (or press Enter   │
-│                      │  if already in .env)          │
-│  Select channel      │  ✅ Zalo (Personal Account)   │
-│  Login via QR?       │  ✅ Yes                       │
-│  ─── QR LOGIN ───    │  📱 Open QR file → Scan Zalo │
-│  Did you scan QR?    │  ✅ Yes                       │
-│  DM policy           │  ✅ Pairing (recommended)     │
-│  Configure groups?   │  ✅ No                        │
-│  Configure skills?   │  ✅ No                        │
-│  Enable hooks?       │  ✅ Enter (default)           │
-│  Hatch your bot?     │  ✅ Do this later             │
-├──────────────────────┴──────────────────────────────┤
-│  💡 QR Login Step:                                  │
-│  When prompted, OpenClaw saves the QR code to       │
-│  /tmp inside the container.                         │
-│  Run: docker cp openclaw-bot:/tmp/qr.png .          │
-│  Open image → scan with Zalo mobile app →           │
-│  confirm login → go back & select Yes.              │
-└─────────────────────────────────────────────────────┘`);
-    }
-  }
+  // ========== 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 --verbose`);
+
+    if (lang === 'vi') {
+      setOutput('out-zalo-onboard-guide', `┌─────────────────────────────────────────────────────┐
+│  Chạy lệnh bên trái để OpenClaw tạo QR đăng nhập.   │
+├─────────────────────────────────────────────────────┤
+│  1. Đảm bảo container/gateway đã chạy xong.         │
+│  2. Chạy lệnh login để tạo QR cho zalouser.         │
+│  3. OpenClaw sẽ in ra đường dẫn file QR trong /tmp. │
+│  4. Copy file QR ra ngoài nếu cần:                  │
+│     docker compose cp ai-bot:/tmp/openclaw/         │
+│       openclaw-zalouser-qr-default.png .            │
+│  5. Mở ảnh QR → quét bằng app Zalo → xác nhận.      │
+│  6. Sau khi login xong, restart bot nếu cần.        │
+└─────────────────────────────────────────────────────┘`);
+    } else {
+      setOutput('out-zalo-onboard-guide', `┌─────────────────────────────────────────────────────┐
+│  Run the command on the left to generate a Zalo QR. │
+├─────────────────────────────────────────────────────┤
+│  1. Make sure the container/gateway is already up.  │
+│  2. Run the login command for zalouser.             │
+│  3. OpenClaw prints the QR image path under /tmp.   │
+│  4. Copy the QR out if needed:                      │
+│     docker compose cp ai-bot:/tmp/openclaw/         │
+│       openclaw-zalouser-qr-default.png .            │
+│  5. Open the image → scan with Zalo mobile app.     │
+│  6. Restart the bot afterwards if needed.           │
+└─────────────────────────────────────────────────────┘`);
+    }
+  }
 
   function setOutput(id, text) {
     const el = document.getElementById(id);

package/tests/smoke-cli-logic.mjs

@@ -56,6 +56,18 @@ checks.push(() => expectMatch(
   'Native 9Router flow must auto-install 9Router'
 ));
 
+checks.push(() => expectMatch(
+  cli,
+  /async function writeNative9RouterSyncScript\(projectDir\) \{[\s\S]*9router-smart-route-sync\.js[\s\S]*providerConnections[\s\S]*smart-route/s,
+  'Native 9Router flow must write a smart-route sync script based on ~/.9router/db.json'
+));
+
+checks.push(() => expectMatch(
+  cli,
+  /Removed smart-route \(no active providers\)[\s\S]*if \(!a\.length\) \{[\s\S]*removeSmartRoute\(\)[\s\S]*if \(!m\.length\) \{[\s\S]*removeSmartRoute\(\)/s,
+  '9Router sync logic in CLI must remove stale smart-route combos when providers are disabled'
+));
+
 checks.push(() => expectMatch(
   cli,
   /function ensureUserWritableGlobalNpm\(\{ isVi, osChoice \}\) \{[\s\S]*process\.env\.npm_config_prefix = npmInfo\.prefixDir[\s\S]*npm config set prefix "\$\{npmInfo\.prefixDir\.replace/s,
@@ -80,6 +92,12 @@ checks.push(() => expectMatch(
   'Native PM2 flow must expose dashboard access info and the tokenized dashboard command'
 ));
 
+checks.push(() => expectMatch(
+  cli,
+  /function printZaloPersonalLoginInfo\(\{ isVi, deployMode, projectDir \}\) \{[\s\S]*docker compose exec -it ai-bot openclaw channels login --channel zalouser --verbose[\s\S]*const copyCmd = deployMode === 'native'[\s\S]*docker compose cp ai-bot:\$\{qrPath\} \.\/zalo-login-qr\.png/s,
+  'CLI must print the dedicated Docker/native Zalo Personal login commands and QR copy path instead of onboarding'
+));
+
 checks.push(() => expectMatch(
   cli,
   /baseUrl: deployMode === 'native' \? 'http:\/\/localhost:20128\/v1' : 'http:\/\/9router:20128\/v1'/,
@@ -88,10 +106,22 @@ checks.push(() => expectMatch(
 
 checks.push(() => expectMatch(
   cli,
-  /function startNative9RouterPm2\(\{ isVi, projectDir, appName \}\) \{[\s\S]*9router -n -t -l -H 0\.0\.0\.0 -p 20128 --skip-update[\s\S]*pm2 save/s,
+  /channelKey === 'zalo-personal'\) \{\s*botConfig\.channels\['zalouser'\] = \{\s*enabled: true,\s*dmPolicy: 'pairing',\s*autoReply: true/s,
+  'CLI must configure Zalo Personal under channels.zalouser'
+));
+
+checks.push(() => expectMatch(
+  cli,
+  /function startNative9RouterPm2\(\{ isVi, projectDir, appName, syncScriptPath \}\) \{[\s\S]*9router -n -t -l -H 0\.0\.0\.0 -p 20128 --skip-update[\s\S]*9router-sync[\s\S]*runPm2Save\(\{ projectDir, isVi \}\)/s,
   'VPS native 9Router flow must start a standalone 9Router dashboard on port 20128 via PM2'
 ));
 
+checks.push(() => expectMatch(
+  cli,
+  /function runPm2Save\(\{ projectDir, isVi \}\) \{[\s\S]*execSync\('pm2 save'[\s\S]*PM2 save did not complete/s,
+  'Native PM2 save should be handled as a separate recoverable step'
+));
+
 checks.push(() => expectMatch(
   cli,
   /const child = spawn\('openclaw', \['gateway', 'run'\], \{/,
@@ -153,6 +183,24 @@ checks.push(() => expectMatch(
   'Native script generation must install and start a standalone 9Router dashboard on port 20128'
 ));
 
+checks.push(() => expectMatch(
+  setup,
+  /function native9RouterSyncScriptContent\(\) \{[\s\S]*providerConnections[\s\S]*smart-route/s,
+  'Native script generation must embed a 9Router smart-route sync script'
+));
+
+checks.push(() => expectMatch(
+  setup,
+  /Removed smart-route \(no active providers\)[\s\S]*if \(!a\.length\) \{[\s\S]*removeSmartRoute\(\)[\s\S]*if \(!m\.length\) \{[\s\S]*removeSmartRoute\(\)/s,
+  '9Router sync logic in setup.js must remove stale smart-route combos when providers are disabled'
+));
+
+checks.push(() => expectMatch(
+  setup,
+  /\.openclaw\/9router-smart-route-sync\.js[\s\S]*pm2 start --name openclaw-9router-sync/s,
+  'VPS native script generation must write and run the 9Router smart-route sync loop'
+));
+
 checks.push(() => expectMatch(
   cli,
   /readdirSync\(dir\)\.find\(n=>\/\^gateway-cli-.*\\\\\.js\$\/\.test\(n\)\)[\s\S]*skipping timeout patch/,
@@ -195,6 +243,12 @@ checks.push(() => expectMatch(
   'Auto-steps summary must mention OpenClaw CLI installation'
 ));
 
+checks.push(() => expectMatch(
+  setup,
+  /docker compose exec -it ai-bot openclaw channels login --channel zalouser --verbose[\s\S]*docker compose cp ai-bot:\/tmp\/openclaw\/openclaw-zalouser-qr-default\.png \.\/zalo-login-qr\.png/s,
+  'Wizard copy must use the dedicated zalouser login command and Docker QR copy path'
+));
+
 for (const check of checks) {
   check();
 }

package/tmp/live-enable-zalouser.cjs

@@ -0,0 +1,20 @@
+const fs = require('fs');
+
+const configPath = process.argv[2];
+
+if (!configPath) {
+  console.error('Usage: node live-enable-zalouser.cjs <configPath>');
+  process.exit(1);
+}
+
+const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+config.channels = config.channels || {};
+config.channels.zalouser = {
+  ...(config.channels.zalouser || {}),
+  enabled: true,
+  dmPolicy: 'pairing',
+  autoReply: true
+};
+
+fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+console.log(`Enabled channels.zalouser in ${configPath}`);

package/tmp/live-enable-zalouser.js

@@ -0,0 +1,20 @@
+const fs = require('fs');
+
+const configPath = process.argv[2];
+
+if (!configPath) {
+  console.error('Usage: node live-enable-zalouser.js <configPath>');
+  process.exit(1);
+}
+
+const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+config.channels = config.channels || {};
+config.channels.zalouser = {
+  ...(config.channels.zalouser || {}),
+  enabled: true,
+  dmPolicy: 'pairing',
+  autoReply: true
+};
+
+fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+console.log(`Enabled channels.zalouser in ${configPath}`);

package/tmp/live-patch-9router.cjs

@@ -0,0 +1,40 @@
+const fs = require('fs');
+
+const dbPath = process.argv[2];
+
+if (!dbPath) {
+  console.error('Usage: node live-patch-9router.cjs <dbPath>');
+  process.exit(1);
+}
+
+const models = [
+  'cx/gpt-5.4',
+  'cx/gpt-5.3-codex',
+  'cx/gpt-5.3-codex-high',
+  'cx/gpt-5.2-codex',
+  'cx/gpt-5.2',
+  'cx/gpt-5.1-codex-max',
+  'cx/gpt-5.1-codex',
+  'cx/gpt-5.1',
+  'cx/gpt-5-codex'
+];
+
+const db = JSON.parse(fs.readFileSync(dbPath, 'utf8'));
+db.combos = db.combos || [];
+
+const combo = {
+  id: 'smart-route',
+  name: 'smart-route',
+  alias: 'smart-route',
+  models
+};
+
+const index = db.combos.findIndex((entry) => entry && entry.id === 'smart-route');
+if (index >= 0) {
+  db.combos[index] = combo;
+} else {
+  db.combos.push(combo);
+}
+
+fs.writeFileSync(dbPath, JSON.stringify(db, null, 2));
+console.log(`Patched smart-route in ${dbPath}`);

package/tmp/live-patch-9router.js

@@ -0,0 +1,40 @@
+const fs = require('fs');
+
+const dbPath = process.argv[2];
+
+if (!dbPath) {
+  console.error('Usage: node live-patch-9router.js <dbPath>');
+  process.exit(1);
+}
+
+const models = [
+  'cx/gpt-5.4',
+  'cx/gpt-5.3-codex',
+  'cx/gpt-5.3-codex-high',
+  'cx/gpt-5.2-codex',
+  'cx/gpt-5.2',
+  'cx/gpt-5.1-codex-max',
+  'cx/gpt-5.1-codex',
+  'cx/gpt-5.1',
+  'cx/gpt-5-codex'
+];
+
+const db = JSON.parse(fs.readFileSync(dbPath, 'utf8'));
+db.combos = db.combos || [];
+
+const combo = {
+  id: 'smart-route',
+  name: 'smart-route',
+  alias: 'smart-route',
+  models
+};
+
+const index = db.combos.findIndex((entry) => entry && entry.id === 'smart-route');
+if (index >= 0) {
+  db.combos[index] = combo;
+} else {
+  db.combos.push(combo);
+}
+
+fs.writeFileSync(dbPath, JSON.stringify(db, null, 2));
+console.log(`Patched smart-route in ${dbPath}`);