create-openclaw-bot 5.0.4 → 5.0.6

package/CHANGELOG.md

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

package/CHANGELOG.vi.md

@@ -1,6 +1,6 @@
 # Changelog (Tiếng Việt)
 
-## [5.0.1] — 2026-04-04
+## [5.0.5] — 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.1-0EA5E9?style=for-the-badge" alt="Version 5.0.1" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.0.5-0EA5E9?style=for-the-badge" alt="Version 5.0.5" /></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.1
+## 🆕 What's new in v5.0.5
 
 - 💻 **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.1 for me.
+   Read SETUP.md and set up OpenClaw v5.0.5 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.1-0EA5E9?style=for-the-badge" alt="Version 5.0.1" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.0.5-0EA5E9?style=for-the-badge" alt="Version 5.0.5" /></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.1
+## 🆕 Có gì mới trong v5.0.5
 
 - 💻 **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.1 for me.
+   Read SETUP.md and set up OpenClaw v5.0.5 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

@@ -32,6 +32,144 @@ function installRelayPluginForProject(projectDir, isVi) {
   return false;
 }
 
+function isOpenClawInstalled() {
+  try {
+    execSync('openclaw --version', { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function isPm2Installed() {
+  try {
+    execSync('pm2 --version', { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function getUserNpmPrefixInfo() {
+  if (process.platform === 'win32') {
+    return null;
+  }
+
+  const prefixDir = path.join(os.homedir(), '.local');
+  return {
+    prefixDir,
+    binDir: path.join(prefixDir, 'bin')
+  };
+}
+
+function ensureBinDirOnPath(binDir) {
+  const delimiter = path.delimiter;
+  const pathParts = String(process.env.PATH || '').split(delimiter).filter(Boolean);
+  if (!pathParts.includes(binDir)) {
+    process.env.PATH = [binDir, ...pathParts].join(delimiter);
+  }
+}
+
+function appendLineIfMissing(filePath, line) {
+  let content = '';
+  if (fs.existsSync(filePath)) {
+    content = fs.readFileSync(filePath, 'utf8');
+  }
+
+  if (!content.includes(line)) {
+    const prefix = content && !content.endsWith('\n') ? '\n' : '';
+    fs.appendFileSync(filePath, `${prefix}${line}\n`);
+  }
+}
+
+function ensureUserWritableGlobalNpm({ isVi, osChoice }) {
+  if (process.platform === 'win32') {
+    return true;
+  }
+
+  const npmInfo = getUserNpmPrefixInfo();
+  if (!npmInfo) {
+    return true;
+  }
+
+  try {
+    fs.ensureDirSync(npmInfo.binDir);
+    process.env.npm_config_prefix = npmInfo.prefixDir;
+    ensureBinDirOnPath(npmInfo.binDir);
+
+    execSync(`npm config set prefix "${npmInfo.prefixDir.replace(/"/g, '\\"')}"`, {
+      stdio: 'ignore',
+      shell: true,
+      env: process.env
+    });
+
+    appendLineIfMissing(path.join(os.homedir(), '.profile'), 'export PATH="$HOME/.local/bin:$PATH"');
+    appendLineIfMissing(
+      path.join(os.homedir(), osChoice === 'macos' ? '.zshrc' : '.bashrc'),
+      'export PATH="$HOME/.local/bin:$PATH"'
+    );
+    return true;
+  } catch {
+    console.log(chalk.yellow(isVi
+      ? '⚠️  Không thể cấu hình npm global prefix trong ~/.local. Tiếp tục thử cài đặt trực tiếp.'
+      : '⚠️  Could not configure npm global prefix in ~/.local. Falling back to direct install.'));
+    return false;
+  }
+}
+
+const userNpmInfo = getUserNpmPrefixInfo();
+if (userNpmInfo) {
+  ensureBinDirOnPath(userNpmInfo.binDir);
+}
+
+function installGlobalPackage(pkg, { isVi, osChoice, displayName }) {
+  const installCommands = [];
+
+  if (osChoice === 'windows') {
+    installCommands.push(`npm install -g ${pkg}`);
+  } else {
+    ensureUserWritableGlobalNpm({ isVi, osChoice });
+    installCommands.push(`npm install -g ${pkg}`);
+    const npmInfo = getUserNpmPrefixInfo();
+    if (npmInfo) {
+      installCommands.push(`npm install -g --prefix "${npmInfo.prefixDir.replace(/"/g, '\\"')}" ${pkg}`);
+    }
+  }
+
+  for (const cmd of installCommands) {
+    try {
+      execSync(cmd, { stdio: 'inherit', shell: true, env: process.env });
+      return true;
+    } catch {
+      // try next candidate
+    }
+  }
+
+  console.log(chalk.yellow(isVi
+    ? `⚠️  Không thể tự cài ${displayName}. Chạy thủ công: ${osChoice === 'windows' ? `npm install -g ${pkg}` : `npm config set prefix ~/.local && npm install -g ${pkg}`}`
+    : `⚠️  Could not auto-install ${displayName}. Run manually: ${osChoice === 'windows' ? `npm install -g ${pkg}` : `npm config set prefix ~/.local && npm install -g ${pkg}`}`));
+  return false;
+}
+
+async function syncLocalConfigToHome(projectDir, isVi) {
+  const homedir = os.homedir();
+  const globalClawDir = path.join(homedir, '.openclaw');
+  const localClawDir = path.join(projectDir, '.openclaw');
+  try {
+    await fs.ensureDir(globalClawDir);
+    await fs.copy(localClawDir, globalClawDir, { overwrite: true });
+    console.log(chalk.green(`\n✅ ${isVi
+      ? 'Config đã được sync vào ~/.openclaw/ — openclaw sẵn sàng!'
+      : 'Config synced to ~/.openclaw/ — openclaw is ready!'}`));
+    return true;
+  } catch {
+    console.log(chalk.yellow(`\n⚠️  ${isVi
+      ? `Không thể tự sync config. Chạy thủ công:\n   cp -rn ${localClawDir}/. ${globalClawDir}/`
+      : `Could not auto-sync config. Run manually:\n   cp -rn ${localClawDir}/. ${globalClawDir}/`}`));
+    return false;
+  }
+}
+
 function buildTelegramPostInstallChecklist({ isVi, bots, groupId }) {
   const botList = bots.map((bot, idx) => `- **${bot?.name || `Bot ${idx + 1}`}** — token: ${String(bot?.token || '').slice(0, 10)}...`).join('\n');
 
@@ -1134,18 +1272,18 @@ ${hasBrowserDesktop ? `    extra_hosts:
     );
     // Generate ecosystem.config.js for PM2 native multi-bot
     if (deployMode === 'native') {
-      const pm2Apps = agentMetas.map((meta) => [
-        '  {',
-        `    name: '${meta.agentId}',`,
-        `    script: 'openclaw',`,
-        `    args: '--agent ${meta.agentId}',`,
-        `    cwd: '${projectDir.replace(/\\/g, '/')}',`,
-        `    interpreter: 'none',`,
-        `    autorestart: true,`,
-        `    watch: false,`,
-        `    env: { NODE_ENV: 'production' }`,
-        '  }',
-      ].join('\n')).join(',\n');
+      const pm2Apps = [
+        '    {',
+        `      name: '${botName || 'openclaw-multibot'}',`,
+        `      script: 'openclaw',`,
+        `      args: 'gateway run',`,
+        `      cwd: '${projectDir.replace(/\\/g, '/')}',`,
+        `      interpreter: 'none',`,
+        `      autorestart: true,`,
+        `      watch: false,`,
+        `      env: { NODE_ENV: 'production' }`,
+        '    }',
+      ].join('\n');
       const ecosystemContent = [
         '// PM2 ecosystem — run: pm2 start ecosystem.config.js',
         'module.exports = {',
@@ -1157,7 +1295,6 @@ ${hasBrowserDesktop ? `    extra_hosts:
       ].join('\n');
       await fs.writeFile(path.join(projectDir, 'ecosystem.config.js'), ecosystemContent);
     }
-    installRelayPluginForProject(projectDir, isVi);
     if (Object.keys(authProfilesJson).length > 0) {
       await fs.writeJson(path.join(rootClawDir, 'auth-profiles.json'), authProfilesJson, { spaces: 2 });
     }
@@ -1656,7 +1793,7 @@ fi
         : `Could not auto-sync config. Run manually:\n   cp -rn ${localClawDir}/. ${globalClawDir}/`}`));
     }
 
-    console.log(chalk.cyan(`\n👉 ${isVi ? 'Đã tạo xong file cấu hình native.' : 'Native config files are ready.'}`));
+    console.log(chalk.cyan(`\n👉 ${isVi ? 'Đã tạo xong file cấu hình Docker.' : 'Docker config files are ready.'}`));
     console.log(chalk.gray(isVi
       ? `   Cấu trúc config: ${isMultiBot && channelKey === 'telegram' ? '.openclaw/ dùng chung + agents/workspace-*' : (isMultiBot ? 'bot1/, bot2/, ...' : '.openclaw/')}`
       : `   Config layout: ${isMultiBot && channelKey === 'telegram' ? 'shared .openclaw/ with agents/workspace-*' : (isMultiBot ? 'bot1/, bot2/, ...' : '.openclaw/')}`));
@@ -1675,6 +1812,64 @@ fi
     if (isMultiBot && channelKey === 'telegram') {
       console.log(chalk.yellow(`\n${isVi ? '📋 Xem hướng dẫn sau cài:' : '📋 Read post-install guide:'} ${path.join(projectDir, 'TELEGRAM-POST-INSTALL.md')}`));
     }
+  } else {
+    if (!isOpenClawInstalled()) {
+      console.log(chalk.cyan(isVi
+        ? '\n📦 Dang cai openclaw binary (npm install -g openclaw)...'
+        : '\n📦 Installing openclaw binary (npm install -g openclaw)...'));
+      if (!installGlobalPackage('openclaw@latest', { isVi, osChoice, displayName: 'openclaw' })) {
+        process.exit(1);
+      }
+      console.log(chalk.green(isVi ? '✅ openclaw da cai xong!' : '✅ openclaw installed!'));
+    }
+
+    await syncLocalConfigToHome(projectDir, isVi);
+
+    if (isMultiBot && channelKey === 'telegram') {
+      installRelayPluginForProject(projectDir, isVi);
+    }
+
+    if (osChoice === 'vps') {
+      if (!isPm2Installed()) {
+        console.log(chalk.cyan(isVi ? '\n📦 Dang cai PM2...' : '\n📦 Installing PM2...'));
+        if (!installGlobalPackage('pm2@latest', { isVi, osChoice, displayName: 'PM2' })) {
+          process.exit(1);
+        }
+      }
+
+      if (isMultiBot && channelKey === 'telegram') {
+        execSync('pm2 start ecosystem.config.js && pm2 save', {
+          cwd: projectDir,
+          stdio: 'inherit',
+          shell: true
+        });
+        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'}`));
+      } else {
+        const appName = botName || 'openclaw';
+        execSync(`pm2 start "openclaw gateway run" --name "${appName}" --cwd "${projectDir.replace(/\\/g, '/')}" && pm2 save`, {
+          cwd: projectDir,
+          stdio: 'inherit',
+          shell: true
+        });
+        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}`));
+      }
+    } else {
+      console.log(chalk.yellow(`\n${isVi ? 'Khoi dong native bot (foreground)...' : 'Starting native bot (foreground)...'}`));
+      const child = spawn('openclaw', ['gateway', 'run'], {
+        cwd: projectDir,
+        stdio: 'inherit',
+        shell: process.platform === 'win32'
+      });
+      child.on('close', (code) => process.exit(code ?? 0));
+      return;
+    }
+
+    console.log(chalk.cyan(`\n👉 ${isVi ? 'Native runtime da duoc cai san va khoi dong.' : 'Native runtime is installed and started.'}`));
+    if (isMultiBot && channelKey === 'telegram') {
+      console.log(chalk.yellow(`\n📋 ${isVi ? 'Xem huong dan sau cai:' : 'Read post-install guide:'} ${path.join(projectDir, 'TELEGRAM-POST-INSTALL.md')}`));
+    }
   }
 }
 
@@ -1682,4 +1877,3 @@ main().catch(err => {
   console.error(chalk.red('Error:'), err);
   process.exit(1);
 });
-

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.1+ natively supports deployment script generation for Windows, Linux, VPS, and Hosting environments.
+OpenClaw v5.0.5+ 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.1+ tự động sinh sẵn các script cài đặt dành riêng cho Windows, Linux, VPS và Hosting.
+OpenClaw v5.0.5+ tự động sinh sẵn các script cài đặt dành riêng cho Windows, Linux, VPS và Hosting.
 
 ---
 

package/index.html

@@ -482,7 +482,7 @@
             <span style="font-size: 28px;">💻</span>
             <div>
               <h3 class="output-section__title" style="margin: 0;" data-vi="Download Script Cài đặt" data-en="Download Setup Script">Download Script Cài đặt</h3>
-              <p style="font-size: 13px; color: var(--text-muted); margin: 4px 0 0;" id="native-instructions" data-vi="Tải file → chạy để cài bot trực tiếp trên máy (tự động cài 9Router/Ollama nếu đã chọn)" data-en="Download → run to install bot directly on machine (auto-installs 9Router/Ollama if selected)">Tải file → chạy để cài bot trực tiếp trên máy (tự động cài 9Router/Ollama nếu đã chọn)</p>
+              <p style="font-size: 13px; color: var(--text-muted); margin: 4px 0 0;" id="native-instructions" data-vi="Tải file → chạy để cài OpenClaw trực tiếp trên máy (tự động cài 9Router/Ollama nếu đã chọn)" data-en="Download → run to install OpenClaw directly on your machine (auto-installs 9Router/Ollama if selected)">Tải file → chạy để cài OpenClaw trực tiếp trên máy (tự động cài 9Router/Ollama nếu đã chọn)</p>
             </div>
           </div>
           <div style="display: flex; justify-content: center; margin: 20px 0 8px;">

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "create-openclaw-bot",
-  "version": "5.0.4",
+  "version": "5.0.6",
   "description": "Interactive CLI installer for OpenClaw Bot",
   "main": "cli.js",
   "bin": {
     "create-openclaw-bot": "./cli.js"
   },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
+    "test": "node tests/smoke-cli-logic.mjs",
     "bump": "node bump-version.mjs"
   },
   "keywords": [

package/setup.js

@@ -728,8 +728,8 @@
       icon: '🐧',
       titleVi: 'Ubuntu / VPS — Khuyên dùng Native (Không Docker)',
       titleEn: 'Ubuntu / VPS — Recommended: Native (No Docker)',
-      descVi: 'Chạy thẳng trên máy, tiết kiệm RAM, khởi động nhanh. Script tự cài Node.js 20 LTS, PM2, 9Router/Ollama và giữ bot chạy liên tục sau reboot.',
-      descEn: 'Run directly on machine — lower RAM, faster startup. Script auto-installs Node.js 20 LTS, PM2, 9Router/Ollama and keeps bot running across reboots.',
+      descVi: 'Chạy thẳng trên máy, tiết kiệm RAM, khởi động nhanh. Script tự cài Node.js 20 LTS, OpenClaw CLI, PM2, 9Router/Ollama và giữ bot chạy liên tục sau reboot.',
+      descEn: 'Run directly on machine — lower RAM, faster startup. Script auto-installs Node.js 20 LTS, OpenClaw CLI, PM2, 9Router/Ollama and keeps bot running across reboots.',
       deploy: 'native',
       badgeVi: '💻 Native + PM2',
       badgeEn: '💻 Native + PM2',
@@ -739,8 +739,8 @@
       icon: '🖥️',
       titleVi: 'Linux Desktop — Khuyên dùng Native',
       titleEn: 'Linux Desktop — Recommended: Native',
-      descVi: 'Không cần Docker. Script tự cài Node.js 20 LTS nếu chưa có, rồi cài 9Router hoặc Ollama theo lựa chọn provider của bạn.',
-      descEn: 'No Docker needed. Script auto-installs Node.js 20 LTS if missing, then installs 9Router or Ollama based on your provider choice.',
+      descVi: 'Không cần Docker. Script tự cài Node.js 20 LTS nếu chưa có, cài OpenClaw CLI, rồi cài 9Router hoặc Ollama theo provider bạn chọn và khởi động bot ngay.',
+      descEn: 'No Docker needed. Script auto-installs Node.js 20 LTS if missing, installs OpenClaw CLI, then installs 9Router or Ollama based on your provider choice and starts the bot immediately.',
       deploy: 'native',
       badgeVi: '💻 Native',
       badgeEn: '💻 Native',
@@ -3452,12 +3452,17 @@ ${selectedSkillNames.length ? selectedSkillNames.join('\n') : '- _(No skills ins
     } else if (state.nativeOs === 'linux') {
       const isDocker = state.deployMode === 'docker';
       scriptName = isDocker ? 'setup-openclaw-docker-macos.sh' : 'setup-openclaw-macos.sh';
-      const sh = [
-        '#!/usr/bin/env bash', 'set -e',
-        `echo "=== OpenClaw Setup — macOS${isDocker ? ' Docker' : ' Native'} ==="`,
-        'command -v node > /dev/null 2>&1 || { echo "ERROR: Node.js chua cai! https://nodejs.org"; exit 1; }',
-        'npm install -g openclaw@latest',
-      ];
+      const sh = [
+        '#!/usr/bin/env bash', 'set -e',
+        `echo "=== OpenClaw Setup — macOS${isDocker ? ' Docker' : ' Native'} ==="`,
+        'command -v node > /dev/null 2>&1 || { echo "ERROR: Node.js chua cai! https://nodejs.org"; exit 1; }',
+        'mkdir -p "$HOME/.local/bin"',
+        'npm config set prefix "$HOME/.local"',
+        'export PATH="$HOME/.local/bin:$PATH"',
+        'grep -Fqx \'export PATH="$HOME/.local/bin:$PATH"\' "$HOME/.zshrc" 2>/dev/null || echo \'export PATH="$HOME/.local/bin:$PATH"\' >> "$HOME/.zshrc"',
+        'grep -Fqx \'export PATH="$HOME/.local/bin:$PATH"\' "$HOME/.profile" 2>/dev/null || echo \'export PATH="$HOME/.local/bin:$PATH"\' >> "$HOME/.profile"',
+        'npm install -g openclaw@latest',
+      ];
       providerLines(sh, 'sh');
       if (pluginCmd) sh.push(pluginCmd);
 
@@ -3474,16 +3479,21 @@ ${selectedSkillNames.length ? selectedSkillNames.join('\n') : '- _(No skills ins
     // ─── VPS/Ubuntu PM2 .SH ──────────────────────────────────────────────────
     } else if (state.nativeOs === 'vps') {
       scriptName = 'setup-openclaw-vps.sh';
-      const vps = [
-        '#!/usr/bin/env bash', 'set -e',
-        `echo "=== OpenClaw Setup — Ubuntu/VPS${isMultiBot ? ` Multi-Bot (${state.botCount} bots)` : ''} ==="`,
-        '# Auto-install Node.js 20 LTS if missing',
-        'if ! command -v node > /dev/null 2>&1; then',
-        '  curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -',
-        '  sudo apt-get install -y nodejs',
-        'fi',
-        'npm install -g openclaw@latest pm2',
-      ];
+      const vps = [
+        '#!/usr/bin/env bash', 'set -e',
+        `echo "=== OpenClaw Setup — Ubuntu/VPS${isMultiBot ? ` Multi-Bot (${state.botCount} bots)` : ''} ==="`,
+        '# Auto-install Node.js 20 LTS if missing',
+        'if ! command -v node > /dev/null 2>&1; then',
+        '  curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -',
+        '  sudo apt-get install -y nodejs',
+        'fi',
+        'mkdir -p "$HOME/.local/bin"',
+        'npm config set prefix "$HOME/.local"',
+        'export PATH="$HOME/.local/bin:$PATH"',
+        'grep -Fqx \'export PATH="$HOME/.local/bin:$PATH"\' "$HOME/.bashrc" 2>/dev/null || echo \'export PATH="$HOME/.local/bin:$PATH"\' >> "$HOME/.bashrc"',
+        'grep -Fqx \'export PATH="$HOME/.local/bin:$PATH"\' "$HOME/.profile" 2>/dev/null || echo \'export PATH="$HOME/.local/bin:$PATH"\' >> "$HOME/.profile"',
+        'npm install -g openclaw@latest pm2@latest',
+      ];
       providerLines(vps, 'sh');
       if (pluginCmd) vps.push(pluginCmd);
 
@@ -3509,15 +3519,20 @@ ${selectedSkillNames.length ? selectedSkillNames.join('\n') : '- _(No skills ins
     // ─── Linux Desktop .SH ───────────────────────────────────────────────────
     } else if (state.nativeOs === 'linux-desktop') {
       scriptName = 'setup-openclaw-linux.sh';
-      const lnx = [
-        '#!/usr/bin/env bash', 'set -e',
-        `echo "=== OpenClaw Setup — Linux Desktop${isMultiBot ? ' Multi-Bot' : ''} ==="`,
-        'if ! command -v node > /dev/null 2>&1; then',
-        '  curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -',
-        '  sudo apt-get install -y nodejs',
-        'fi',
-        'npm install -g openclaw@latest',
-      ];
+      const lnx = [
+        '#!/usr/bin/env bash', 'set -e',
+        `echo "=== OpenClaw Setup — Linux Desktop${isMultiBot ? ' Multi-Bot' : ''} ==="`,
+        'if ! command -v node > /dev/null 2>&1; then',
+        '  curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -',
+        '  sudo apt-get install -y nodejs',
+        'fi',
+        'mkdir -p "$HOME/.local/bin"',
+        'npm config set prefix "$HOME/.local"',
+        'export PATH="$HOME/.local/bin:$PATH"',
+        'grep -Fqx \'export PATH="$HOME/.local/bin:$PATH"\' "$HOME/.bashrc" 2>/dev/null || echo \'export PATH="$HOME/.local/bin:$PATH"\' >> "$HOME/.bashrc"',
+        'grep -Fqx \'export PATH="$HOME/.local/bin:$PATH"\' "$HOME/.profile" 2>/dev/null || echo \'export PATH="$HOME/.local/bin:$PATH"\' >> "$HOME/.profile"',
+        'npm install -g openclaw@latest',
+      ];
       providerLines(lnx, 'sh');
       if (pluginCmd) lnx.push(pluginCmd);
 

package/tests/smoke-cli-logic.mjs

@@ -0,0 +1,160 @@
+import fs from 'fs';
+import path from 'path';
+
+const root = process.cwd();
+const cli = fs.readFileSync(path.join(root, 'cli.js'), 'utf8');
+const setup = fs.readFileSync(path.join(root, 'setup.js'), 'utf8');
+const indexHtml = fs.readFileSync(path.join(root, 'index.html'), 'utf8');
+
+function expect(condition, message) {
+  if (!condition) {
+    throw new Error(message);
+  }
+}
+
+function expectMatch(source, regex, message) {
+  expect(regex.test(source), message);
+}
+
+function expectOrder(source, before, after, message) {
+  const beforeIndex = source.indexOf(before);
+  const afterIndex = source.indexOf(after);
+  expect(beforeIndex !== -1, `${message} (missing first marker)`);
+  expect(afterIndex !== -1, `${message} (missing second marker)`);
+  expect(beforeIndex < afterIndex, message);
+}
+
+const checks = [];
+
+checks.push(() => expectMatch(
+  cli,
+  /const deployModeDefault = \(osChoice === 'ubuntu' \|\| osChoice === 'vps'\) \? 'native' : 'docker';/,
+  'Ubuntu/VPS must default to native deploy mode'
+));
+
+checks.push(() => expectMatch(
+  cli,
+  /if \(deployMode === 'docker' && !isDockerInstalled\(\)\)/,
+  'Docker branch must still auto-install Docker when missing'
+));
+
+checks.push(() => expectMatch(
+  cli,
+  /if \(!isOpenClawInstalled\(\)\) \{[\s\S]*installGlobalPackage\('openclaw@latest', \{ isVi, osChoice, displayName: 'openclaw' \}\)/,
+  'Native branch must auto-install openclaw'
+));
+
+checks.push(() => expectMatch(
+  cli,
+  /if \(osChoice === 'vps'\) \{[\s\S]*installGlobalPackage\('pm2@latest', \{ isVi, osChoice, displayName: 'PM2' \}\)/,
+  'VPS native branch must auto-install PM2'
+));
+
+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,
+  'Native CLI must configure a user-writable npm global prefix for non-Windows installs'
+));
+
+checks.push(() => expectMatch(
+  cli,
+  /execSync\('pm2 start ecosystem\.config\.js && pm2 save'/,
+  'Native Telegram multi-bot must start through PM2 ecosystem'
+));
+
+checks.push(() => expectMatch(
+  cli,
+  /execSync\(`pm2 start "openclaw gateway run" --name "\$\{appName\}" --cwd "\$\{projectDir\.replace\(\/\\\\\/g, '\/'\)\}" && pm2 save`/,
+  'Native single-bot VPS must start gateway through PM2'
+));
+
+checks.push(() => expectMatch(
+  cli,
+  /const child = spawn\('openclaw', \['gateway', 'run'\], \{/,
+  'Native desktop flows must start openclaw in foreground'
+));
+
+checks.push(() => expectOrder(
+  cli,
+  "await syncLocalConfigToHome(projectDir, isVi);",
+  "installRelayPluginForProject(projectDir, isVi);",
+  'Relay plugin install must happen after config sync in native flow'
+));
+
+checks.push(() => expectMatch(
+  cli,
+  /const pm2Apps = \[[\s\S]*args: 'gateway run'/,
+  'Native multi-bot ecosystem must run one gateway process'
+));
+
+checks.push(() => expectMatch(
+  setup,
+  /Linux Desktop[^]*Script tự cài Node\.js 20 LTS nếu chưa có, cài OpenClaw CLI[^]*khởi động bot ngay/s,
+  'Web wizard Linux Desktop advisory must mention auto-install OpenClaw and immediate start'
+));
+
+checks.push(() => expectMatch(
+  setup,
+  /Ubuntu \/ VPS[^]*Script tự cài Node\.js 20 LTS, OpenClaw CLI, PM2[^]*giữ bot chạy liên tục sau reboot/s,
+  'Web wizard VPS advisory must mention OpenClaw CLI and PM2'
+));
+
+checks.push(() => expectMatch(
+  indexHtml,
+  /Tải file → chạy để cài OpenClaw trực tiếp trên máy/,
+  'Native download card copy must mention OpenClaw direct install'
+));
+
+checks.push(() => expectMatch(
+  setup,
+  /if \(state\.nativeOs === 'win'\) \{[\s\S]*scriptName = isDocker \? 'setup-openclaw-docker-win\.bat' : 'setup-openclaw-win\.bat';[\s\S]*npm install -g openclaw@latest[\s\S]*openclaw gateway run/s,
+  'Windows native/docker script generation must use the correct file name and start command'
+));
+
+checks.push(() => expectMatch(
+  setup,
+  /else if \(state\.nativeOs === 'linux'\) \{[\s\S]*scriptName = isDocker \? 'setup-openclaw-docker-macos\.sh' : 'setup-openclaw-macos\.sh';[\s\S]*npm config set prefix "\$HOME\/\.local"[\s\S]*npm install -g openclaw@latest[\s\S]*openclaw gateway run/s,
+  'macOS script generation must use the correct file name and start command'
+));
+
+checks.push(() => expectMatch(
+  setup,
+  /else if \(state\.nativeOs === 'vps'\) \{[\s\S]*scriptName = 'setup-openclaw-vps\.sh';[\s\S]*npm config set prefix "\$HOME\/\.local"[\s\S]*npm install -g openclaw@latest pm2@latest[\s\S]*pm2 save && pm2 startup/s,
+  'VPS native script generation must install openclaw+pm2 and persist PM2 startup'
+));
+
+checks.push(() => expectMatch(
+  setup,
+  /else if \(state\.nativeOs === 'vps'\) \{[\s\S]*pm2 start --name openclaw-multibot -- sh -c "openclaw gateway run"[\s\S]*pm2 logs openclaw-multibot/s,
+  'VPS multi-bot native script must start the shared gateway via PM2'
+));
+
+checks.push(() => expectMatch(
+  setup,
+  /else if \(state\.nativeOs === 'vps'\) \{[\s\S]*pm2 start --name openclaw -- sh -c "openclaw gateway run"[\s\S]*pm2 logs openclaw/s,
+  'VPS single-bot native script must start one bot via PM2'
+));
+
+checks.push(() => expectMatch(
+  setup,
+  /else if \(state\.nativeOs === 'linux-desktop'\) \{[\s\S]*scriptName = 'setup-openclaw-linux\.sh';[\s\S]*npm config set prefix "\$HOME\/\.local"[\s\S]*npm install -g openclaw@latest[\s\S]*openclaw gateway run/s,
+  'Linux Desktop native script generation must install openclaw and run the gateway'
+));
+
+checks.push(() => expectMatch(
+  setup,
+  /instrEl\.innerHTML = state\.nativeOs === 'win'[\s\S]*double-click[\s\S]*chmod \+x \$\{scriptName\} && \.\/\$\{scriptName\}/s,
+  'Native instructions must show double-click for Windows and chmod for shell scripts'
+));
+
+checks.push(() => expectMatch(
+  setup,
+  /steps\.push\(isVi \? '.*Cài OpenClaw CLI.*' : '.*Install OpenClaw CLI.*'\);/s,
+  'Auto-steps summary must mention OpenClaw CLI installation'
+));
+
+for (const check of checks) {
+  check();
+}
+
+console.log(`Smoke checks passed: ${checks.length}`);