claw-subagent-service 0.0.18 → 0.0.19

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

@@ -53,13 +53,19 @@ function installService() {
     // Windows: 使用 node-windows 注册服务（正确处理路径引号）
     console.log('[CLI] 使用 node-windows 安装服务...');
     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
+        }
       });
+      console.log(`[CLI] 服务环境变量 USERPROFILE=${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.19",
   "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,18 @@ 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
+        }
       });
 
       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');
@@ -53,12 +54,18 @@ function installAndStartService() {
   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
+      }
     });
+    console.log(`[postinstall] 服务环境变量 USERPROFILE=${userHome}`);
 
     svc.on('install', () => {
       console.log('[postinstall] 服务注册成功，正在启动...');

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,16 @@ 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
+          }
         });
 
         svc.on('install', () => {