create-openclaw-bot 5.0.5 → 5.0.7

package/CHANGELOG.md

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

package/CHANGELOG.vi.md

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

@@ -50,14 +50,104 @@ function isPm2Installed() {
   }
 }
 
+function is9RouterInstalled() {
+  try {
+    execSync('9router --help', { 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 = osChoice === 'windows'
-    ? [`npm install -g ${pkg}`]
-    : [`npm install -g ${pkg}`, `sudo npm install -g ${pkg}`];
+  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 });
+      execSync(cmd, { stdio: 'inherit', shell: true, env: process.env });
       return true;
     } catch {
       // try next candidate
@@ -65,11 +155,75 @@ function installGlobalPackage(pkg, { isVi, osChoice, displayName }) {
   }
 
   console.log(chalk.yellow(isVi
-    ? `⚠️  Không thể tự cài ${displayName}. Chạy thủ công: ${osChoice === 'windows' ? `npm install -g ${pkg}` : `sudo npm install -g ${pkg}`}`
-    : `⚠️  Could not auto-install ${displayName}. Run manually: ${osChoice === 'windows' ? `npm install -g ${pkg}` : `sudo npm install -g ${pkg}`}`));
+    ? `⚠️  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;
 }
 
+function extractFirstHttpUrl(text) {
+  const match = String(text || '').match(/https?:\/\/[^\s"'`]+/);
+  return match ? match[0] : null;
+}
+
+function getTokenizedDashboardUrl(projectDir) {
+  try {
+    const output = execSync('openclaw dashboard', {
+      cwd: projectDir,
+      env: process.env,
+      encoding: 'utf8',
+      shell: true,
+      stdio: ['ignore', 'pipe', 'pipe'],
+      timeout: 15000
+    });
+    return extractFirstHttpUrl(output);
+  } catch (error) {
+    const combined = `${error?.stdout || ''}\n${error?.stderr || ''}`;
+    return extractFirstHttpUrl(combined);
+  }
+}
+
+function printNativeDashboardAccessInfo({ isVi, providerKey, projectDir, gatewayPort = 18791 }) {
+  const dashboardUrl = `http://localhost:${gatewayPort}`;
+  const tokenizedUrl = getTokenizedDashboardUrl(projectDir);
+
+  console.log(chalk.yellow(`\n🧭 ${isVi ? 'Dashboard OpenClaw:' : 'OpenClaw Dashboard:'} ${dashboardUrl}`));
+
+  if (tokenizedUrl) {
+    console.log(chalk.green(isVi
+      ? `   → Mở link đã kèm token: ${tokenizedUrl}`
+      : `   → Open the tokenized link directly: ${tokenizedUrl}`));
+  } else {
+    console.log(chalk.gray(isVi
+      ? '   → Nếu dashboard đòi Gateway Token, chạy: openclaw dashboard'
+      : '   → If the dashboard asks for a Gateway Token, run: openclaw dashboard'));
+  }
+
+  if (providerKey === '9router') {
+    console.log(chalk.yellow(`\n🔀 ${isVi ? '9Router Dashboard:' : '9Router Dashboard:'} http://localhost:20128/dashboard`));
+    console.log(chalk.gray(isVi
+      ? '   → Mở dashboard 9Router → đăng nhập OAuth → kết nối provider miễn phí'
+      : '   → Open the 9Router dashboard → complete OAuth login → connect a free provider'));
+    console.log(chalk.gray(isVi
+      ? '   → Sau khi login 9Router xong, bot sẽ tự dùng model smart-route qua http://localhost:20128/v1'
+      : '   → Once 9Router is logged in, the bot will use smart-route through http://localhost:20128/v1'));
+  }
+}
+
+function startNative9RouterPm2({ isVi, projectDir, appName }) {
+  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`,
+    {
+      cwd: projectDir,
+      stdio: 'inherit',
+      shell: true,
+      env: process.env
+    }
+  );
+  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}`));
+}
+
 async function syncLocalConfigToHome(projectDir, isVi) {
   const homedir = os.homedir();
   const globalClawDir = path.join(homedir, '.openclaw');
@@ -1109,7 +1263,7 @@ ${hasBrowserDesktop ? `    extra_hosts:
           mode: 'merge',
           providers: {
             '9router': {
-              baseUrl: 'http://9router:20128/v1',
+              baseUrl: deployMode === 'native' ? 'http://localhost:20128/v1' : 'http://9router:20128/v1',
               apiKey: 'sk-no-key',
               api: 'openai-completions',
               models: [
@@ -1355,7 +1509,7 @@ ${hasBrowserDesktop ? `    extra_hosts:
           mode: 'merge',
           providers: {
             '9router': {
-              baseUrl: 'http://9router:20128/v1',
+              baseUrl: deployMode === 'native' ? 'http://localhost:20128/v1' : 'http://9router:20128/v1',
               apiKey: 'sk-no-key',
               api: 'openai-completions',
               models: [
@@ -1712,7 +1866,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/')}`));
@@ -1736,12 +1890,22 @@ fi
       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', { isVi, osChoice, displayName: 'openclaw' })) {
+      if (!installGlobalPackage('openclaw@latest', { isVi, osChoice, displayName: 'openclaw' })) {
         process.exit(1);
       }
       console.log(chalk.green(isVi ? '✅ openclaw da cai xong!' : '✅ openclaw installed!'));
     }
 
+    if (providerKey === '9router' && !is9RouterInstalled()) {
+      console.log(chalk.cyan(isVi
+        ? '\n📦 Dang cai 9Router binary (npm install -g 9router)...'
+        : '\n📦 Installing 9Router binary (npm install -g 9router)...'));
+      if (!installGlobalPackage('9router@latest', { isVi, osChoice, displayName: '9Router' })) {
+        process.exit(1);
+      }
+      console.log(chalk.green(isVi ? '✅ 9Router da cai xong!' : '✅ 9Router installed!'));
+    }
+
     await syncLocalConfigToHome(projectDir, isVi);
 
     if (isMultiBot && channelKey === 'telegram') {
@@ -1751,12 +1915,15 @@ fi
     if (osChoice === 'vps') {
       if (!isPm2Installed()) {
         console.log(chalk.cyan(isVi ? '\n📦 Dang cai PM2...' : '\n📦 Installing PM2...'));
-        if (!installGlobalPackage('pm2', { isVi, osChoice, displayName: 'PM2' })) {
+        if (!installGlobalPackage('pm2@latest', { isVi, osChoice, displayName: 'PM2' })) {
           process.exit(1);
         }
       }
 
       if (isMultiBot && channelKey === 'telegram') {
+        if (providerKey === '9router') {
+          startNative9RouterPm2({ isVi, projectDir, appName: botName || 'openclaw-multibot' });
+        }
         execSync('pm2 start ecosystem.config.js && pm2 save', {
           cwd: projectDir,
           stdio: 'inherit',
@@ -1764,8 +1931,12 @@ 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 });
       } else {
         const appName = botName || 'openclaw';
+        if (providerKey === '9router') {
+          startNative9RouterPm2({ isVi, projectDir, appName });
+        }
         execSync(`pm2 start "openclaw gateway run" --name "${appName}" --cwd "${projectDir.replace(/\\/g, '/')}" && pm2 save`, {
           cwd: projectDir,
           stdio: 'inherit',
@@ -1773,8 +1944,21 @@ 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 });
       }
     } else {
+      if (providerKey === '9router') {
+        console.log(chalk.yellow(`\n${isVi ? 'Khoi dong 9Router native (background)...' : 'Starting native 9Router (background)...'}`));
+        spawn('9router', ['-n', '-t', '-l', '-H', '0.0.0.0', '-p', '20128', '--skip-update'], {
+          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'));
+      }
       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.5+ natively supports deployment script generation for Windows, Linux, VPS, and Hosting environments.
+OpenClaw v5.0.7+ 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.5+ tự động sinh sẵn các script cài đặt dành riêng cho Windows, Linux, VPS và Hosting.
+OpenClaw v5.0.7+ 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.5",
+  "version": "5.0.7",
   "description": "Interactive CLI installer for OpenClaw Bot",
   "main": "cli.js",
   "bin": {

package/setup.js

@@ -2836,18 +2836,18 @@ I am **${botName}**. When asked my name, I answer: _"I'm ${botName}"_.`;
     const pluginCmd = allPlugins.length > 0 ? ('npm exec openclaw plugins install ' + allPlugins.join(' ')) : '';
 
     // ─── Shared initializer (provider install) ───────────────────────────────
-    function providerLines(arr, shell) {
-      if (is9Router) {
-        if (shell === 'bat') {
-          arr.push('npm install -g 9router');
-          arr.push('start "9Router" cmd /k "9router"');
-          arr.push('timeout /t 5 /nobreak >nul');
-        } else {
-          arr.push('npm install -g 9router');
-          arr.push('9router &');
-          arr.push('sleep 3');
-        }
-      } else if (isOllama) {
+    function providerLines(arr, shell) {
+      if (is9Router) {
+        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('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('sleep 3');
+        }
+      } else if (isOllama) {
         if (shell === 'bat') {
           arr.push('where ollama >nul 2>&1 || (powershell -Command "Invoke-WebRequest -Uri https://ollama.com/download/OllamaSetup.exe -OutFile OllamaSetup.exe" && OllamaSetup.exe && del OllamaSetup.exe)');
           arr.push('ollama pull ' + selectedModel);
@@ -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

@@ -40,16 +40,28 @@ checks.push(() => expectMatch(
 
 checks.push(() => expectMatch(
   cli,
-  /if \(!isOpenClawInstalled\(\)\) \{[\s\S]*installGlobalPackage\('openclaw', \{ isVi, osChoice, displayName: 'openclaw' \}\)/,
+  /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', \{ isVi, osChoice, displayName: 'PM2' \}\)/,
+  /if \(osChoice === 'vps'\) \{[\s\S]*installGlobalPackage\('pm2@latest', \{ isVi, osChoice, displayName: 'PM2' \}\)/,
   'VPS native branch must auto-install PM2'
 ));
 
+checks.push(() => expectMatch(
+  cli,
+  /if \(providerKey === '9router' && !is9RouterInstalled\(\)\) \{[\s\S]*installGlobalPackage\('9router@latest', \{ isVi, osChoice, displayName: '9Router' \}\)/,
+  'Native 9Router flow must auto-install 9Router'
+));
+
+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'/,
@@ -62,6 +74,24 @@ checks.push(() => expectMatch(
   'Native single-bot VPS must start gateway through PM2'
 ));
 
+checks.push(() => expectMatch(
+  cli,
+  /function printNativeDashboardAccessInfo\(\{ isVi, providerKey, projectDir, gatewayPort = 18791 \}\) \{[\s\S]*openclaw dashboard[\s\S]*9Router Dashboard:[\s\S]*localhost:20128\/dashboard/s,
+  'Native PM2 flow must expose dashboard access info and the tokenized dashboard command'
+));
+
+checks.push(() => expectMatch(
+  cli,
+  /baseUrl: deployMode === 'native' \? 'http:\/\/localhost:20128\/v1' : 'http:\/\/9router:20128\/v1'/,
+  'Native 9Router config must target localhost instead of the Docker hostname'
+));
+
+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,
+  'VPS native 9Router flow must start a standalone 9Router dashboard on port 20128 via PM2'
+));
+
 checks.push(() => expectMatch(
   cli,
   /const child = spawn\('openclaw', \['gateway', 'run'\], \{/,
@@ -107,16 +137,22 @@ checks.push(() => expectMatch(
 
 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 install -g openclaw@latest[\s\S]*openclaw gateway run/s,
+  /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 install -g openclaw@latest pm2[\s\S]*pm2 save && pm2 startup/s,
+  /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,
+  /function providerLines\(arr, shell\) \{[\s\S]*npm install -g 9router[\s\S]*9router -n -t -l -H 0\.0\.0\.0 -p 20128 --skip-update/s,
+  'Native script generation must install and start a standalone 9Router dashboard on port 20128'
+));
+
 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,
@@ -131,7 +167,7 @@ checks.push(() => expectMatch(
 
 checks.push(() => expectMatch(
   setup,
-  /else if \(state\.nativeOs === 'linux-desktop'\) \{[\s\S]*scriptName = 'setup-openclaw-linux\.sh';[\s\S]*npm install -g openclaw@latest[\s\S]*openclaw gateway run/s,
+  /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'
 ));