create-openclaw-bot 5.1.5 → 5.1.6

package/CHANGELOG.md

@@ -1,6 +1,14 @@
 # Changelog (English)
 
 
+## [5.1.6] — 2026-04-07
+
+### 🐞 Fix PM2 SIGKILL on Native VPS Installs
+
+- **Fix `PM2 SIGKILL` Error**: Removed the `-t` (interactive TTY) flag from all background `9router` launches. This terminal-dependent flag could cause PM2 to hang and aggressively SIGKILL the spawned process on headless VPS environments.
+- **Robust PM2 Sync Helper**: Added a two-stage fallback for the 9Router smart-route sync script. If PM2 encounters `SIGKILL` or memory limits while spawning the sync helper, the setup gracefully falls back to a background `nohup node ... &` process instead of throwing a hard exception. If both fail, it logs a warning but allows the overall OpenClaw setup to finish successfully.
+
+
 ## [5.1.5] — 2026-04-06
 
 ### 🐞 Fix Native PM2 9Router Startup

package/CHANGELOG.vi.md

@@ -1,6 +1,14 @@
 # Changelog (Tiếng Việt)
 
 
+## [5.1.6] — 2026-04-07
+
+### 🐞 Khắc phục lỗi PM2 ngắt cài đặt (SIGKILL) trên VPS
+
+- **Sửa lỗi `PM2 SIGKILL`**: Loại bỏ cờ `-t` (chế độ giao diện terminal) khỏi tất cả các lệnh gọi `9router` chạy ngầm. Trên các VPS không giao diện (headless), cờ này có thể khiến PM2 bị treo và ném ra lỗi SIGKILL làm chết toàn bộ quá trình cài đặt.
+- **Tối ưu Sync Helper chạy ngầm**: Bổ sung cơ chế dự phòng 2 lớp cho script tự động đồng bộ (sync helper). Nếu PM2 bị giới hạn RAM hoặc quá tải gây lỗi SIGKILL, script sẽ không văng lỗi sập Setup nữa mà tự động fallback xuống chạy ẩn bằng `nohup node ... &`. Trong trường hợp xấu nhất, bộ cài chỉ báo cảnh báo vàng và rẽ nhánh cho phép tiến trình Setup tiếp tục tới bước cuối cùng thành công.
+
+
 ## [5.1.5] — 2026-04-06
 
 ### 🐞 Sửa lỗi PM2 khởi động 9Router trên Native

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.5-0EA5E9?style=for-the-badge" alt="Version 5.1.5" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.1.6-0EA5E9?style=for-the-badge" alt="Version 5.1.6" /></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.5
+## 🆕 What's new in v5.1.6
 
 - 💻 **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.5 for me.
+   Read SETUP.md and set up OpenClaw v5.1.6 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.5-0EA5E9?style=for-the-badge" alt="Version 5.1.5" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.1.6-0EA5E9?style=for-the-badge" alt="Version 5.1.6" /></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.5
+## 🆕 Có gì mới trong v5.1.6
 
 - 💻 **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.5 for me.
+   Read SETUP.md and set up OpenClaw v5.1.6 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

@@ -145,7 +145,7 @@ function spawnBackgroundProcess(command, args, options = {}) {
   });
 }
 
-function resolveNative9RouterDesktopLaunch() {
+function resolveNative9RouterDesktopLaunch() {
   if (process.platform === 'win32') {
     const npmRoot = (() => {
       try {
@@ -170,12 +170,12 @@ function resolveNative9RouterDesktopLaunch() {
     };
   }
 
-  return {
-    command: '9router',
-    args: ['-n', '-t', '-l', '-H', '0.0.0.0', '-p', '20128', '--skip-update'],
-    env: {}
-  };
-}
+  return {
+    command: '9router',
+    args: ['-n', '-l', '-H', '0.0.0.0', '-p', '20128', '--skip-update'],
+    env: {}
+  };
+}
 
 function getNative9RouterDataDir() {
   if (process.platform === 'win32') {
@@ -393,7 +393,7 @@ function build9RouterComposeEntrypointScript(syncScriptBase64) {
     'npm install -g 9router',
     `node -e "require('fs').writeFileSync('/tmp/sync.js',Buffer.from('${syncScriptBase64}','base64').toString())"`,
     'node /tmp/sync.js > /tmp/sync.log 2>&1 &',
-    'exec 9router -n -t -l -H 0.0.0.0 -p 20128 --skip-update'
+    'exec 9router -n -l -H 0.0.0.0 -p 20128 --skip-update'
   ].join('\n');
 }
 
@@ -637,7 +637,6 @@ function startNative9RouterPm2({ isVi, projectDir, appName, syncScriptPath }) {
     'none',
     '--',
     '-n',
-    '-t',
     '-l',
     '-H',
     '0.0.0.0',
@@ -651,20 +650,39 @@ function startNative9RouterPm2({ isVi, projectDir, appName, syncScriptPath }) {
   });
   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
-    });
+    const normalizedSyncScriptPath = syncScriptPath.replace(/\\/g, '/');
+    try {
+      execFileSync('pm2', [
+        'start',
+        normalizedSyncScriptPath,
+        '--name',
+        syncAppName,
+        '--cwd',
+        projectDir.replace(/\\/g, '/'),
+        '--interpreter',
+        process.execPath
+      ], {
+        cwd: projectDir,
+        stdio: 'inherit',
+        env: process.env
+      });
+    } catch {
+      try {
+        execSync(`nohup "${process.execPath}" "${normalizedSyncScriptPath}" >/tmp/${syncAppName}.log 2>&1 &`, {
+          cwd: projectDir,
+          stdio: 'ignore',
+          shell: true,
+          env: process.env
+        });
+        console.log(chalk.yellow(isVi
+          ? `⚠️  PM2 khong khoi dong duoc sync helper. Da fallback sang background node: /tmp/${syncAppName}.log`
+          : `⚠️  PM2 could not start the sync helper. Fell back to a background node process: /tmp/${syncAppName}.log`));
+      } catch {
+        console.log(chalk.yellow(isVi
+          ? `⚠️  Khong the khoi dong 9Router sync helper. 9Router van chay, nhung smart-route co the can dong bo thu cong sau.`
+          : `⚠️  Could not start the 9Router sync helper. 9Router is still running, but smart-route may need manual syncing later.`));
+      }
+    }
   }
   runPm2Save({ projectDir, isVi });
   console.log(chalk.green(`\n✅ ${isVi ? '9Router da duoc khoi dong qua PM2.' : '9Router is running via PM2.'}`));

package/package.json

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

package/setup.js

@@ -1767,7 +1767,7 @@ model:
       'npm install -g 9router',
       `node -e "require('fs').writeFileSync('/tmp/sync.js',Buffer.from('${syncScriptBase64}','base64').toString())"`,
       'node /tmp/sync.js > /tmp/sync.log 2>&1 &',
-      'exec 9router -n -t -l -H 0.0.0.0 -p 20128 --skip-update'
+      'exec 9router -n -l -H 0.0.0.0 -p 20128 --skip-update'
     ].join('\n');
 
     state.config.plugins.forEach((pid) => {
@@ -2870,12 +2870,12 @@ const sync=()=>{try{let db={};try{db=JSON.parse(fs.readFileSync(p,'utf8'));}catc
       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('start "9Router" cmd /k "9router -n -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 9router -n -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');
         }
@@ -3536,7 +3536,7 @@ ${selectedSkillNames.length ? selectedSkillNames.join('\n') : '- _(No skills ins
         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 -- sh -c "9router -n -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"');
@@ -3549,7 +3549,7 @@ ${selectedSkillNames.length ? selectedSkillNames.join('\n') : '- _(No skills ins
       } 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 -- sh -c "9router -n -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"');

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]*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,
+  /function startNative9RouterPm2\(\{ isVi, projectDir, appName, syncScriptPath \}\) \{[\s\S]*resolveCommandOnPath\('9router'\)[\s\S]*execFileSync\('pm2'[\s\S]*--interpreter'?,?[\s\S]*none[\s\S]*'-n'[\s\S]*'-l'[\s\S]*'--skip-update'[\s\S]*nohup "\$\{process\.execPath\}" "\$\{normalizedSyncScriptPath\}" >\/tmp\/\$\{syncAppName\}\.log 2>&1 &[\s\S]*runPm2Save\(\{ projectDir, isVi \}\)/s,
   'VPS native 9Router flow must start a standalone 9Router dashboard on port 20128 via PM2'
 ));
 
@@ -207,7 +207,7 @@ checks.push(() => expectMatch(
 
 checks.push(() => expectMatch(
   cli,
-  /function resolveNative9RouterDesktopLaunch\(\) \{[\s\S]*process\.platform === 'win32'[\s\S]*npm root -g[\s\S]*9router', 'app', 'server\.js'[\s\S]*PORT: '20128'[\s\S]*HOSTNAME: '0\.0\.0\.0'[\s\S]*command: '9router'[\s\S]*\['-n', '-t', '-l', '-H', '0\.0\.0\.0', '-p', '20128', '--skip-update'\]/s,
+  /function resolveNative9RouterDesktopLaunch\(\) \{[\s\S]*process\.platform === 'win32'[\s\S]*npm root -g[\s\S]*9router', 'app', 'server\.js'[\s\S]*PORT: '20128'[\s\S]*HOSTNAME: '0\.0\.0\.0'[\s\S]*command: '9router'[\s\S]*\['-n', '-l', '-H', '0\.0\.0\.0', '-p', '20128', '--skip-update'\]/s,
   'Native desktop 9Router launch must bypass the interactive CLI menu on Windows while preserving the standard CLI launch elsewhere'
 ));
 
@@ -292,7 +292,7 @@ checks.push(() => expectMatch(
 
 checks.push(() => expectMatch(
   setup,
-  /function providerLines\(arr, shell\) \{[\s\S]*npm install -g 9router[\s\S]*start "9Router" cmd \/k "9router -n -t -l -H 0\.0\.0\.0 -p 20128 --skip-update"[\s\S]*9router-smart-route-sync\.js/s,
+  /function providerLines\(arr, shell\) \{[\s\S]*npm install -g 9router[\s\S]*start "9Router" cmd \/k "9router -n -l -H 0\.0\.0\.0 -p 20128 --skip-update"[\s\S]*nohup 9router -n -l -H 0\.0\.0\.0 -p 20128 --skip-update[\s\S]*9router-smart-route-sync\.js/s,
   'Native script generation must install and start a standalone 9Router dashboard on port 20128'
 ));
 

package/tmp_diff.patch

@@ -1,114 +0,0 @@
-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'
- ));
-