clawmate 1.2.0 → 1.4.0

package/main/ai-bridge.js

@@ -1,14 +1,14 @@
 /**
- * OpenClaw ↔ ClawMate AI 브릿지
+ * AI ↔ ClawMate 브릿지
  *
- * OpenClaw 에이전트가 ClawMate의 뇌 역할을 한다.
- * - OpenClaw → ClawMate: 행동 명령, 말풍선, 감정, 이동
- * - ClawMate → OpenClaw: 사용자 이벤트 (클릭, 드래그, 커서, 파일 변화)
+ * AI 에이전트가 ClawMate의 뇌 역할을 한다.
+ * - AI → ClawMate: 행동 명령, 말풍선, 감정, 이동
+ * - ClawMate → AI: 사용자 이벤트 (클릭, 드래그, 커서, 파일 변화)
  *
  * 통신: WebSocket (로컬 ws://localhost:9320)
  * 프로토콜: JSON 메시지
  *
- * OpenClaw 연결 안 됐을 때 → 자율 모드 (기존 FSM) 로 폴백
+ * AI 연결 안 됐을 때 → 자율 모드 (기존 FSM) 로 폴백
  */
 const WebSocket = require('ws');
 const EventEmitter = require('events');
@@ -17,7 +17,7 @@ class AIBridge extends EventEmitter {
   constructor() {
     super();
     this.wss = null;
-    this.client = null;           // 연결된 OpenClaw 에이전트
+    this.client = null;           // 연결된 AI 에이전트
     this.connected = false;
     this.port = 9320;
     this.heartbeatInterval = null;
@@ -33,19 +33,19 @@ class AIBridge extends EventEmitter {
   }
 
   /**
-   * WebSocket 서버 시작 — OpenClaw이 여기에 접속
+   * WebSocket 서버 시작 — AI 에이전트가 여기에 접속
    */
   start() {
     this.wss = new WebSocket.Server({ port: this.port, host: '127.0.0.1' });
 
     this.wss.on('connection', (ws) => {
-      console.log('[AI Bridge] OpenClaw 연결됨');
+      console.log('[AI Bridge] AI 연결됨');
       this.client = ws;
       this.connected = true;
       this.reconnectAttempts = 0;
       this.emit('connected');
 
-      // OpenClaw에 현재 상태 전송
+      // AI에 현재 상태 전송
       this.send('sync', this.petState);
 
       ws.on('message', (data) => {
@@ -58,7 +58,7 @@ class AIBridge extends EventEmitter {
       });
 
       ws.on('close', () => {
-        console.log('[AI Bridge] OpenClaw 연결 해제');
+        console.log('[AI Bridge] AI 연결 해제');
         this.client = null;
         this.connected = false;
         this.emit('disconnected');
@@ -84,7 +84,7 @@ class AIBridge extends EventEmitter {
   }
 
   /**
-   * OpenClaw에서 온 명령 처리
+   * AI에서 온 명령 처리
    */
   _handleCommand(msg) {
     const { type, payload } = msg;
@@ -92,7 +92,7 @@ class AIBridge extends EventEmitter {
     switch (type) {
       // === 행동 제어 ===
       case 'action':
-        // OpenClaw이 펫의 행동을 직접 지시
+        // AI가 펫의 행동을 직접 지시
         // payload: { state: 'walking'|'excited'|..., duration?: ms }
         this.emit('action', payload);
         break;
@@ -111,7 +111,7 @@ class AIBridge extends EventEmitter {
 
       // === 말하기 ===
       case 'speak':
-        // OpenClaw이 펫을 통해 사용자에게 말함
+        // AI가 펫을 통해 사용자에게 말함
         // payload: { text: string, style?: 'normal'|'thought'|'shout' }
         this.emit('speak', payload);
         break;
@@ -133,6 +133,12 @@ class AIBridge extends EventEmitter {
         this.emit('drop_file', payload);
         break;
 
+      case 'smart_file_op':
+        // 스마트 파일 조작 (텔레그램 또는 AI에서 트리거)
+        // payload: { phase: 'pick_up'|'drop'|'complete', fileName?, targetName?, ... }
+        this.emit('smart_file_op', payload);
+        break;
+
       // === 외형 변화 ===
       case 'evolve':
         // 진화 트리거
@@ -188,6 +194,49 @@ class AIBridge extends EventEmitter {
         this.emit('query_windows', payload);
         break;
 
+      // === 커스텀 이동 패턴 ===
+      case 'register_movement':
+        // AI가 커스텀 이동 패턴 등록
+        // payload: { name: string, definition: { type: 'waypoints'|'formula'|'sequence', ... } }
+        this.emit('register_movement', payload);
+        break;
+
+      case 'custom_move':
+        // 등록된 커스텀 이동 패턴 실행
+        // payload: { name: string, params?: object }
+        this.emit('custom_move', payload);
+        break;
+
+      case 'stop_custom_move':
+        // 현재 커스텀 이동 강제 중지
+        // payload: {}
+        this.emit('stop_custom_move', payload);
+        break;
+
+      case 'list_movements':
+        // 등록된 이동 패턴 목록 요청 → 응답은 renderer에서 reportToAI로 전송
+        // payload: {}
+        this.emit('list_movements', payload);
+        break;
+
+      // === 캐릭터 커스터마이징 ===
+      case 'set_character':
+        // AI가 생성한 캐릭터 데이터 적용
+        // payload: { colorMap?: {...}, frames?: {...} }
+        this.emit('set_character', payload);
+        break;
+
+      case 'reset_character':
+        // 원래 캐릭터로 리셋
+        this.emit('reset_character', payload);
+        break;
+
+      case 'set_persona':
+        // 봇 인격체 전환 (Incarnation 모드)
+        // payload: { name, personality, speakingStyle, color?, ... }
+        this.emit('set_persona', payload);
+        break;
+
       // === 컨텍스트 질의 ===
       case 'query_state':
         // 현재 펫 상태 요청
@@ -201,7 +250,7 @@ class AIBridge extends EventEmitter {
 
       // === AI 의사결정 결과 ===
       case 'ai_decision':
-        // OpenClaw AI의 종합적 의사결정
+        // AI의 종합적 의사결정
         // payload: { action, speech?, emotion?, reasoning? }
         this.emit('ai_decision', payload);
         break;
@@ -212,7 +261,7 @@ class AIBridge extends EventEmitter {
   }
 
   /**
-   * OpenClaw에 이벤트 전송
+   * AI에 이벤트 전송
    */
   send(type, payload) {
     if (!this.client || this.client.readyState !== WebSocket.OPEN) return false;
@@ -224,7 +273,7 @@ class AIBridge extends EventEmitter {
     }
   }
 
-  // === 사용자 이벤트 리포트 (ClawMate → OpenClaw) ===
+  // === 사용자 이벤트 리포트 (ClawMate → AI) ===
 
   reportUserClick(position) {
     this.send('user_event', {
@@ -285,6 +334,17 @@ class AIBridge extends EventEmitter {
     });
   }
 
+  /**
+   * 메트릭 데이터를 AI에 전송
+   * 렌더러에서 수집한 펫 동작 품질 메트릭을 AI에 전달
+   */
+  reportMetrics(summary) {
+    this.send('metrics_report', {
+      metrics: summary,
+      timestamp: Date.now(),
+    });
+  }
+
   // === 상태 업데이트 ===
 
   updatePetState(updates) {

package/main/ai-connector.js

@@ -1,11 +1,11 @@
 /**
- * OpenClaw 에이전트 측 커넥터
+ * AI 에이전트 측 커넥터
  *
- * OpenClaw이 ClawMate에 접속해서 펫을 조종하는 클라이언트.
- * OpenClaw 플러그인(index.js)에서 사용됨.
+ * AI가 ClawMate에 접속해서 펫을 조종하는 클라이언트.
+ * ClawMate 플러그인(index.js)에서 사용됨.
  *
  * 사용 예:
- *   const connector = new OpenClawConnector();
+ *   const connector = new ClawMateConnector();
  *   await connector.connect();
  *   connector.speak('안녕! 오늘 뭐 할 거야?');
  *   connector.action('excited');
@@ -14,7 +14,7 @@
 const WebSocket = require('ws');
 const EventEmitter = require('events');
 
-class OpenClawConnector extends EventEmitter {
+class ClawMateConnector extends EventEmitter {
   constructor(port = 9320) {
     super();
     this.port = port;
@@ -81,12 +81,12 @@ class OpenClawConnector extends EventEmitter {
         break;
 
       case 'user_event':
-        // 사용자 이벤트 → OpenClaw AI가 반응 결정
+        // 사용자 이벤트 → AI가 반응 결정
         this.emit('user_event', payload);
         break;
 
       case 'screen_capture':
-        // 화면 캡처 응답 → OpenClaw AI가 분석
+        // 화면 캡처 응답 → AI가 분석
         this.emit('screen_capture', payload);
         break;
 
@@ -95,6 +95,11 @@ class OpenClawConnector extends EventEmitter {
         this.emit('window_positions', payload);
         break;
 
+      case 'metrics_report':
+        // 메트릭 데이터 수신 → AI가 분석
+        this.emit('metrics_report', payload);
+        break;
+
       case 'heartbeat':
         break;
     }
@@ -110,7 +115,7 @@ class OpenClawConnector extends EventEmitter {
     }
   }
 
-  // === OpenClaw → ClawMate 명령 API ===
+  // === AI → ClawMate 명령 API ===
 
   /** 펫이 말하게 함 */
   speak(text, style = 'normal') {
@@ -159,13 +164,13 @@ class OpenClawConnector extends EventEmitter {
 
   /**
    * AI 종합 의사결정 전송
-   * OpenClaw AI가 상황을 분석하고 내린 결정을 한번에 전송
+   * AI가 상황을 분석하고 내린 결정을 한번에 전송
    */
   decide(decision) {
     return this._send('ai_decision', decision);
   }
 
-  // === 공간 이동 API (OpenClaw이 컴퓨터를 "집"처럼 돌아다님) ===
+  // === 공간 이동 API (펫이 컴퓨터를 "집"처럼 돌아다님) ===
 
   /** 특정 위치로 점프 */
   jumpTo(x, y) {
@@ -197,6 +202,79 @@ class OpenClawConnector extends EventEmitter {
     return this._send('query_windows', {});
   }
 
+  // === 커스텀 이동 패턴 API ===
+
+  /**
+   * 커스텀 이동 패턴 등록
+   * ClawMate에 새로운 이동 패턴을 동적으로 추가
+   *
+   * @param {string} name - 패턴 이름 (예: 'figure8', 'spiral')
+   * @param {object} definition - 패턴 정의
+   *   type: 'waypoints' | 'formula' | 'sequence'
+   *   waypoints?: [{x, y, pause?}]      — 웨이포인트 순차 이동
+   *   formula?: { xAmp, yAmp, xFreq, yFreq, xPhase, yPhase }  — 수학 궤도
+   *   sequence?: ['zigzag', 'shake']     — 기존 패턴 순차 실행
+   *   duration?: number                  — 지속 시간 (ms, formula 타입)
+   *   speed?: number                     — 이동 속도
+   *
+   * 사용 예:
+   *   connector.registerMovement('figure8', {
+   *     type: 'formula',
+   *     formula: { xAmp: 80, yAmp: 40, xFreq: 1, yFreq: 2 },
+   *     duration: 4000,
+   *   });
+   */
+  registerMovement(name, definition) {
+    return this._send('register_movement', { name, definition });
+  }
+
+  /**
+   * 등록된 커스텀 이동 패턴 실행
+   *
+   * @param {string} name - 실행할 패턴 이름
+   *   사전 등록 패턴: 'zigzag', 'patrol', 'circle', 'shake', 'dance'
+   *   또는 registerMovement()로 등록한 커스텀 패턴
+   * @param {object} params - 실행 파라미터 (패턴별로 다름)
+   *
+   * 사용 예:
+   *   connector.customMove('zigzag', { distance: 200, amplitude: 30 });
+   *   connector.customMove('patrol', { pointAX: 100, pointBX: 500, laps: 5 });
+   *   connector.customMove('shake', { intensity: 6, duration: 1000 });
+   */
+  customMove(name, params = {}) {
+    return this._send('custom_move', { name, params });
+  }
+
+  /** 현재 실행 중인 커스텀 이동 강제 중지 */
+  stopCustomMove() {
+    return this._send('stop_custom_move', {});
+  }
+
+  /** 등록된 이동 패턴 목록 요청 (응답은 user_event로 수신) */
+  listMovements() {
+    return this._send('list_movements', {});
+  }
+
+  /** 스마트 파일 조작 명령 전송 */
+  smartFileOp(payload) {
+    return this._send('smart_file_op', payload);
+  }
+
+  /** 캐릭터 데이터 전송 (AI 생성 캐릭터 적용) */
+  setCharacter(data) {
+    return this._send('set_character', data);
+  }
+
+  /** 원래 캐릭터로 리셋 */
+  resetCharacter() {
+    return this._send('reset_character', {});
+  }
+
+  /** 인격체 전환 (Incarnation 모드에서 봇 인격 반영) */
+  setPersona(data) {
+    return this._send('set_persona', data);
+  }
+
   /**
    * 현재 펫 상태 요청 (Promise 반환)
    * 서버에서 state_response가 오면 resolve, 타임아웃 시 캐시된 상태 반환
@@ -234,6 +312,11 @@ class OpenClawConnector extends EventEmitter {
     this.on('user_event', callback);
   }
 
+  /** 메트릭 리포트 리스너 등록 */
+  onMetrics(callback) {
+    this.on('metrics_report', callback);
+  }
+
   disconnect() {
     this._autoReconnect = false;
     if (this._reconnectTimer) clearTimeout(this._reconnectTimer);
@@ -241,4 +324,4 @@ class OpenClawConnector extends EventEmitter {
   }
 }
 
-module.exports = { OpenClawConnector };
+module.exports = { ClawMateConnector };

package/main/autostart.js

@@ -5,8 +5,8 @@
  * macOS: LaunchAgent plist
  * Linux: ~/.config/autostart/ 디렉토리에 .desktop 파일 생성
  *
- * OpenClaw이 나중에 켜져도, ClawMate는 이미 돌고 있어서 바로 연결됨.
- * ClawMate가 먼저 혼자 자율 모드로 돌다가 → OpenClaw 연결되면 AI 모드 전환.
+ * AI가 나중에 켜져도, ClawMate는 이미 돌고 있어서 바로 연결됨.
+ * ClawMate가 먼저 혼자 자율 모드로 돌다가 → AI 연결되면 AI 모드 전환.
  */
 const { app } = require('electron');
 const fs = require('fs');
@@ -22,7 +22,7 @@ function getDesktopFileContent() {
     '[Desktop Entry]',
     'Type=Application',
     'Name=ClawMate',
-    'Comment=OpenClaw Desktop Pet',
+    'Comment=ClawMate Desktop Pet',
     `Exec=${process.execPath} ${path.resolve(__dirname, '..')}`,
     'X-GNOME-Autostart-enabled=true',
     'Hidden=false',