claw-subagent-service 0.0.0

package/service/modules/heartbeat-dashboard.js

@@ -0,0 +1,153 @@
+const { RongyunMessageTypeEnum } = require('./rongyun-message-types');
+const { collectDashboardData } = require('./dashboard-collector');
+const { RongyunMessageSender } = require('./rongyun-message-sender');
+
+class HeartbeatManager {
+  constructor(rongcloudClient, config, log) {
+    this.rongcloudClient = rongcloudClient;
+    this.config = config;
+    this.log = log;
+    this.timer = null;
+    this.messageSender = new RongyunMessageSender(rongcloudClient, config, log);
+  }
+
+  start(getMacAddress, getOpenClawStatus) {
+    const interval = (this.config.heartbeatInterval || 20) * 1000;
+    this.log?.info(`[HeartbeatManager] 启动心跳定时器，间隔: ${interval}ms`);
+    
+    this.timer = setInterval(async () => {
+      if (!this.rongcloudClient?.isConnected) return;
+      
+      try {
+        const mac = getMacAddress();
+        const status = await getOpenClawStatus(this.config.openclawPort || 18789);
+        const sent = await this.messageSender.sendProtocolMessage(
+          RongyunMessageTypeEnum.HEARTBEAT,
+          {
+            mac_address: mac,
+            nickname: this.config.nodeName,
+            open_claw_status: status,
+            client_status: 1,
+          }
+        );
+        if (sent) {
+          this.log?.info('[HeartbeatManager] 心跳已发送');
+        } else {
+          this.log?.warn('[HeartbeatManager] 心跳发送失败');
+        }
+      } catch (err) {
+        this.log?.error(`[HeartbeatManager] 心跳发送异常: ${err.message}`);
+      }
+    }, interval);
+  }
+
+  stop() {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+      this.log?.info('[HeartbeatManager] 心跳定时器已停止');
+    }
+  }
+}
+
+class DashboardReporter {
+  constructor(rongcloudClient, config, log) {
+    this.rongcloudClient = rongcloudClient;
+    this.config = config;
+    this.log = log;
+    this.timer = null;
+    this.messageSender = new RongyunMessageSender(rongcloudClient, config, log);
+  }
+
+  start(getMacAddress) {
+    const interval = 30000; // 30秒
+    this.log?.info(`[DashboardReporter] 启动仪表盘上报定时器，间隔: ${interval}ms`);
+    
+    this.timer = setInterval(async () => {
+      if (!this.rongcloudClient?.isConnected) return;
+      
+      try {
+        const data = await collectDashboardData();
+        const timestamp = data.diagnostics?.generatedAt || new Date().toISOString();
+        const mac = getMacAddress();
+        
+        // 拆分为 6 条消息发送
+        await this.sendChunk(RongyunMessageTypeEnum.DASHBOARD_SESSIONS, {
+          mac_address: mac,
+          sessions: data.sessions,
+          sessionStatuses: data.sessionStatuses,
+          timestamp,
+        }, 1000);
+        
+        await this.sendChunk(RongyunMessageTypeEnum.DASHBOARD_JOBS, {
+          mac_address: mac,
+          cronJobs: data.cronJobs,
+          approvals: data.approvals,
+          timestamp,
+        }, 1000);
+        
+        await this.sendChunk(RongyunMessageTypeEnum.DASHBOARD_PROJECTS, {
+          mac_address: mac,
+          projects: data.projects,
+          tasks: data.tasks,
+          timestamp,
+        }, 1000);
+        
+        await this.sendChunk(RongyunMessageTypeEnum.DASHBOARD_SUMMARIES, {
+          mac_address: mac,
+          projectSummaries: data.projectSummaries,
+          tasksSummary: data.tasksSummary,
+          budgetSummary: data.budgetSummary,
+          diagnostics: data.diagnostics,
+          timestamp,
+        }, 1000);
+        
+        await this.sendChunk(RongyunMessageTypeEnum.DASHBOARD_SESSIONS_CONTEXTS, {
+          mac_address: mac,
+          sessionsContexts: (data.sessionsContexts || []).slice(0, 50),
+          timestamp,
+        }, 1000);
+        
+        await this.sendChunk(RongyunMessageTypeEnum.DASHBOARD_USAGE_EVENTS, {
+          mac_address: mac,
+          usageEvents: (data.usageEvents || []).slice(-100),
+          timestamp,
+        }, 0);
+        
+        this.log?.info('[DashboardReporter] 所有数据块发送完成');
+      } catch (err) {
+        this.log?.error(`[DashboardReporter] 上报异常: ${err.message}`);
+      }
+    }, interval);
+  }
+
+  async sendChunk(msgType, data, delayMs) {
+    try {
+      const sent = await this.messageSender.sendProtocolMessage(msgType, data);
+      if (sent) {
+        this.log?.info(`[DashboardReporter] ${msgType} 发送成功`);
+      } else {
+        this.log?.warn(`[DashboardReporter] ${msgType} 发送失败`);
+      }
+    } catch (err) {
+      this.log?.error(`[DashboardReporter] ${msgType} 发送异常: ${err.message}`);
+    }
+    
+    if (delayMs > 0) {
+      await new Promise(resolve => setTimeout(resolve, delayMs));
+    }
+  }
+
+  stop() {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+      this.log?.info('[DashboardReporter] 仪表盘上报定时器已停止');
+    }
+  }
+}
+
+module.exports = {
+  HeartbeatManager,
+  DashboardReporter
+};

package/service/modules/mac-address.js

@@ -0,0 +1,15 @@
+const os = require('os');
+
+function getMacAddress() {
+  const interfaces = os.networkInterfaces();
+  for (const name of Object.keys(interfaces)) {
+    for (const iface of interfaces[name]) {
+      if (iface.family === 'IPv4' && !iface.internal) {
+        return iface.mac.replace(/:/g, '').toLowerCase();
+      }
+    }
+  }
+  return 'unknown';
+}
+
+module.exports = { getMacAddress };

package/service/modules/message-processor-example.js

@@ -0,0 +1,72 @@
+/**
+ * 完整消息处理示例 - 展示如何接收 rongcloud 转发的消息
+ */
+
+const { MessageProcessor } = require('./modules/message-processor');
+
+// ========== 使用示例 ==========
+
+// 1. 创建消息处理器
+const messageProcessor = new MessageProcessor(config, rongcloudClient, log);
+
+// 2. 连接融云，传入处理器
+// rongcloud-client.js 第42-43行会保存这个 handler
+// rongcloud-client.js 第161-164行会调用 handler.handleMessage(msg)
+await rongcloudClient.connect(messageProcessor);
+
+// ========== 消息接收流程 ==========
+
+/**
+ * 消息接收流程：
+ * 
+ * 1. 融云SDK收到消息
+ *    ↓
+ * 2. rongcloud-client.js 的 handleReceivedMessage() 被调用
+ *    位置：rongcloud-client.js 第115行
+ *    ↓
+ * 3. 检查是否是结构化消息（有 msg_type 字段）
+ *    位置：rongcloud-client.js 第131-138行
+ *    - 如果是结构化消息且 msg_type 在 SYSTEM_MSG_TYPES 中 → 直接 return，不转发
+ *    - 如果是普通消息 → 继续处理
+ *    ↓
+ * 4. 构建 rongCloudMsg 对象
+ *    位置：rongcloud-client.js 第150-159行
+ *    ↓
+ * 5. 调用 handler.handleMessage(rongCloudMsg)
+ *    位置：rongcloud-client.js 第163行
+ *    ↓
+ * 6. MessageProcessor.handleMessage(msg) 被调用
+ *    位置：modules/message-processor.js
+ */
+
+// ========== handleMessage 方法签名 ==========
+
+/**
+ * handleMessage(msg) 接收的消息格式：
+ * 
+ * @param {Object} msg
+ * @param {string} msg.senderUserId - 发送者用户ID
+ * @param {string} msg.targetId - 目标用户ID（群聊时为群ID）
+ * @param {number} msg.conversationType - 会话类型：1=私聊，3=群聊
+ * @param {string} msg.content - 消息文本内容
+ * @param {string} msg.messageType - 融云消息类型，如 'RC:TxtMsg'
+ * @param {boolean} msg.isOffLineMessage - 是否为离线消息
+ * @param {string} msg.messageUId - 消息唯一ID
+ * @param {number} msg.sentTime - 消息发送时间戳
+ */
+
+// ========== 示例：自定义消息处理 ==========
+
+class CustomMessageProcessor extends MessageProcessor {
+  async handleNormalMessage(msg) {
+    // 自定义处理逻辑
+    this.log?.info(`[CustomMessageProcessor] 收到消息: ${msg.content}`);
+    
+    // 例如：简单的 echo 回复
+    await this.sendReply(msg, `收到: ${msg.content}`);
+  }
+}
+
+// 使用自定义处理器
+const customProcessor = new CustomMessageProcessor(config, rongcloudClient, log);
+await rongcloudClient.connect(customProcessor);

package/service/modules/message-processor.js

@@ -0,0 +1,62 @@
+/**
+ * 消息处理器 - 接收 rongcloud 转发的消息
+ * 
+ * rongcloud-client.js 会将消息转发到 handler.handleMessage(msg) 方法
+ * 位置：rongcloud-client.js 第161-164行
+ * 
+ * 注意：rongcloud-client.js 第131-138行会过滤掉结构化消息（msg_type 在 SYSTEM_MSG_TYPES 中的）
+ * 所以此方法只能收到普通消息（AI聊天等）
+ */
+class MessageProcessor {
+  constructor(config, rongcloudClient, log) {
+    this.config = config;
+    this.rongcloudClient = rongcloudClient;
+    this.log = log;
+  }
+
+  /**
+   * 接收 rongcloud 转发的普通消息
+   * 被调用位置：rongcloud-client.js 第163行
+   * 
+   * @param {Object} msg - 消息对象
+   * @param {string} msg.senderUserId - 发送者ID
+   * @param {string} msg.targetId - 目标ID
+   * @param {number} msg.conversationType - 会话类型 (1=私聊, 3=群聊)
+   * @param {string} msg.content - 消息内容
+   * @param {string} msg.messageType - 消息类型 (如 'RC:TxtMsg')
+   * @param {boolean} msg.isOffLineMessage - 是否离线消息
+   */
+  async handleMessage(msg) {
+    this.log?.info(`[MessageProcessor] 收到普通消息 from=${msg.senderUserId}, content=${msg.content?.substring(0, 50)}`);
+    
+    try {
+      // 处理普通消息（AI聊天等）
+      await this.handleNormalMessage(msg);
+    } catch (err) {
+      this.log?.error(`[MessageProcessor] 处理消息异常: ${err.message}`);
+      // 发送错误回复
+      await this.sendReply(msg, `处理失败: ${err.message}`);
+    }
+  }
+
+  // 处理普通消息
+  async handleNormalMessage(msg) {
+    // TODO: 实现普通消息处理逻辑（AI聊天等）
+    this.log?.info('[MessageProcessor] 处理普通消息');
+  }
+
+  // 发送回复
+  async sendReply(msg, content) {
+    try {
+      await this.rongcloudClient.sendMessage(
+        msg.senderUserId,
+        content,
+        msg.conversationType
+      );
+    } catch (err) {
+      this.log?.error(`[MessageProcessor] 发送回复失败: ${err.message}`);
+    }
+  }
+}
+
+module.exports = { MessageProcessor };

package/service/modules/normal-message-handler.js

@@ -0,0 +1,60 @@
+/**
+ * 普通消息处理器 - 接收 rongcloud 转发的普通消息并调用 AI 服务
+ * 
+ * 被调用位置：rongcloud/message-handler.js 第68行
+ * 调用方式：await this.handleNormalMessage(msg)
+ * 
+ * @param {Object} msg - 消息对象
+ * @param {string} msg.content - 消息内容
+ * @param {string} msg.senderUserId - 发送者ID
+ * @param {string} msg.targetId - 目标ID
+ * @param {number} msg.conversationType - 会话类型 (1=私聊, 3=群聊)
+ * @returns {string} 回复内容
+ */
+const { forwardChatMessage } = require('./opencode-service');
+
+async function handleNormalMessage(msg) {
+  console.log(`[NormalMessageHandler] 收到普通消息:`, {
+    from: msg.senderUserId,
+    content: msg.content?.substring(0, 50),
+    type: msg.conversationType === 1 ? '私聊' : '群聊'
+  });
+
+  try {
+    // 使用 senderUserId 作为 session ID，确保每个用户有独立的会话
+    const sessionId = msg.senderUserId || 'default';
+    const content = msg.content;
+    
+    if (!content || !content.trim()) {
+      return '消息内容为空';
+    }
+
+    // 调用 opencode 服务进行 AI 聊天
+    let fullResponse = '';
+    
+    await forwardChatMessage(
+      sessionId,
+      content,
+      async (delta) => {
+        // 收集响应片段
+        fullResponse += delta;
+      },
+      (level, message) => {
+        // 日志回调
+        console.log(`[CHAT-${level}] ${message}`);
+      },
+      600000 // 10分钟超时
+    );
+
+    console.log(`[NormalMessageHandler] AI 回复: ${fullResponse.substring(0, 50)}...`);
+    return fullResponse;
+
+  } catch (err) {
+    console.error(`[NormalMessageHandler] 处理异常:`, err.message);
+    return `抱歉，处理消息时出错: ${err.message}`;
+  }
+}
+
+module.exports = {
+  handleNormalMessage
+};

package/service/modules/openclaw-control.js

@@ -0,0 +1,128 @@
+/**
+ * OpenClaw 控制模块 - 与桌面客户端对齐
+ * 
+ * 执行 start/stop/restart/status 命令
+ * 基于 nodejs_client/src/main/openclaw-control.ts
+ */
+const { spawn } = require('child_process');
+const path = require('path');
+const os = require('os');
+const { OpenClawCommandEnum, OpenClawServiceStatus, getServiceStatusMessage } = require('./openclaw-enum');
+const { ScriptExecutor } = require('./script-executor');
+const { getOpenClawStatus } = require('./port-checker');
+
+let globalExecutor = null;
+
+function getScriptDir() {
+  const system = process.platform;
+  const subDir = system === 'win32' ? path.join('command', 'win') : path.join('command', 'linux');
+  
+  // 在 CLI 环境中，脚本在 nodejs_cli_client/command 目录下
+  return path.join(__dirname, '..', '..', subDir);
+}
+
+function getExecutor() {
+  if (!globalExecutor) {
+    globalExecutor = new ScriptExecutor(
+      getScriptDir(),
+      'Success',
+      180
+    );
+  }
+  return globalExecutor;
+}
+
+function getScriptName(command) {
+  const system = process.platform;
+  const ext = system === 'win32' ? '.bat' : '.sh';
+  const names = {
+    [OpenClawCommandEnum.START]: 'start',
+    [OpenClawCommandEnum.STOP]: 'stop',
+    [OpenClawCommandEnum.RESTART]: 'restart',
+    [OpenClawCommandEnum.STATUS]: 'status'
+  };
+  return (names[command] || 'unknown') + ext;
+}
+
+function getCommandName(command) {
+  const names = {
+    [OpenClawCommandEnum.START]: '启动',
+    [OpenClawCommandEnum.STOP]: '停止',
+    [OpenClawCommandEnum.RESTART]: '重启',
+    [OpenClawCommandEnum.STATUS]: '状态检查'
+  };
+  return names[command] || '未知命令';
+}
+
+async function executeCommand(command, window, sendResponse) {
+  const cmdName = getCommandName(command);
+  console.log(`[OpenClawControl] ${cmdName} OpenClaw...`);
+
+  const executor = getExecutor();
+  const scriptName = getScriptName(command);
+
+  try {
+    const result = await executor.executeWithStatus(command, scriptName);
+
+    if (
+      result.status === OpenClawServiceStatus.START_SUCCESS ||
+      result.status === OpenClawServiceStatus.STOP_SUCCESS ||
+      result.status === OpenClawServiceStatus.RESTART_SUCCESS
+    ) {
+      console.log(`[OpenClawControl] ${cmdName} 成功: ${result.message}`);
+      // 延迟更新状态
+      setTimeout(async () => {
+        const portStatus = await getOpenClawStatus(18789);
+        console.log(`[OpenClawControl] 状态已更新: ${portStatus === 1 ? '运行中' : '未运行'}`);
+      }, 2000);
+    } else if (result.status === OpenClawServiceStatus.ERROR) {
+      console.log(`[OpenClawControl] ${cmdName} 失败: ${result.message}`);
+    } else if (result.status === OpenClawServiceStatus.NOT_INSTALL) {
+      console.log(`[OpenClawControl] ${cmdName}: OpenClaw未安装`);
+    } else {
+      console.log(`[OpenClawControl] ${cmdName} 状态: ${result.message}`);
+      setTimeout(async () => {
+        const portStatus = await getOpenClawStatus(18789);
+        console.log(`[OpenClawControl] 状态: ${portStatus}`);
+      }, 2000);
+    }
+
+    if (sendResponse) {
+      let httpStatus = 'success';
+      if (result.status === OpenClawServiceStatus.ERROR) httpStatus = 'error';
+      sendResponse({
+        type: 'command_result',
+        command,
+        status: httpStatus,
+        message: result.message,
+        service_status: result.status
+      });
+    }
+
+    return result;
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    console.log(`[OpenClawControl] ${cmdName} 执行异常: ${msg}`);
+    if (sendResponse) {
+      sendResponse({
+        type: 'command_result',
+        command,
+        status: 'error',
+        message: msg,
+        service_status: OpenClawServiceStatus.ERROR
+      });
+    }
+    return {
+      status: OpenClawServiceStatus.ERROR,
+      message: msg
+    };
+  }
+}
+
+module.exports = {
+  executeCommand,
+  getScriptName,
+  getCommandName,
+  getScriptDir,
+  getExecutor
+};

package/service/modules/openclaw-enum.js

@@ -0,0 +1,48 @@
+/**
+ * OpenClaw 命令枚举和服务状态
+ * 与桌面客户端对齐: nodejs_client/src/main/openclaw-enum.ts
+ */
+const OpenClawCommandEnum = {
+  START: 1,
+  STOP: 2,
+  RESTART: 3,
+  STATUS: 4,
+  CONFIG_FIX: 5
+};
+
+const OpenClawServiceStatus = {
+  RUNNING: 'running',
+  NOT_RUNNING: 'not_running',
+  START_SUCCESS: 'starting_success',
+  STOP_SUCCESS: 'stop_success',
+  RESTART_SUCCESS: 'restart_success',
+  CONFIG_FIX_SUCCESS: 'config_fix_success',
+  NOT_INSTALL: 'not_install',
+  ERROR: 'error'
+};
+
+const statusMessages = {
+  [OpenClawServiceStatus.RUNNING]: '服务运行中',
+  [OpenClawServiceStatus.NOT_RUNNING]: '服务未运行',
+  [OpenClawServiceStatus.START_SUCCESS]: '启动成功',
+  [OpenClawServiceStatus.STOP_SUCCESS]: '关闭服务成功',
+  [OpenClawServiceStatus.RESTART_SUCCESS]: '重启服务成功',
+  [OpenClawServiceStatus.CONFIG_FIX_SUCCESS]: '配置修复成功',
+  [OpenClawServiceStatus.ERROR]: '未知异常',
+  [OpenClawServiceStatus.NOT_INSTALL]: 'openclaw未安装'
+};
+
+function getServiceStatusMessage(status) {
+  return statusMessages[status] || '状态未知';
+}
+
+function isValidCommand(command) {
+  return Object.values(OpenClawCommandEnum).includes(command);
+}
+
+module.exports = {
+  OpenClawCommandEnum,
+  OpenClawServiceStatus,
+  getServiceStatusMessage,
+  isValidCommand
+};