clawmate 1.3.0 → 1.4.0

package/main/ipc-handlers.js

@@ -93,9 +93,9 @@ function registerIpcHandlers(getMainWindow, getAIBridge) {
     }
   });
 
-  // === OpenClaw AI 통신 ===
+  // === AI 통신 ===
 
-  // 사용자 이벤트를 AI Bridge로 전달 (렌더러 → main → OpenClaw)
+  // 사용자 이벤트를 AI Bridge로 전달 (렌더러 → main → AI)
   ipcMain.on('report-to-ai', (_, event, data) => {
     const bridge = getAIBridge();
     if (bridge && bridge.isConnected()) {
@@ -109,6 +109,9 @@ function registerIpcHandlers(getMainWindow, getAIBridge) {
         case 'cursor_near':
           bridge.reportCursorNear(data.distance, data.cursorPos);
           break;
+        case 'double_click':
+          bridge.send('user_event', { event: 'double_click', ...data });
+          break;
         case 'desktop_changed':
           bridge.reportDesktopChange(data.files);
           break;
@@ -139,7 +142,7 @@ function registerIpcHandlers(getMainWindow, getAIBridge) {
     return bridge ? bridge.isConnected() : false;
   });
 
-  // 메트릭 보고 (렌더러 → main → OpenClaw)
+  // 메트릭 보고 (렌더러 → main → AI)
   ipcMain.on('report-metrics', (_, summary) => {
     const bridge = getAIBridge();
     if (bridge && bridge.isConnected()) {

package/main/telegram.js

@@ -196,13 +196,46 @@ class TelegramBot extends EventEmitter {
         // 캐릭터 변경 명령 → AI 생성 요청
         await this._handleCharacterChange(chatId, command.concept);
         break;
+
+      case 'mode_change':
+        // 모드 변경 명령
+        this._sendToBridge('set_mode', { mode: command.mode });
+        const modeNames = { pet: 'Pet (Clawby)', incarnation: 'Incarnation (Claw)', both: '둘 다' };
+        await this.bot.sendMessage(chatId, `모드 변경: ${modeNames[command.mode] || command.mode}`);
+        break;
+
+      case 'preset_character': {
+        // 캐릭터 프리셋 선택
+        const presets = {
+          default: { name: '기본 Claw', colorMap: { primary: '#ff4f40', secondary: '#ff775f', dark: '#8B4513', eye: '#ffffff', pupil: '#111111', claw: '#ff4f40' } },
+          blue: { name: '파란 Claw', colorMap: { primary: '#4488ff', secondary: '#6699ff', dark: '#223388', eye: '#ffffff', pupil: '#111111', claw: '#4488ff' } },
+          green: { name: '초록 Claw', colorMap: { primary: '#44cc44', secondary: '#66dd66', dark: '#226622', eye: '#ffffff', pupil: '#111111', claw: '#44cc44' } },
+          purple: { name: '보라 Claw', colorMap: { primary: '#8844cc', secondary: '#aa66dd', dark: '#442266', eye: '#ffffff', pupil: '#111111', claw: '#8844cc' } },
+          gold: { name: '골드 Claw', colorMap: { primary: '#ffcc00', secondary: '#ffdd44', dark: '#886600', eye: '#ffffff', pupil: '#111111', claw: '#ffcc00' } },
+          pink: { name: '핑크 Claw', colorMap: { primary: '#ff69b4', secondary: '#ff8cc4', dark: '#8B3060', eye: '#ffffff', pupil: '#111111', claw: '#ff69b4' } },
+          cat: { name: '고양이', colorMap: { primary: '#ff9944', secondary: '#ffbb66', dark: '#663300', eye: '#88ff88', pupil: '#111111', claw: '#ff9944' } },
+          robot: { name: '로봇', colorMap: { primary: '#888888', secondary: '#aaaaaa', dark: '#444444', eye: '#66aaff', pupil: '#0044aa', claw: '#66aaff' } },
+          ghost: { name: '유령', colorMap: { primary: '#ccccff', secondary: '#eeeeff', dark: '#6666aa', eye: '#ff6666', pupil: '#cc0000', claw: '#ccccff' } },
+          dragon: { name: '드래곤', colorMap: { primary: '#cc2222', secondary: '#ff4444', dark: '#661111', eye: '#ffaa00', pupil: '#111111', claw: '#ffaa00' } },
+        };
+        const preset = presets[command.preset];
+        if (preset) {
+          if (command.preset === 'default') {
+            this._sendToBridge('reset_character', {});
+          } else {
+            this._sendToBridge('set_character', { colorMap: preset.colorMap, speech: `${preset.name}(으)로 변신!` });
+          }
+          await this.bot.sendMessage(chatId, `캐릭터 변경: ${preset.name}`);
+        }
+        break;
+      }
     }
   }
 
   /**
    * 캐릭터 변경 요청 처리
    *
-   * 컨셉 텍스트를 AI(OpenClaw 플러그인)에 전달하여
+   * 컨셉 텍스트를 AI에 전달하여
    * 색상 + 프레임 데이터를 생성하고 펫에 적용.
    *
    * AI가 없으면 컨셉에서 색상만 추출하여 기본 변환.
@@ -210,14 +243,14 @@ class TelegramBot extends EventEmitter {
   async _handleCharacterChange(chatId, concept) {
     await this.bot.sendMessage(chatId, `"${concept}" 캐릭터 생성 중...`);
 
-    // AI Bridge를 통해 OpenClaw 플러그인에 캐릭터 생성 요청
+    // AI Bridge를 통해 AI에 캐릭터 생성 요청
     this._sendToBridge('ai_decision', {
       speech: `${concept}(으)로 변신 준비 중...`,
       emotion: 'curious',
       action: 'excited',
     });
 
-    // user_event로 캐릭터 변경 요청 전달 (OpenClaw 플러그인이 AI로 생성)
+    // user_event로 캐릭터 변경 요청 전달 (AI가 생성)
     if (this.bridge) {
       this.bridge.send('user_event', {
         event: 'character_request',

package/main/tray.js

@@ -1,4 +1,4 @@
-const { Tray, Menu, nativeImage, app, shell } = require('electron');
+const { Tray, Menu, nativeImage, app, shell, dialog, clipboard } = require('electron');
 const path = require('path');
 const { execSync } = require('child_process');
 const Store = require('./store');
@@ -10,16 +10,6 @@ let aiBridge = null;
 
 /**
  * 16x16 Claw 픽셀아트 아이콘 생성
- * 캐릭터 idle 프레임을 축소한 형태
- *
- * 색상 코드:
- *   0 = 투명
- *   1 = #ff4f40 (빨강)
- *   2 = #ff775f (연빨강)
- *   3 = #3a0a0d (갈색 다리)
- *   4 = #ffffff (눈 흰자)
- *   5 = #000000 (눈동자)
- *   6 = #ff4f40 (집게)
  */
 const CLAW_ICON = [
   [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
@@ -41,44 +31,88 @@ const CLAW_ICON = [
 ];
 
 const COLOR_MAP = {
-  0: [0, 0, 0, 0],         // 투명
-  1: [255, 79, 64, 255],    // primary 빨강
-  2: [255, 119, 95, 255],   // secondary 연빨강
-  3: [58, 10, 13, 255],     // dark 갈색
-  4: [255, 255, 255, 255],  // eye 흰자
-  5: [0, 0, 0, 255],        // pupil 눈동자
-  6: [255, 79, 64, 255],    // claw 집게
+  0: [0, 0, 0, 0],
+  1: [255, 79, 64, 255],
+  2: [255, 119, 95, 255],
+  3: [58, 10, 13, 255],
+  4: [255, 255, 255, 255],
+  5: [0, 0, 0, 255],
+  6: [255, 79, 64, 255],
 };
 
 /**
- * CLAW_ICON 16x16 배열 → nativeImage 변환
+ * 캐릭터 프리셋 목록
+ * 트레이에서 선택하면 set_character 명령으로 렌더러에 전달
  */
+const CHARACTER_PRESETS = {
+  default: {
+    name: '기본 Claw (빨강)',
+    colorMap: { primary: '#ff4f40', secondary: '#ff775f', dark: '#8B4513', eye: '#ffffff', pupil: '#111111', claw: '#ff4f40' },
+  },
+  blue: {
+    name: '파란 Claw',
+    colorMap: { primary: '#4488ff', secondary: '#6699ff', dark: '#223388', eye: '#ffffff', pupil: '#111111', claw: '#4488ff' },
+  },
+  green: {
+    name: '초록 Claw',
+    colorMap: { primary: '#44cc44', secondary: '#66dd66', dark: '#226622', eye: '#ffffff', pupil: '#111111', claw: '#44cc44' },
+  },
+  purple: {
+    name: '보라 Claw',
+    colorMap: { primary: '#8844cc', secondary: '#aa66dd', dark: '#442266', eye: '#ffffff', pupil: '#111111', claw: '#8844cc' },
+  },
+  gold: {
+    name: '골드 Claw',
+    colorMap: { primary: '#ffcc00', secondary: '#ffdd44', dark: '#886600', eye: '#ffffff', pupil: '#111111', claw: '#ffcc00' },
+  },
+  pink: {
+    name: '핑크 Claw',
+    colorMap: { primary: '#ff69b4', secondary: '#ff8cc4', dark: '#8B3060', eye: '#ffffff', pupil: '#111111', claw: '#ff69b4' },
+  },
+  cat: {
+    name: '고양이',
+    colorMap: { primary: '#ff9944', secondary: '#ffbb66', dark: '#663300', eye: '#88ff88', pupil: '#111111', claw: '#ff9944' },
+  },
+  robot: {
+    name: '로봇',
+    colorMap: { primary: '#888888', secondary: '#aaaaaa', dark: '#444444', eye: '#66aaff', pupil: '#0044aa', claw: '#66aaff' },
+  },
+  ghost: {
+    name: '유령',
+    colorMap: { primary: '#ccccff', secondary: '#eeeeff', dark: '#6666aa', eye: '#ff6666', pupil: '#cc0000', claw: '#ccccff' },
+  },
+  dragon: {
+    name: '드래곤',
+    colorMap: { primary: '#cc2222', secondary: '#ff4444', dark: '#661111', eye: '#ffaa00', pupil: '#111111', claw: '#ffaa00' },
+  },
+};
+
 function createClawIcon() {
   const size = 16;
   const buffer = Buffer.alloc(size * size * 4);
-
   for (let y = 0; y < size; y++) {
     for (let x = 0; x < size; x++) {
       const code = CLAW_ICON[y][x];
       const color = COLOR_MAP[code] || COLOR_MAP[0];
       const offset = (y * size + x) * 4;
-      buffer[offset + 0] = color[0]; // R
-      buffer[offset + 1] = color[1]; // G
-      buffer[offset + 2] = color[2]; // B
-      buffer[offset + 3] = color[3]; // A
+      buffer[offset + 0] = color[0];
+      buffer[offset + 1] = color[1];
+      buffer[offset + 2] = color[2];
+      buffer[offset + 3] = color[3];
     }
   }
-
   return nativeImage.createFromBuffer(buffer, { width: size, height: size });
 }
 
 function setupTray(mainWindow, bridge) {
   aiBridge = bridge;
-  const store = new Store('clawmate-config', { mode: 'pet' });
+  const store = new Store('clawmate-config', {
+    mode: 'pet',
+    character: 'default',
+    telegramToken: '',
+  });
 
-  // Claw 픽셀아트 트레이 아이콘 생성
   const icon = createClawIcon();
-
   tray = new Tray(icon);
   tray.setToolTip('ClawMate - 데스크톱 펫');
 
@@ -87,38 +121,94 @@ function setupTray(mainWindow, bridge) {
     const fileInteraction = store.get('fileInteraction') !== false;
     const aiConnected = aiBridge ? aiBridge.isConnected() : false;
     const autoStart = isAutoStartEnabled();
+    const currentChar = store.get('character') || 'default';
+    const hasTelegramToken = !!(store.get('telegramToken'));
+
+    // 캐릭터 서브메뉴
+    const characterSubmenu = Object.entries(CHARACTER_PRESETS).map(([key, preset]) => ({
+      label: preset.name,
+      type: 'radio',
+      checked: currentChar === key,
+      click: () => {
+        store.set('character', key);
+        if (mainWindow && !mainWindow.isDestroyed()) {
+          if (key === 'default') {
+            mainWindow.webContents.send('ai-command', {
+              type: 'reset_character', payload: {},
+            });
+          } else {
+            mainWindow.webContents.send('ai-command', {
+              type: 'set_character', payload: {
+                colorMap: preset.colorMap,
+                speech: `${preset.name}(으)로 변신!`,
+              },
+            });
+          }
+        }
+        buildAndSet();
+      },
+    }));
 
     return Menu.buildFromTemplate([
       {
-        label: `ClawMate (${mode === 'pet' ? 'Clawby' : 'OpenClaw'})`,
+        label: `ClawMate (${mode === 'pet' ? 'Clawby' : mode === 'incarnation' ? 'Claw' : 'Clawby + Claw'})`,
         enabled: false,
       },
       {
-        label: aiConnected ? 'AI: 연결됨' : 'AI: 자율 모드 (대기 중)',
+        label: aiConnected ? 'AI: 연결됨' : 'AI: 자율 모드',
         enabled: false,
       },
       { type: 'separator' },
+
+      // === 모드 선택 ===
       {
-        label: 'Pet 모드 (Clawby)',
-        type: 'radio',
-        checked: mode === 'pet',
-        click: () => {
-          store.set('mode', 'pet');
-          if (mainWindow) mainWindow.webContents.send('mode-changed', 'pet');
-          buildAndSet();
-        },
+        label: '모드',
+        submenu: [
+          {
+            label: 'Pet 모드 (Clawby)',
+            sublabel: '귀여운 펫을 키우기',
+            type: 'radio',
+            checked: mode === 'pet',
+            click: () => {
+              store.set('mode', 'pet');
+              if (mainWindow) mainWindow.webContents.send('mode-changed', 'pet');
+              buildAndSet();
+            },
+          },
+          {
+            label: 'Incarnation 모드 (Claw)',
+            sublabel: '봇이 육체를 얻음',
+            type: 'radio',
+            checked: mode === 'incarnation',
+            click: () => {
+              store.set('mode', 'incarnation');
+              if (mainWindow) mainWindow.webContents.send('mode-changed', 'incarnation');
+              buildAndSet();
+            },
+          },
+          {
+            label: '둘 다 (Pet + Incarnation)',
+            sublabel: '펫도 키우고, 봇 인격도 반영',
+            type: 'radio',
+            checked: mode === 'both',
+            click: () => {
+              store.set('mode', 'both');
+              if (mainWindow) mainWindow.webContents.send('mode-changed', 'both');
+              buildAndSet();
+            },
+          },
+        ],
       },
+
+      // === 캐릭터 선택 ===
       {
-        label: 'Incarnation 모드 (OpenClaw)',
-        type: 'radio',
-        checked: mode === 'incarnation',
-        click: () => {
-          store.set('mode', 'incarnation');
-          if (mainWindow) mainWindow.webContents.send('mode-changed', 'incarnation');
-          buildAndSet();
-        },
+        label: '캐릭터',
+        submenu: characterSubmenu,
       },
+
       { type: 'separator' },
+
+      // === 설정 ===
       {
         label: '파일 상호작용',
         type: 'checkbox',
@@ -137,7 +227,83 @@ function setupTray(mainWindow, bridge) {
           buildAndSet();
         },
       },
+
       { type: 'separator' },
+
+      // === 텔레그램 봇 ===
+      {
+        label: '텔레그램 봇',
+        submenu: [
+          {
+            label: hasTelegramToken ? '봇 토큰: 설정됨' : '봇 토큰: 미설정',
+            enabled: false,
+          },
+          {
+            label: '봇 토큰 설정...',
+            click: async () => {
+              const result = await dialog.showMessageBox({
+                type: 'question',
+                buttons: ['클립보드에서 붙여넣기', '직접 입력', '취소'],
+                title: 'ClawMate 텔레그램 봇',
+                message: '텔레그램 봇 토큰을 설정합니다.',
+                detail: '@BotFather에서 받은 봇 토큰을 입력하세요.\n현재 클립보드 내용을 붙여넣으려면 "클립보드에서 붙여넣기"를 선택하세요.',
+              });
+
+              let token = null;
+              if (result.response === 0) {
+                // 클립보드에서 붙여넣기
+                token = clipboard.readText().trim();
+              } else if (result.response === 1) {
+                // prompt가 없으므로 클립보드 안내
+                const promptResult = await dialog.showMessageBox({
+                  type: 'info',
+                  buttons: ['확인'],
+                  title: '텔레그램 봇 토큰',
+                  message: '봇 토큰을 클립보드에 복사한 후 다시 "봇 토큰 설정"을 선택하세요.',
+                  detail: '텔레그램에서 @BotFather → /newbot → 토큰 복사',
+                });
+                return;
+              } else {
+                return;
+              }
+
+              if (token && token.includes(':')) {
+                store.set('telegramToken', token);
+                process.env.CLAWMATE_TELEGRAM_TOKEN = token;
+                buildAndSet();
+
+                // 펫 알림
+                if (mainWindow && !mainWindow.isDestroyed()) {
+                  mainWindow.webContents.send('ai-command', {
+                    type: 'speak',
+                    payload: { text: '텔레그램 봇 토큰 설정 완료!' },
+                  });
+                }
+              } else {
+                await dialog.showMessageBox({
+                  type: 'error',
+                  buttons: ['확인'],
+                  title: '잘못된 토큰',
+                  message: '유효한 텔레그램 봇 토큰이 아닙니다.',
+                  detail: '올바른 형식: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz',
+                });
+              }
+            },
+          },
+          {
+            label: '봇 토큰 제거',
+            enabled: hasTelegramToken,
+            click: () => {
+              store.set('telegramToken', '');
+              delete process.env.CLAWMATE_TELEGRAM_TOKEN;
+              buildAndSet();
+            },
+          },
+        ],
+      },
+
+      { type: 'separator' },
+
       {
         label: '업데이트 확인',
         click: async () => {
@@ -178,13 +344,10 @@ function setupTray(mainWindow, bridge) {
 }
 
 /**
- * 수동 업데이트 확인 (트레이 메뉴에서 클릭)
- * 빌드된 앱: electron-updater 사용
- * npm 설치: npm registry에서 최신 버전 비교
+ * 수동 업데이트 확인
  */
 async function checkForUpdateManual(mainWindow) {
   if (app.isPackaged) {
-    // electron-updater 기반 업데이트
     try {
       const { autoUpdater } = require('electron-updater');
       autoUpdater.checkForUpdatesAndNotify();
@@ -192,7 +355,6 @@ async function checkForUpdateManual(mainWindow) {
       console.error('[업데이트] electron-updater 실패:', err.message);
     }
   } else {
-    // npm 기반 업데이트 확인
     try {
       const latest = execSync('npm view clawmate version', {
         encoding: 'utf-8',
@@ -201,34 +363,27 @@ async function checkForUpdateManual(mainWindow) {
       const current = require('../package.json').version;
 
       if (latest !== current) {
-        // 펫 말풍선으로 알림
         if (mainWindow && !mainWindow.isDestroyed()) {
           mainWindow.webContents.send('ai-command', {
             type: 'speak',
             payload: { text: `새 버전 v${latest} 사용 가능! (현재: v${current})` },
           });
         }
-        console.log(`[업데이트] 새 버전 ${latest} 사용 가능 (현재: ${current})`);
-        console.log('[업데이트] npm update -g clawmate');
-
-        // npm 페이지 열기
         shell.openExternal('https://www.npmjs.com/package/clawmate');
       } else {
-        // 이미 최신
         if (mainWindow && !mainWindow.isDestroyed()) {
           mainWindow.webContents.send('ai-command', {
             type: 'speak',
             payload: { text: `v${current} — 이미 최신 버전이야!` },
           });
         }
-        console.log(`[업데이트] 현재 최신 버전 (v${current})`);
       }
     } catch (err) {
       console.error('[업데이트] npm 버전 확인 실패:', err.message);
       if (mainWindow && !mainWindow.isDestroyed()) {
         mainWindow.webContents.send('ai-command', {
           type: 'speak',
-          payload: { text: '업데이트 확인 실패... 인터넷 연결 확인해봐!' },
+          payload: { text: '업데이트 확인 실패...' },
         });
       }
     }

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "clawmate",
   "name": "ClawMate",
-  "description": "OpenClaw 데스크톱 펫 - 화면 위의 살아있는 Claw",
+  "description": "ClawMate - 화면 위의 살아있는 데스크톱 펫",
   "version": "1.0.0",
   "skills": ["skills/launch-pet"],
   "configSchema": {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "clawmate",
-  "version": "1.3.0",
-  "description": "OpenClaw 데스크톱 펫 - AI가 조종하는 화면 위의 살아있는 Claw",
+  "version": "1.4.0",
+  "description": "ClawMate - AI가 조종하는 화면 위의 살아있는 데스크톱 펫",
   "main": "main/index.js",
   "bin": {
     "clawmate": "./skills/launch-pet/index.js"
@@ -18,13 +18,12 @@
     "build:linux": "electron-builder --linux"
   },
   "keywords": [
-    "openclaw",
     "desktop-pet",
     "electron",
     "clawmate",
     "ai-pet"
   ],
-  "author": "OpenClaw",
+  "author": "ClawMate",
   "license": "MIT",
   "homepage": "https://github.com/boqum/clawmate",
   "dependencies": {

package/preload/preload.js

@@ -42,9 +42,9 @@ contextBridge.exposeInMainWorld('clawmate', {
     ipcRenderer.on('config-changed', (_, config) => callback(config));
   },
 
-  // === OpenClaw AI 통신 ===
+  // === AI 통신 ===
 
-  // AI 명령 수신 (OpenClaw → 펫)
+  // AI 명령 수신 (AI → 펫)
   onAICommand: (callback) => {
     ipcRenderer.on('ai-command', (_, command) => callback(command));
   },
@@ -57,13 +57,13 @@ contextBridge.exposeInMainWorld('clawmate', {
     ipcRenderer.on('ai-disconnected', () => callback());
   },
 
-  // 사용자 이벤트를 OpenClaw에 전달 (펫 → OpenClaw)
+  // 사용자 이벤트를 AI에 전달 (펫 → AI)
   reportToAI: (event, data) => ipcRenderer.send('report-to-ai', event, data),
 
   // AI 연결 상태 확인
   isAIConnected: () => ipcRenderer.invoke('is-ai-connected'),
 
-  // 메트릭 보고 (렌더러 → main → OpenClaw)
+  // 메트릭 보고 (렌더러 → main → AI)
   reportMetrics: (summary) => ipcRenderer.send('report-metrics', summary),
 
   // 활성 윈도우 제목 조회 (브라우저 감시)

package/renderer/first-run.html

@@ -48,7 +48,7 @@
 
       <div class="mode-card" id="mode-incarnation" onclick="selectMode('incarnation')">
         <div class="mode-icon">\u{1F980}</div>
-        <h2>OpenClaw</h2>
+        <h2>Claw</h2>
         <p>육체를 얻은 존재</p>
         <span class="mode-desc">침착하고 카리스마 있는 Claw!</span>
       </div>
@@ -72,7 +72,7 @@
       document.getElementById('mode-' + mode).classList.add('selected');
       const btn = document.getElementById('start-btn');
       btn.disabled = false;
-      btn.textContent = mode === 'pet' ? 'Clawby와 시작!' : 'OpenClaw과 시작!';
+      btn.textContent = mode === 'pet' ? 'Clawby와 시작!' : 'Claw과 시작!';
     }
 
     async function startFirstRun() {

package/renderer/js/ai-controller.js

@@ -1,10 +1,10 @@
 /**
  * AI 행동 컨트롤러
  *
- * OpenClaw이 연결되면 → AI가 모든 행동을 결정
- * OpenClaw이 끊기면  → 자율 모드 (기존 FSM) 로 폴백
+ * AI가 연결되면 → AI가 모든 행동을 결정
+ * AI가 끊기면  → 자율 모드 (기존 FSM) 로 폴백
  *
- * OpenClaw AI가 결정하는 것:
+ * AI가 결정하는 것:
  * - 언제 뭐라고 말할지
  * - 어디로 움직일지
  * - 어떤 감정을 표현할지
@@ -32,7 +32,7 @@ const AIController = (() => {
       window.clawmate.onAIConnected(() => {
         connected = true;
         autonomousMode = false;
-        Speech.show('OpenClaw 연결됨... 의식이 깨어난다.');
+        Speech.show('AI 연결됨... 의식이 깨어난다.');
         StateMachine.forceState('excited');
       });
     }
@@ -47,7 +47,7 @@ const AIController = (() => {
   }
 
   /**
-   * OpenClaw AI로부터 온 명령 실행
+   * AI로부터 온 명령 실행
    */
   function handleAICommand(command) {
     const { type, payload } = command;
@@ -144,7 +144,7 @@ const AIController = (() => {
       // === 커스텀 이동 패턴 ===
 
       case 'register_movement':
-        // OpenClaw이 JSON으로 이동 패턴 정의를 보내면 등록
+        // AI가 JSON으로 이동 패턴 정의를 보내면 등록
         // payload: { name, definition }
         // definition: { type, params } — 각 타입별 파라미터
         _registerAIMovement(payload.name, payload.definition);
@@ -200,6 +200,17 @@ const AIController = (() => {
         StateMachine.forceState('excited');
         break;
 
+      // === 인격체 전환 (Incarnation 모드) ===
+      case 'set_persona':
+        // 봇 인격체 데이터 적용
+        if (typeof ModeManager !== 'undefined') {
+          ModeManager.setPersona(payload);
+          const name = payload.name || 'Claw';
+          Speech.show(`${name}의 인격이 깨어났다.`);
+          StateMachine.forceState('excited');
+        }
+        break;
+
       // === 스마트 파일 조작 애니메이션 ===
       case 'smart_file_op':
         handleSmartFileOp(payload);
@@ -290,7 +301,7 @@ const AIController = (() => {
   }
 
   /**
-   * OpenClaw AI가 JSON으로 정의한 이동 패턴을 동적으로 등록
+   * AI가 JSON으로 정의한 이동 패턴을 동적으로 등록
    * 안전한 실행을 위해 Function 생성자 대신 사전정의된 행동 유형 조합 사용
    *
    * definition 형식:
@@ -439,7 +450,7 @@ const AIController = (() => {
 
   /**
    * AI 종합 의사결정 실행
-   * OpenClaw이 상황을 분석하고 내린 복합적 결정
+   * AI가 상황을 분석하고 내린 복합적 결정
    *
    * 예시:
    * {
@@ -496,7 +507,7 @@ const AIController = (() => {
     StateMachine.forceState(state);
   }
 
-  // === 사용자 이벤트 → OpenClaw에 리포트 ===
+  // === 사용자 이벤트 → AI에 리포트 ===
 
   function reportClick(position) {
     if (window.clawmate.reportToAI) {