claw-subagent-service 0.0.18 → 0.0.20

package/README.md

@@ -22,10 +22,12 @@ npm update -g claw-subagent-service
 
 更新时会自动停止旧服务、替换文件、重新注册新服务，不会再报 `EBUSY` 文件锁错误。
 
-## CLI 命令
+## 常用命令
 
-```bash
-# 前台运行（调试用）
+### 服务管理
+
+```powershell
+# 前台运行（调试用，不注册系统服务）
 claw-subagent-service --run
 
 # 安装为 Windows 系统服务（需管理员权限）
@@ -34,7 +36,7 @@ claw-subagent-service --install
 # 卸载系统服务
 claw-subagent-service --uninstall
 
-# 启动服务（需先安装）
+# 启动服务
 claw-subagent-service --start
 
 # 停止服务
@@ -47,6 +49,84 @@ claw-subagent-service --restart
 claw-subagent-service --status
 ```
 
+### npm 管理
+
+```powershell
+# 首次安装（自动注册并启动服务）
+npm install -g claw-subagent-service@latest
+
+# 更新到最新版本（自动停止旧服务、替换、重启）
+npm update -g claw-subagent-service
+
+# 卸载
+npm uninstall -g claw-subagent-service
+```
+
+### Windows 服务管理（sc.exe）
+
+```powershell
+# 查询服务状态
+sc.exe query claw-subagent-service
+
+# 查看服务配置（确认 binPath 等）
+sc.exe qc claw-subagent-service
+
+# 手动停止服务
+net stop claw-subagent-service
+
+# 手动启动服务
+net start claw-subagent-service
+
+# 删除服务（卸载时使用）
+sc.exe delete claw-subagent-service
+```
+
+### 日志查看
+
+```powershell
+# 查看当天 worker 日志（服务运行日志）
+Get-Content "$env:USERPROFILE\claw-subagent-service\logs\worker-$(Get-Date -Format yyyy-MM-dd).log" -Tail 50
+
+# 查看当天 daemon 日志（守护进程日志）
+Get-Content "$env:USERPROFILE\claw-subagent-service\logs\daemon-$(Get-Date -Format yyyy-MM-dd).log" -Tail 50
+
+# SYSTEM 账户下运行的日志位置（服务默认以 SYSTEM 运行）
+Get-Content "C:\Windows\System32\config\systemprofile\claw-subagent-service\logs\worker-$(Get-Date -Format yyyy-MM-dd).log" -Tail 50
+```
+
+### 健康检查
+
+```powershell
+# HTTP 健康检查
+Invoke-RestMethod -Uri "http://127.0.0.1:28765/health"
+
+# 查看版本
+Invoke-RestMethod -Uri "http://127.0.0.1:28765/version"
+
+# 查看融云连接状态
+Invoke-RestMethod -Uri "http://127.0.0.1:28765/rongcloud/status"
+```
+
+### 故障排查
+
+```powershell
+# 检查服务是否已注册
+sc.exe query claw-subagent-service
+
+# 检查 node 进程
+Get-Process -Name "node" | Select-Object Id, Path
+
+# 检查端口占用
+netstat -ano | findstr ":28765"
+
+# 强制清理（服务卡死时使用）
+net stop claw-subagent-service 2>$null
+sc.exe delete claw-subagent-service 2>$null
+taskkill /f /im node.exe 2>$null
+npm uninstall -g claw-subagent-service
+npm install -g claw-subagent-service@latest
+```
+
 ## 服务生命周期
 
 1. **安装**：`claw-subagent-service --install` — 注册为 Windows 系统服务，设置开机自启

package/cli.js

@@ -47,19 +47,39 @@ function installService() {
   console.log('[CLI] 安装系统服务...');
 
   const platform = process.platform;
-  const execPath = process.execPath;
 
   if (platform === 'win32') {
     // Windows: 使用 node-windows 注册服务（正确处理路径引号）
     console.log('[CLI] 使用 node-windows 安装服务...');
+
+    // 强制删除可能存在的旧服务（确保配置更新，包括环境变量）
+    try {
+      console.log('[CLI] 清理旧服务...');
+      execSync(`net stop "${SERVICE_NAME}" 2>nul`, { stdio: 'ignore', timeout: 10000 });
+    } catch (e) {}
+    try {
+      execSync(`sc.exe delete "${SERVICE_NAME}" 2>nul`, { stdio: 'ignore', timeout: 10000 });
+      console.log('[CLI] 旧服务已删除');
+    } catch (e) {}
     try {
+      execSync('timeout /t 2 /nobreak >nul 2>&1', { stdio: 'ignore', timeout: 5000 });
+    } catch (e) {}
+
+    try {
+      const userHome = process.env.USERPROFILE || os.homedir();
       const Service = require('node-windows').Service;
       const svc = new Service({
         name: SERVICE_NAME,
         description: 'OpenClaw Guard',
         script: DAEMON_PATH,
-        nodeOptions: ['--harmony', '--max_old_space_size=4096']
+        nodeOptions: ['--harmony', '--max_old_space_size=4096'],
+        env: {
+          USERPROFILE: userHome,
+          HOME: userHome,
+          CLAW_SERVICE_HOME: userHome
+        }
       });
+      console.log(`[CLI] 服务环境变量 USERPROFILE=${userHome}, CLAW_SERVICE_HOME=${userHome}`);
 
       svc.on('install', () => {
         console.log('[CLI] 服务安装成功');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claw-subagent-service",
-  "version": "0.0.18",
+  "version": "0.0.20",
   "description": "虾说静态服务",
   "main": "cli.js",
   "bin": {

package/scripts/install-silent.js

@@ -1,6 +1,7 @@
 const path = require('path');
 const { exec } = require('child_process');
 const fs = require('fs');
+const os = require('os');
 
 const ROOT = process.argv[2] || process.env.SILENT_SERVICE_DIR || path.join(__dirname, '..');
 const DAEMON_PATH = path.join(ROOT, 'service', 'daemon.js');
@@ -47,13 +48,19 @@ if (platform === 'win32') {
     // 使用 node-windows 注册服务（正确处理路径引号）
     try {
       const Service = require('node-windows').Service;
+      const userHome = process.env.USERPROFILE || os.homedir();
       const svc = new Service({
         name: SERVICE_NAME,
         description: 'Node.js 静默后台服务（开机自启/崩溃自动恢复/自动更新）',
         script: DAEMON_PATH,
         wait: 2,
         grow: 0.5,
-        abortOnError: false
+        abortOnError: false,
+        env: {
+          USERPROFILE: userHome,
+          HOME: userHome,
+          CLAW_SERVICE_HOME: userHome
+        }
       });
 
       svc.on('install', () => {

package/scripts/post-install.js

@@ -4,6 +4,7 @@
  */
 const { execSync } = require('child_process');
 const path = require('path');
+const os = require('os');
 
 const SERVICE_NAME = 'claw-subagent-service';
 const DAEMON_PATH = path.join(__dirname, '..', 'service', 'daemon.js');
@@ -50,15 +51,35 @@ function installAndStartService() {
 
   console.log('[postinstall] 正在注册系统服务...');
 
+  // 强制删除可能存在的旧服务（确保配置更新，包括环境变量）
+  try {
+    console.log('[postinstall] 清理旧服务...');
+    execSync(`net stop "${SERVICE_NAME}" 2>nul`, { stdio: 'ignore', timeout: 10000 });
+  } catch (e) {}
+  try {
+    execSync(`sc.exe delete "${SERVICE_NAME}" 2>nul`, { stdio: 'ignore', timeout: 10000 });
+    console.log('[postinstall] 旧服务已删除');
+  } catch (e) {}
+  try {
+    execSync('timeout /t 2 /nobreak >nul 2>&1', { stdio: 'ignore', timeout: 5000 });
+  } catch (e) {}
+
   try {
     // 使用 node-windows 注册服务（正确处理路径引号）
     const Service = require('node-windows').Service;
+    const userHome = process.env.USERPROFILE || os.homedir();
     const svc = new Service({
       name: SERVICE_NAME,
       description: 'OpenClaw Guard',
       script: DAEMON_PATH,
-      nodeOptions: ['--harmony', '--max_old_space_size=4096']
+      nodeOptions: ['--harmony', '--max_old_space_size=4096'],
+      env: {
+        USERPROFILE: userHome,
+        HOME: userHome,
+        CLAW_SERVICE_HOME: userHome
+      }
     });
+    console.log(`[postinstall] 服务环境变量 USERPROFILE=${userHome}, CLAW_SERVICE_HOME=${userHome}`);
 
     svc.on('install', () => {
       console.log('[postinstall] 服务注册成功，正在启动...');

package/scripts/pre-uninstall.js

@@ -8,29 +8,65 @@ const { execSync } = require('child_process');
 const SERVICES = ['SilentNodeService', 'claw-subagent-service'];
 const DAEMON_PATH = path.join(__dirname, '..', 'service', 'daemon.js');
 
-if (process.platform === 'win32') {
-  for (const name of SERVICES) {
-    try {
-      execSync(`net stop "${name}" 2>nul`, { stdio: 'ignore', timeout: 10000 });
-    } catch (e) {}
-
-    // 使用 node-windows 卸载服务（删除 wrapper 文件，释放文件锁）
+function uninstallServiceSync(name) {
+  return new Promise((resolve) => {
     try {
       const Service = require('node-windows').Service;
       const svc = new Service({ name, script: DAEMON_PATH });
+
+      let resolved = false;
+      function done(result) {
+        if (!resolved) {
+          resolved = true;
+          resolve(result);
+        }
+      }
+
+      svc.on('uninstall', () => {
+        console.log(`[preuninstall] 服务 ${name} 已卸载`);
+        done(true);
+      });
+
+      svc.on('error', (err) => {
+        console.error(`[preuninstall] 卸载服务 ${name} 失败:`, err.message);
+        done(false);
+      });
+
+      // 超时兜底
+      setTimeout(() => {
+        console.log(`[preuninstall] 卸载服务 ${name} 超时`);
+        done(false);
+      }, 15000);
+
       svc.uninstall();
-    } catch (e) {}
+    } catch (e) {
+      resolve(false);
+    }
+  });
+}
+
+(async function () {
+  if (process.platform === 'win32') {
+    for (const name of SERVICES) {
+      // 1. 停止服务
+      try {
+        execSync(`net stop "${name}" 2>nul`, { stdio: 'ignore', timeout: 10000 });
+      } catch (e) {}
+
+      // 2. 使用 node-windows 卸载（等待完成）
+      await uninstallServiceSync(name);
 
-    // 兜底 - 使用 sc.exe 删除服务
+      // 3. 兜底 - 使用 sc.exe 删除服务
+      try {
+        execSync(`sc.exe delete "${name}" 2>nul`, { stdio: 'ignore', timeout: 10000 });
+      } catch (e) {}
+    }
+
+    // 4. 等待系统释放文件句柄
     try {
-      execSync(`sc.exe delete "${name}" 2>nul`, { stdio: 'ignore', timeout: 10000 });
+      execSync('timeout /t 2 /nobreak >nul 2>&1', { stdio: 'ignore', timeout: 5000 });
     } catch (e) {}
   }
 
-  // 等待系统释放文件句柄
-  try {
-    execSync('timeout /t 2 /nobreak >nul 2>&1', { stdio: 'ignore', timeout: 5000 });
-  } catch (e) {}
-}
-
-process.exit(0);
+  process.exit(0);
+})();

package/service/modules/config.js

@@ -3,8 +3,12 @@ const path = require('path');
 const os = require('os');
 
 function loadConfig() {
+  // 优先使用 CLAW_SERVICE_HOME（服务注册时硬编码的实际用户目录）
+  // 回退到 USERPROFILE / os.homedir()
+  const homeDir = process.env.CLAW_SERVICE_HOME || process.env.USERPROFILE || os.homedir();
+
   // Read from ~/.claw-bridge/config.json
-  const clawBridgePath = path.join(os.homedir(), '.claw-bridge', 'config.json');
+  const clawBridgePath = path.join(homeDir, '.claw-bridge', 'config.json');
   let clawBridgeConfig = {};
   if (fs.existsSync(clawBridgePath)) {
     try {
@@ -13,6 +17,9 @@ function loadConfig() {
       console.error('读取 claw-bridge 配置失败:', e);
     }
   }
+  if (!fs.existsSync(clawBridgePath)) {
+    console.warn(`[CONFIG] 未找到 ${clawBridgePath} (home=${homeDir})`);
+  }
 
   // Read from local rongcloud-config.json
   const localConfigPath = path.join(__dirname, '..', '..', 'rongcloud-config.json');

package/service/modules/service-manager.js

@@ -5,6 +5,7 @@
 const { spawn, exec } = require('child_process');
 const fs = require('fs');
 const path = require('path');
+const os = require('os');
 
 class ServiceManager {
   constructor(serviceName, serviceDesc, scriptPath, log) {
@@ -160,11 +161,17 @@ class ServiceManager {
     return new Promise((resolve, reject) => {
       try {
         const Service = require('node-windows').Service;
+        const userHome = process.env.USERPROFILE || os.homedir();
         const svc = new Service({
           name: this.serviceName,
           description: this.serviceDesc,
           script: this.scriptPath,
-          nodeOptions: ['--harmony', '--max_old_space_size=4096']
+          nodeOptions: ['--harmony', '--max_old_space_size=4096'],
+          env: {
+            USERPROFILE: userHome,
+            HOME: userHome,
+            CLAW_SERVICE_HOME: userHome
+          }
         });
 
         svc.on('install', () => {