create-openclaw-bot 5.1.4 → 5.1.5

package/CHANGELOG.md

@@ -1,6 +1,14 @@
 # Changelog (English)
 
 
+## [5.1.5] — 2026-04-06
+
+### 🐞 Fix Native PM2 9Router Startup
+
+- **Fix**: Replaced shell string execution (`execSync`) with strict array arguments (`execFileSync`) when starting 9Router and its background sync script via PM2 on native systems. This guarantees reliable process spawning across both Linux (VPS) and Windows environments without PM2 shell-parsing errors on quotes or path spaces.
+- **Improved**: PM2 now explicitly runs the global `9router` binary via `--interpreter none` and the sync script via the current NodeJS runtime using `--interpreter process.execPath`.
+
+
 ## [5.1.4] — 2026-04-06
 
 ### 🐞 Fix CLI Startup BOM Error & Improve Docker Timeout Patch

package/CHANGELOG.vi.md

@@ -1,6 +1,14 @@
 # Changelog (Tiếng Việt)
 
 
+## [5.1.5] — 2026-04-06
+
+### 🐞 Sửa lỗi PM2 khởi động 9Router trên Native
+
+- **Fix**: Chuyển từ việc chạy chuỗi bash (`execSync`) sang truyền mảng tham số rõ ràng (`execFileSync`) khi khởi động 9Router và script đồng bộ (sync) qua PM2. Đảm bảo PM2 luôn chạy được ứng dụng ổn định trên cả Linux (VPS) và Windows mà không bị vướng lỗi phân tích cú pháp dấu ngoặc kép hay khoảng trắng trong đường dẫn.
+- **Tối ưu**: PM2 giờ đây sẽ phân tách rạch ròi bằng cách gọi file thực thi `9router` với tham số `--interpreter none`, và luôn chạy sync script bằng đúng phiên bản NodeJS nội tại thông qua `--interpreter process.execPath`.
+
+
 ## [5.1.4] — 2026-04-06
 
 ### 🐞 Sửa lỗi BOM khởi động CLI & Tối ưu luồng vá Timeout trê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.1.4-0EA5E9?style=for-the-badge" alt="Version 5.1.4" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.1.5-0EA5E9?style=for-the-badge" alt="Version 5.1.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.1.4
+## 🆕 What's new in v5.1.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.
@@ -112,7 +112,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.1.4 for me.
+   Read SETUP.md and set up OpenClaw v5.1.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.1.4-0EA5E9?style=for-the-badge" alt="Version 5.1.4" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.1.5-0EA5E9?style=for-the-badge" alt="Version 5.1.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.1.4
+## 🆕 Có gì mới trong v5.1.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.
@@ -112,7 +112,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.1.4 for me.
+   Read SETUP.md and set up OpenClaw v5.1.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

@@ -5,7 +5,7 @@ import fs from 'fs-extra';
 import path from 'path';
 import os from 'os';
 import chalk from 'chalk';
-import { spawn, execSync } from 'child_process';
+import { spawn, execSync, execFileSync } from 'child_process';
 const TELEGRAM_RELAY_PLUGIN_ID = 'openclaw-telegram-multibot-relay';
 // Use plain npm package name — clawhub: protocol not supported in all OpenClaw versions
 const TELEGRAM_RELAY_PLUGIN_SPEC = TELEGRAM_RELAY_PLUGIN_ID;
@@ -95,7 +95,7 @@ function quotePowerShellSingle(value) {
   return `'${String(value).replace(/'/g, "''")}'`;
 }
 
-function resolveWindowsCommand(command) {
+function resolveWindowsCommand(command) {
   try {
     const output = execSync(`where.exe ${command}`, {
       stdio: ['ignore', 'pipe', 'ignore'],
@@ -363,6 +363,23 @@ setTimeout(sync, 5000);
 setInterval(sync, INTERVAL);`;
 }
 
+function resolveCommandOnPath(command) {
+  if (process.platform === 'win32') {
+    return resolveWindowsCommand(command);
+  }
+
+  try {
+    return execSync(`command -v ${command}`, {
+      stdio: ['ignore', 'pipe', 'ignore'],
+      encoding: 'utf8',
+      shell: true,
+      env: process.env
+    }).trim() || command;
+  } catch {
+    return command;
+  }
+}
+
 function indentBlock(text, spaces) {
   const prefix = ' '.repeat(spaces);
   return String(text)
@@ -606,30 +623,50 @@ function runPm2Save({ projectDir, isVi }) {
   }
 }
 
-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, '/')}"`,
-    {
-      cwd: projectDir,
-      stdio: 'inherit',
-      shell: true,
-      env: process.env
-    }
-  );
-  if (syncScriptPath) {
-    const syncAppName = `${appName}-9router-sync`;
-    execSync(
-      `pm2 start "node ${syncScriptPath.replace(/\\/g, '/')}" --name "${syncAppName}" --cwd "${projectDir.replace(/\\/g, '/')}"`,
-      {
-        cwd: projectDir,
-        stdio: 'inherit',
-        shell: true,
-        env: process.env
-      }
-    );
-  }
-  runPm2Save({ projectDir, isVi });
+function startNative9RouterPm2({ isVi, projectDir, appName, syncScriptPath }) {
+  const routerAppName = `${appName}-9router`;
+  const routerCommand = resolveCommandOnPath('9router');
+  execFileSync('pm2', [
+    'start',
+    routerCommand,
+    '--name',
+    routerAppName,
+    '--cwd',
+    projectDir.replace(/\\/g, '/'),
+    '--interpreter',
+    'none',
+    '--',
+    '-n',
+    '-t',
+    '-l',
+    '-H',
+    '0.0.0.0',
+    '-p',
+    '20128',
+    '--skip-update'
+  ], {
+    cwd: projectDir,
+    stdio: 'inherit',
+    env: process.env
+  });
+  if (syncScriptPath) {
+    const syncAppName = `${appName}-9router-sync`;
+    execFileSync('pm2', [
+      'start',
+      syncScriptPath.replace(/\\/g, '/'),
+      '--name',
+      syncAppName,
+      '--cwd',
+      projectDir.replace(/\\/g, '/'),
+      '--interpreter',
+      process.execPath
+    ], {
+      cwd: projectDir,
+      stdio: 'inherit',
+      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}`));
 }

package/package.json

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

package/tests/smoke-cli-logic.mjs

@@ -195,7 +195,7 @@ checks.push(() => expectMatch(
 
 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,
+  /function startNative9RouterPm2\(\{ isVi, projectDir, appName, syncScriptPath \}\) \{[\s\S]*resolveCommandOnPath\('9router'\)[\s\S]*execFileSync\('pm2'[\s\S]*--interpreter'?,?[\s\S]*none[\s\S]*--skip-update[\s\S]*syncScriptPath\.replace\(\/\\\\\/g, '\/'\)[\s\S]*process\.execPath[\s\S]*runPm2Save\(\{ projectDir, isVi \}\)/s,
   'VPS native 9Router flow must start a standalone 9Router dashboard on port 20128 via PM2'
 ));
 

package/tmp_diff.patch

@@ -0,0 +1,114 @@
+diff --git a/cli.js b/cli.js
+index e0bbb01..4d1b591 100644
+--- a/cli.js
++++ b/cli.js
+@@ -5,7 +5,7 @@ import fs from 'fs-extra';
+ import path from 'path';
+ import os from 'os';
+ import chalk from 'chalk';
+-import { spawn, execSync } from 'child_process';
++import { spawn, execSync, execFileSync } from 'child_process';
+ const TELEGRAM_RELAY_PLUGIN_ID = 'openclaw-telegram-multibot-relay';
+ // Use plain npm package name ΓÇö clawhub: protocol not supported in all OpenClaw versions
+ const TELEGRAM_RELAY_PLUGIN_SPEC = TELEGRAM_RELAY_PLUGIN_ID;
+@@ -363,6 +363,23 @@ setTimeout(sync, 5000);
+ setInterval(sync, INTERVAL);`;
+ }
+ 
++function resolveCommandOnPath(command) {
++  if (process.platform === 'win32') {
++    return resolveWindowsCommand(command);
++  }
++
++  try {
++    return execSync(`command -v ${command}`, {
++      stdio: ['ignore', 'pipe', 'ignore'],
++      encoding: 'utf8',
++      shell: true,
++      env: process.env
++    }).trim() || command;
++  } catch {
++    return command;
++  }
++}
++
+ function indentBlock(text, spaces) {
+   const prefix = ' '.repeat(spaces);
+   return String(text)
+@@ -608,26 +625,46 @@ function runPm2Save({ projectDir, isVi }) {
+ 
+ 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, '/')}"`,
+-    {
++  const routerCommand = resolveCommandOnPath('9router');
++  execFileSync('pm2', [
++    'start',
++    routerCommand,
++    '--name',
++    routerAppName,
++    '--cwd',
++    projectDir.replace(/\\/g, '/'),
++    '--interpreter',
++    'none',
++    '--',
++    '-n',
++    '-t',
++    '-l',
++    '-H',
++    '0.0.0.0',
++    '-p',
++    '20128',
++    '--skip-update'
++  ], {
++    cwd: projectDir,
++    stdio: 'inherit',
++    env: process.env
++  });
++  if (syncScriptPath) {
++    const syncAppName = `${appName}-9router-sync`;
++    execFileSync('pm2', [
++      'start',
++      syncScriptPath.replace(/\\/g, '/'),
++      '--name',
++      syncAppName,
++      '--cwd',
++      projectDir.replace(/\\/g, '/'),
++      '--interpreter',
++      process.execPath
++    ], {
+       cwd: projectDir,
+       stdio: 'inherit',
+-      shell: true,
+       env: process.env
+-    }
+-  );
+-  if (syncScriptPath) {
+-    const syncAppName = `${appName}-9router-sync`;
+-    execSync(
+-      `pm2 start "node ${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.'}`));
+diff --git a/tests/smoke-cli-logic.mjs b/tests/smoke-cli-logic.mjs
+index 3ab996c..7fd80f8 100644
+--- a/tests/smoke-cli-logic.mjs
++++ b/tests/smoke-cli-logic.mjs
+@@ -195,7 +195,7 @@ checks.push(() => expectMatch(
+ 
+ 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,
++  /function startNative9RouterPm2\(\{ isVi, projectDir, appName, syncScriptPath \}\) \{[\s\S]*resolveCommandOnPath\('9router'\)[\s\S]*execFileSync\('pm2'[\s\S]*--interpreter'?,?[\s\S]*none[\s\S]*--skip-update[\s\S]*syncScriptPath\.replace\(\/\\\\\/g, '\/'\)[\s\S]*process\.execPath[\s\S]*runPm2Save\(\{ projectDir, isVi \}\)/s,
+   'VPS native 9Router flow must start a standalone 9Router dashboard on port 20128 via PM2'
+ ));
+