/** * Electron Main Process Entry * Manages window creation, system tray, and IPC handlers */ import { app, BrowserWindow, nativeImage, session, shell } from 'electron'; import type { Server } from 'node:http'; import { join } from 'path'; import { GatewayManager } from '../gateway/manager'; import { registerIpcHandlers } from './ipc-handlers'; import { createTray } from './tray'; import { createMenu } from './menu'; import { appUpdater, registerUpdateHandlers } from './updater'; import { logger } from '../utils/logger'; import { warmupNetworkOptimization } from '../utils/uv-env'; import { initTelemetry } from '../utils/telemetry'; import { ClawHubService } from '../gateway/clawhub'; import { ensureClawXContext, repairClawXOnlyBootstrapFiles } from '../utils/openclaw-workspace'; import { autoInstallCliIfNeeded, generateCompletionCache, installCompletionToProfile } from '../utils/openclaw-cli'; import { isQuitting, setQuitting } from './app-state'; import { applyProxySettings } from './proxy'; import { syncLaunchAtStartupSettingFromStore } from './launch-at-startup'; import { clearPendingSecondInstanceFocus, consumeMainWindowReady, createMainWindowFocusState, requestSecondInstanceFocus, } from './main-window-focus'; import { createQuitLifecycleState, markQuitCleanupCompleted, requestQuitLifecycleAction, } from './quit-lifecycle'; import { createSignalQuitHandler } from './signal-quit'; import { acquireProcessInstanceFileLock } from './process-instance-lock'; import { getSetting } from '../utils/store'; import { ensureBuiltinSkillsInstalled, ensurePreinstalledSkillsInstalled } from '../utils/skill-config'; import { ensureAllBundledPluginsInstalled } from '../utils/plugin-install'; import { startHostApiServer } from '../api/server'; import { HostEventBus } from '../api/event-bus'; import { deviceOAuthManager } from '../utils/device-oauth'; import { browserOAuthManager } from '../utils/browser-oauth'; import { whatsAppLoginManager } from '../utils/whatsapp-login'; import { syncAllProviderAuthToRuntime } from '../services/providers/provider-runtime-sync'; const WINDOWS_APP_USER_MODEL_ID = 'app.clawx.desktop'; const isE2EMode = process.env.CLAWX_E2E === '1'; const requestedUserDataDir = process.env.CLAWX_USER_DATA_DIR?.trim(); if (isE2EMode && requestedUserDataDir) { app.setPath('userData', requestedUserDataDir); } // Disable GPU hardware acceleration globally for maximum stability across // all GPU configurations (no GPU, integrated, discrete). // // Rationale (following VS Code's philosophy): // - Page/file loading is async data fetching — zero GPU dependency. // - The original per-platform GPU branching was added to avoid CPU rendering // competing with sync I/O on Windows, but all file I/O is now async // (fs/promises), so that concern no longer applies. // - Software rendering is deterministic across all hardware; GPU compositing // behaviour varies between vendors (Intel, AMD, NVIDIA, Apple Silicon) and // driver versions, making it the #1 source of rendering bugs in Electron. // // Users who want GPU acceleration can pass `--enable-gpu` on the CLI or // set `"disable-hardware-acceleration": false` in the app config (future). app.disableHardwareAcceleration(); // On Linux, set CHROME_DESKTOP so Chromium can find the correct .desktop file. // On Wayland this maps the running window to clawx.desktop (→ icon + app grouping); // on X11 it supplements the StartupWMClass matching. // Must be called before app.whenReady() / before any window is created. if (process.platform === 'linux') { app.setDesktopName('clawx.desktop'); } // Prevent multiple instances of the app from running simultaneously. // Without this, two instances each spawn their own gateway process on the // same port, then each treats the other's gateway as "orphaned" and kills // it — creating an infinite kill/restart loop on Windows. // The losing process must exit immediately so it never reaches Gateway startup. const gotElectronLock = isE2EMode ? true : app.requestSingleInstanceLock(); if (!gotElectronLock) { console.info('[ClawX] Another instance already holds the single-instance lock; exiting duplicate process'); app.exit(0); } let releaseProcessInstanceFileLock: () => void = () => {}; let gotFileLock = true; if (gotElectronLock && !isE2EMode) { try { const fileLock = acquireProcessInstanceFileLock({ userDataDir: app.getPath('userData'), lockName: 'clawx', force: true, // Electron lock already guarantees exclusivity; force-clean orphan/recycled-PID locks }); gotFileLock = fileLock.acquired; releaseProcessInstanceFileLock = fileLock.release; if (!fileLock.acquired) { const ownerDescriptor = fileLock.ownerPid ? `${fileLock.ownerFormat ?? 'legacy'} pid=${fileLock.ownerPid}` : fileLock.ownerFormat === 'unknown' ? 'unknown lock format/content' : 'unknown owner'; console.info( `[ClawX] Another instance already holds process lock (${fileLock.lockPath}, ${ownerDescriptor}); exiting duplicate process`, ); app.exit(0); } } catch (error) { console.warn('[ClawX] Failed to acquire process instance file lock; continuing with Electron single-instance lock only', error); } } const gotTheLock = gotElectronLock && gotFileLock; // Global references let mainWindow: BrowserWindow | null = null; let gatewayManager!: GatewayManager; let clawHubService!: ClawHubService; let hostEventBus!: HostEventBus; let hostApiServer: Server | null = null; const mainWindowFocusState = createMainWindowFocusState(); const quitLifecycleState = createQuitLifecycleState(); /** * Resolve the icons directory path (works in both dev and packaged mode) */ function getIconsDir(): string { if (app.isPackaged) { // Packaged: icons are in extraResources → process.resourcesPath/resources/icons return join(process.resourcesPath, 'resources', 'icons'); } // Development: relative to dist-electron/main/ return join(__dirname, '../../resources/icons'); } /** * Get the app icon for the current platform */ function getAppIcon(): Electron.NativeImage | undefined { if (process.platform === 'darwin') return undefined; // macOS uses the app bundle icon const iconsDir = getIconsDir(); const iconPath = process.platform === 'win32' ? join(iconsDir, 'icon.ico') : join(iconsDir, 'icon.png'); const icon = nativeImage.createFromPath(iconPath); return icon.isEmpty() ? undefined : icon; } /** * Create the main application window */ function createWindow(): BrowserWindow { const isMac = process.platform === 'darwin'; const isWindows = process.platform === 'win32'; const useCustomTitleBar = isWindows; const win = new BrowserWindow({ width: 1280, height: 800, minWidth: 960, minHeight: 600, icon: getAppIcon(), webPreferences: { preload: join(__dirname, '../preload/index.js'), nodeIntegration: false, contextIsolation: true, sandbox: false, webviewTag: true, // Enable for embedding OpenClaw Control UI }, titleBarStyle: isMac ? 'hiddenInset' : useCustomTitleBar ? 'hidden' : 'default', trafficLightPosition: isMac ? { x: 16, y: 16 } : undefined, frame: isMac || !useCustomTitleBar, show: false, }); // Handle external links — only allow safe protocols to prevent arbitrary // command execution via shell.openExternal() (e.g. file://, ms-msdt:, etc.) win.webContents.setWindowOpenHandler(({ url }) => { try { const parsed = new URL(url); if (parsed.protocol === 'https:' || parsed.protocol === 'http:') { shell.openExternal(url); } else { logger.warn(`Blocked openExternal for disallowed protocol: ${parsed.protocol}`); } } catch { logger.warn(`Blocked openExternal for malformed URL: ${url}`); } return { action: 'deny' }; }); // Load the app if (process.env.VITE_DEV_SERVER_URL) { win.loadURL(process.env.VITE_DEV_SERVER_URL); if (!isE2EMode) { win.webContents.openDevTools(); } } else { win.loadFile(join(__dirname, '../../dist/index.html')); } return win; } function focusWindow(win: BrowserWindow): void { if (win.isDestroyed()) { return; } if (win.isMinimized()) { win.restore(); } win.show(); win.focus(); } function focusMainWindow(): void { if (!mainWindow || mainWindow.isDestroyed()) { return; } clearPendingSecondInstanceFocus(mainWindowFocusState); focusWindow(mainWindow); } function createMainWindow(): BrowserWindow { const win = createWindow(); win.once('ready-to-show', () => { if (mainWindow !== win) { return; } const action = consumeMainWindowReady(mainWindowFocusState); if (action === 'focus') { focusWindow(win); return; } win.show(); }); win.on('close', (event) => { if (!isQuitting()) { event.preventDefault(); win.hide(); } }); win.on('closed', () => { if (mainWindow === win) { mainWindow = null; } }); mainWindow = win; return win; } /** * Initialize the application */ async function initialize(): Promise { // Initialize logger first logger.init(); logger.info('=== ClawX Application Starting ==='); logger.debug( `Runtime: platform=${process.platform}/${process.arch}, electron=${process.versions.electron}, node=${process.versions.node}, packaged=${app.isPackaged}, pid=${process.pid}, ppid=${process.ppid}` ); if (!isE2EMode) { // Warm up network optimization (non-blocking) void warmupNetworkOptimization(); // Initialize Telemetry early await initTelemetry(); // Apply persisted proxy settings before creating windows or network requests. await applyProxySettings(); await syncLaunchAtStartupSettingFromStore(); } else { logger.info('Running in E2E mode: startup side effects minimized'); } // Set application menu createMenu(); // Create the main window const window = createMainWindow(); // Create system tray if (!isE2EMode) { createTray(window); } // Override security headers ONLY for the OpenClaw Gateway Control UI. // The URL filter ensures this callback only fires for gateway requests, // avoiding unnecessary overhead on every other HTTP response. session.defaultSession.webRequest.onHeadersReceived( { urls: ['http://127.0.0.1:18789/*', 'http://localhost:18789/*'] }, (details, callback) => { const headers = { ...details.responseHeaders }; delete headers['X-Frame-Options']; delete headers['x-frame-options']; if (headers['Content-Security-Policy']) { headers['Content-Security-Policy'] = headers['Content-Security-Policy'].map( (csp) => csp.replace(/frame-ancestors\s+'none'/g, "frame-ancestors 'self' *") ); } if (headers['content-security-policy']) { headers['content-security-policy'] = headers['content-security-policy'].map( (csp) => csp.replace(/frame-ancestors\s+'none'/g, "frame-ancestors 'self' *") ); } callback({ responseHeaders: headers }); }, ); // Register IPC handlers registerIpcHandlers(gatewayManager, clawHubService, window); hostApiServer = startHostApiServer({ gatewayManager, clawHubService, eventBus: hostEventBus, mainWindow: window, }); // Register update handlers registerUpdateHandlers(appUpdater, window); // Note: Auto-check for updates is driven by the renderer (update store init) // so it respects the user's "Auto-check for updates" setting. // Repair any bootstrap files that only contain ClawX markers (no OpenClaw // template content). This fixes a race condition where ensureClawXContext() // previously created the file before the gateway could seed the full template. if (!isE2EMode) { void repairClawXOnlyBootstrapFiles().catch((error) => { logger.warn('Failed to repair bootstrap files:', error); }); } // Pre-deploy built-in skills (feishu-doc, feishu-drive, feishu-perm, feishu-wiki) // to ~/.openclaw/skills/ so they are immediately available without manual install. if (!isE2EMode) { void ensureBuiltinSkillsInstalled().catch((error) => { logger.warn('Failed to install built-in skills:', error); }); } // Pre-deploy bundled third-party skills from resources/preinstalled-skills. // This installs full skill directories (not only SKILL.md) in an idempotent, // non-destructive way and never blocks startup. if (!isE2EMode) { void ensurePreinstalledSkillsInstalled().catch((error) => { logger.warn('Failed to install preinstalled skills:', error); }); } // Pre-deploy/upgrade bundled OpenClaw plugins (dingtalk, wecom, qqbot, feishu, wechat) // to ~/.openclaw/extensions/ so they are always up-to-date after an app update. if (!isE2EMode) { void ensureAllBundledPluginsInstalled().catch((error) => { logger.warn('Failed to install/upgrade bundled plugins:', error); }); } // Bridge gateway and host-side events before any auto-start logic runs, so // renderer subscribers observe the full startup lifecycle. gatewayManager.on('status', (status: { state: string }) => { hostEventBus.emit('gateway:status', status); if (status.state === 'running' && !isE2EMode) { void ensureClawXContext().catch((error) => { logger.warn('Failed to re-merge ClawX context after gateway reconnect:', error); }); } }); gatewayManager.on('error', (error) => { hostEventBus.emit('gateway:error', { message: error.message }); }); gatewayManager.on('notification', (notification) => { hostEventBus.emit('gateway:notification', notification); }); gatewayManager.on('chat:message', (data) => { hostEventBus.emit('gateway:chat-message', data); }); gatewayManager.on('channel:status', (data) => { hostEventBus.emit('gateway:channel-status', data); }); gatewayManager.on('exit', (code) => { hostEventBus.emit('gateway:exit', { code }); }); deviceOAuthManager.on('oauth:code', (payload) => { hostEventBus.emit('oauth:code', payload); }); deviceOAuthManager.on('oauth:start', (payload) => { hostEventBus.emit('oauth:start', payload); }); deviceOAuthManager.on('oauth:success', (payload) => { hostEventBus.emit('oauth:success', { ...payload, success: true }); }); deviceOAuthManager.on('oauth:error', (error) => { hostEventBus.emit('oauth:error', error); }); browserOAuthManager.on('oauth:start', (payload) => { hostEventBus.emit('oauth:start', payload); }); browserOAuthManager.on('oauth:code', (payload) => { hostEventBus.emit('oauth:code', payload); }); browserOAuthManager.on('oauth:success', (payload) => { hostEventBus.emit('oauth:success', { ...payload, success: true }); }); browserOAuthManager.on('oauth:error', (error) => { hostEventBus.emit('oauth:error', error); }); whatsAppLoginManager.on('qr', (data) => { hostEventBus.emit('channel:whatsapp-qr', data); }); whatsAppLoginManager.on('success', (data) => { hostEventBus.emit('channel:whatsapp-success', data); }); whatsAppLoginManager.on('error', (error) => { hostEventBus.emit('channel:whatsapp-error', error); }); // Start Gateway automatically (this seeds missing bootstrap files with full templates) const gatewayAutoStart = await getSetting('gatewayAutoStart'); if (!isE2EMode && gatewayAutoStart) { try { await syncAllProviderAuthToRuntime(); logger.debug('Auto-starting Gateway...'); await gatewayManager.start(); logger.info('Gateway auto-start succeeded'); } catch (error) { logger.error('Gateway auto-start failed:', error); mainWindow?.webContents.send('gateway:error', String(error)); } } else if (isE2EMode) { logger.info('Gateway auto-start skipped in E2E mode'); } else { logger.info('Gateway auto-start disabled in settings'); } // Merge ClawX context snippets into the workspace bootstrap files. // The gateway seeds workspace files asynchronously after its HTTP server // is ready, so ensureClawXContext will retry until the target files appear. if (!isE2EMode) { void ensureClawXContext().catch((error) => { logger.warn('Failed to merge ClawX context into workspace:', error); }); } // Auto-install openclaw CLI and shell completions (non-blocking). if (!isE2EMode) { void autoInstallCliIfNeeded((installedPath) => { mainWindow?.webContents.send('openclaw:cli-installed', installedPath); }).then(() => { generateCompletionCache(); installCompletionToProfile(); }).catch((error) => { logger.warn('CLI auto-install failed:', error); }); } } if (gotTheLock) { const requestQuitOnSignal = createSignalQuitHandler({ logInfo: (message) => logger.info(message), requestQuit: () => app.quit(), }); process.on('exit', () => { releaseProcessInstanceFileLock(); }); process.once('SIGINT', () => requestQuitOnSignal('SIGINT')); process.once('SIGTERM', () => requestQuitOnSignal('SIGTERM')); app.on('will-quit', () => { releaseProcessInstanceFileLock(); }); if (process.platform === 'win32') { app.setAppUserModelId(WINDOWS_APP_USER_MODEL_ID); } gatewayManager = new GatewayManager(); clawHubService = new ClawHubService(); hostEventBus = new HostEventBus(); // When a second instance is launched, focus the existing window instead. app.on('second-instance', () => { logger.info('Second ClawX instance detected; redirecting to the existing window'); const focusRequest = requestSecondInstanceFocus( mainWindowFocusState, Boolean(mainWindow && !mainWindow.isDestroyed()), ); if (focusRequest === 'focus-now') { focusMainWindow(); return; } logger.debug('Main window is not ready yet; deferring second-instance focus until ready-to-show'); }); // Application lifecycle app.whenReady().then(() => { void initialize().catch((error) => { logger.error('Application initialization failed:', error); }); // Register activate handler AFTER app is ready to prevent // "Cannot create BrowserWindow before app is ready" on macOS. app.on('activate', () => { if (BrowserWindow.getAllWindows().length === 0) { createMainWindow(); } else { focusMainWindow(); } }); }); app.on('window-all-closed', () => { if (process.platform !== 'darwin') { app.quit(); } }); app.on('before-quit', (event) => { setQuitting(); const action = requestQuitLifecycleAction(quitLifecycleState); if (action === 'allow-quit') { return; } event.preventDefault(); if (action === 'cleanup-in-progress') { logger.debug('Quit requested while cleanup already in progress; waiting for shutdown task to finish'); return; } hostEventBus.closeAll(); hostApiServer?.close(); const stopPromise = gatewayManager.stop().catch((err) => { logger.warn('gatewayManager.stop() error during quit:', err); }); const timeoutPromise = new Promise<'timeout'>((resolve) => { setTimeout(() => resolve('timeout'), 5000); }); void Promise.race([stopPromise.then(() => 'stopped' as const), timeoutPromise]).then((result) => { if (result === 'timeout') { logger.warn('Gateway shutdown timed out during app quit; proceeding with forced quit'); void gatewayManager.forceTerminateOwnedProcessForQuit().then((terminated) => { if (terminated) { logger.warn('Forced gateway process termination completed after quit timeout'); } }).catch((err) => { logger.warn('Forced gateway termination failed after quit timeout:', err); }); } markQuitCleanupCompleted(quitLifecycleState); app.quit(); }); }); // Best-effort Gateway cleanup on unexpected crashes. // These handlers attempt to terminate the Gateway child process within a // short timeout before force-exiting, preventing orphaned processes. const emergencyGatewayCleanup = (reason: string, error: unknown): void => { logger.error(`${reason}:`, error); try { void gatewayManager?.stop().catch(() => { /* ignore */ }); } catch { // ignore — stop() may not be callable if state is corrupted } // Give Gateway stop a brief window, then force-exit. setTimeout(() => { process.exit(1); }, 3000).unref(); }; process.on('uncaughtException', (error) => { emergencyGatewayCleanup('Uncaught exception in main process', error); }); process.on('unhandledRejection', (reason) => { emergencyGatewayCleanup('Unhandled promise rejection in main process', reason); }); } // Export for testing export { mainWindow, gatewayManager };