@clawchatsai/connector 0.0.13 → 0.0.15

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 /**
- * @shellchat/tunnel — OpenClaw plugin entry point
+ * @clawchatsai/connector — OpenClaw plugin entry point
  *
- * Registers ShellChat as a gateway plugin, providing:
+ * Registers ClawChats as a gateway plugin, providing:
  * - Local HTTP API bridge via createApp()
  * - WebRTC DataChannel for browser connections
  * - Signaling client for NAT traversal

package/dist/index.js

@@ -1,7 +1,7 @@
 /**
- * @shellchat/tunnel — OpenClaw plugin entry point
+ * @clawchatsai/connector — OpenClaw plugin entry point
  *
- * Registers ShellChat as a gateway plugin, providing:
+ * Registers ClawChats as a gateway plugin, providing:
  * - Local HTTP API bridge via createApp()
  * - WebRTC DataChannel for browser connections
  * - Signaling client for NAT traversal
@@ -24,6 +24,8 @@ export const PLUGIN_VERSION = '0.0.13';
 const MAX_DC_MESSAGE_SIZE = 256 * 1024;
 /** Active DataChannel connections: connectionId → send function */
 const connectedClients = new Map();
+/** Reassembly buffers for chunked gateway-msg from browser (large payloads like image attachments). */
+const gatewayMsgChunkBuffers = new Map();
 let app = null;
 let signaling = null;
 let webrtcPeer = null;
@@ -32,7 +34,7 @@ let _stopRequested = false;
 // ---------------------------------------------------------------------------
 // Config helpers
 // ---------------------------------------------------------------------------
-const CONFIG_DIR = path.join(process.env.HOME || '/root', '.openclaw', 'shellchats');
+const CONFIG_DIR = path.join(process.env.HOME || '/root', '.openclaw', 'clawchats');
 const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
 const RUNTIME_FILE = path.join(CONFIG_DIR, 'runtime.json');
 function loadConfig() {
@@ -73,11 +75,11 @@ async function ensureNativeModules(ctx) {
         ctx.logger.error('Try running manually: cd ~/.openclaw/extensions/connector && npm rebuild better-sqlite3');
     }
 }
-async function startShellChat(ctx, api) {
+async function startClawChats(ctx, api) {
     _stopRequested = false;
     let config = loadConfig();
     if (!config) {
-        ctx.logger.info('ShellChats not configured. Waiting for setup...');
+        ctx.logger.info('ClawChats not configured. Waiting for setup...');
         fs.mkdirSync(CONFIG_DIR, { recursive: true });
         while (!config && !_stopRequested) {
             await new Promise(r => setTimeout(r, 2000));
@@ -85,7 +87,7 @@ async function startShellChat(ctx, api) {
         }
         if (_stopRequested || !config)
             return;
-        ctx.logger.info('Setup detected — connecting to ShellChats...');
+        ctx.logger.info('Setup detected — connecting to ClawChats...');
     }
     // 1. Check for updates
     const update = await checkForUpdates();
@@ -95,7 +97,7 @@ async function startShellChat(ctx, api) {
             try {
                 await performUpdate();
                 ctx.logger.info(`Updated to ${update.latest}. Requesting graceful restart...`);
-                api.runtime.requestRestart?.('shellchats update');
+                api.runtime.requestRestart?.('clawchats update');
                 return; // will restart with new version
             }
             catch (e) {
@@ -108,14 +110,14 @@ async function startShellChat(ctx, api) {
     const gwAuth = gwCfg?.['gateway']?.['auth'];
     const gatewayToken = gwAuth?.['token'] || config.gatewayToken || '';
     if (!gatewayToken) {
-        ctx.logger.error('No gateway token available. Re-run: openclaw shellchats setup <token>');
+        ctx.logger.error('No gateway token available. Re-run: openclaw clawchats setup <token>');
         return;
     }
     // 3. Ensure native modules are built (OpenClaw installs with --ignore-scripts)
     await ensureNativeModules(ctx);
     // 4. Import server.js and create app instance with plugin paths
-    const dataDir = path.join(ctx.stateDir, 'shellchats', 'data');
-    const uploadsDir = path.join(ctx.stateDir, 'shellchats', 'uploads');
+    const dataDir = path.join(ctx.stateDir, 'clawchats', 'data');
+    const uploadsDir = path.join(ctx.stateDir, 'clawchats', 'uploads');
     // Dynamic import of server.js (plain JS, no type declarations)
     // @ts-expect-error — server.js is plain JS with no .d.ts
     const serverModule = await import('../server.js');
@@ -228,11 +230,11 @@ async function startShellChat(ctx, api) {
         }, null, 2), { mode: 0o600 });
         ctx.logger.info(`Health endpoint on 127.0.0.1:${addr.port}`);
     });
-    ctx.logger.info('ShellChat service started');
+    ctx.logger.info('ClawChats service started');
 }
-async function stopShellChat(ctx) {
+async function stopClawChats(ctx) {
     _stopRequested = true;
-    ctx.logger.info('ShellChat service stopping...');
+    ctx.logger.info('ClawChats service stopping...');
     // 0. Tear down health endpoint
     if (healthServer) {
         healthServer.close();
@@ -259,7 +261,7 @@ async function stopShellChat(ctx) {
     // 4. Close SQLite databases
     app?.shutdown();
     app = null;
-    ctx.logger.info('ShellChat service stopped');
+    ctx.logger.info('ClawChats service stopped');
 }
 // ---------------------------------------------------------------------------
 // DataChannel message handler (spec section 6.4)
@@ -286,6 +288,43 @@ function setupDataChannelHandler(dc, connectionId, ctx) {
                     app.gatewayClient.sendToGateway(msg['payload']);
                 }
                 break;
+            case 'gateway-msg-chunk': {
+                // Reassemble chunked gateway messages from the browser.
+                // Large payloads (e.g. image attachments as base64) exceed the
+                // DataChannel's safe single-message limit (~64 KiB) and are split
+                // by the browser's transport.js into indexed chunks.
+                const chunkId = msg['id'];
+                const index = msg['index'];
+                const total = msg['total'];
+                const chunkData = msg['data'];
+                if (!chunkId || typeof index !== 'number' || typeof total !== 'number' || !chunkData) {
+                    dc.send(JSON.stringify({ type: 'error', message: 'malformed gateway-msg-chunk' }));
+                    break;
+                }
+                if (!gatewayMsgChunkBuffers.has(chunkId)) {
+                    gatewayMsgChunkBuffers.set(chunkId, {
+                        chunks: new Array(total),
+                        received: 0,
+                        total,
+                        createdAt: Date.now(),
+                    });
+                    // Expire stale buffers after 30s to prevent memory leaks
+                    setTimeout(() => gatewayMsgChunkBuffers.delete(chunkId), 30_000);
+                }
+                const buf = gatewayMsgChunkBuffers.get(chunkId);
+                if (!buf.chunks[index]) {
+                    buf.chunks[index] = chunkData;
+                    buf.received++;
+                }
+                if (buf.received === buf.total) {
+                    gatewayMsgChunkBuffers.delete(chunkId);
+                    const fullPayload = buf.chunks.join('');
+                    if (app?.gatewayClient) {
+                        app.gatewayClient.sendToGateway(fullPayload);
+                    }
+                }
+                break;
+            }
             default:
                 dc.send(JSON.stringify({ type: 'error', message: 'unknown message type' }));
         }
@@ -386,7 +425,7 @@ function broadcastToClients(msg) {
 // ---------------------------------------------------------------------------
 function formatStatus() {
     const lines = [];
-    lines.push(`ShellChat Plugin v${PLUGIN_VERSION}`);
+    lines.push(`ClawChats Plugin v${PLUGIN_VERSION}`);
     lines.push(`Gateway: ${app?.gatewayClient?.connected ? 'connected' : 'disconnected'}`);
     lines.push(`Signaling: ${signaling?.isConnected ? 'connected' : 'disconnected'}`);
     lines.push(`Clients: ${connectedClients.size}`);
@@ -410,7 +449,7 @@ async function handleSetup(token) {
         console.error('Setup token has expired. Generate a new one from clawchats.ai.');
         return;
     }
-    console.log('Setting up ShellChats...');
+    console.log('Setting up ClawChats...');
     console.log(`  Server: ${tokenData.serverUrl}`);
     // Generate API key for signaling server auth
     const { randomBytes } = await import('node:crypto');
@@ -467,7 +506,7 @@ async function handleSetup(token) {
                 const uploadsDir = path.join(CONFIG_DIR, 'uploads');
                 fs.mkdirSync(dataDir, { recursive: true });
                 fs.mkdirSync(uploadsDir, { recursive: true });
-                console.log('  ShellChats is ready!');
+                console.log('  ClawChats is ready!');
                 console.log('  Open clawchats.ai in your browser to start chatting.');
                 ws.close();
                 resolve();
@@ -497,7 +536,7 @@ async function handleStatus() {
         runtime = JSON.parse(fs.readFileSync(RUNTIME_FILE, 'utf8'));
     }
     catch {
-        console.log('ShellChats: offline (service not running)');
+        console.log('ClawChats: offline (service not running)');
         return;
     }
     // Verify PID is alive
@@ -505,7 +544,7 @@ async function handleStatus() {
         process.kill(runtime.pid, 0);
     }
     catch {
-        console.log('ShellChats: offline (stale runtime file)');
+        console.log('ClawChats: offline (stale runtime file)');
         try {
             fs.unlinkSync(RUNTIME_FILE);
         }
@@ -524,20 +563,20 @@ async function handleStatus() {
             req.setTimeout(3000, () => { req.destroy(); reject(new Error('timeout')); });
         });
         const status = JSON.parse(body);
-        console.log(`ShellChats Plugin v${status.version}`);
+        console.log(`ClawChats Plugin v${status.version}`);
         console.log(`Uptime: ${Math.floor(status.uptime)}s`);
         console.log(`Gateway: ${status.gateway.connected ? 'connected' : 'disconnected'}`);
         console.log(`Signaling: ${status.signaling.connected ? 'connected' : 'disconnected'}`);
         console.log(`Clients: ${status.clients.active}`);
     }
     catch {
-        console.log('ShellChats: offline (could not reach service)');
+        console.log('ClawChats: offline (could not reach service)');
     }
 }
 async function handleReset() {
     try {
         fs.rmSync(CONFIG_DIR, { recursive: true, force: true });
-        console.log('ShellChats data removed. Plugin disconnected.');
+        console.log('ClawChats data removed. Plugin disconnected.');
     }
     catch (e) {
         console.error(`Reset failed: ${e.message}`);
@@ -554,7 +593,7 @@ async function handleImport(sourcePath) {
         console.error(`Source must be a directory: ${resolvedSource}`);
         return;
     }
-    // Destination: ~/.openclaw/shellchats/data/
+    // Destination: ~/.openclaw/clawchats/data/
     const destDataDir = path.join(CONFIG_DIR, 'data');
     fs.mkdirSync(destDataDir, { recursive: true });
     // Import .db files
@@ -586,7 +625,7 @@ async function handleImport(sourcePath) {
         }
     }
     // Also try to migrate config.json from the parent directory
-    // e.g. if source is ~/.openclaw/shellchat/data/, config is at ~/.openclaw/shellchat/config.json
+    // e.g. if source is ~/.openclaw/clawchats/data/, config is at ~/.openclaw/clawchats/config.json
     const parentConfigPath = path.join(path.dirname(resolvedSource), 'config.json');
     if (fs.existsSync(parentConfigPath)) {
         try {
@@ -605,26 +644,26 @@ async function handleImport(sourcePath) {
 // ---------------------------------------------------------------------------
 const plugin = {
     id: PLUGIN_ID,
-    name: 'ShellChats',
-    description: 'Connects your gateway to ShellChats via WebRTC P2P',
+    name: 'ClawChats',
+    description: 'Connects your gateway to ClawChats via WebRTC P2P',
     register(api) {
         // Background service: signaling + gateway bridge + future WebRTC
         api.registerService({
             id: 'connector-service',
-            start: (ctx) => startShellChat(ctx, api),
-            stop: (ctx) => stopShellChat(ctx),
+            start: (ctx) => startClawChats(ctx, api),
+            stop: (ctx) => stopClawChats(ctx),
         });
         // CLI commands
         api.registerCli((ctx) => {
-            const cmd = ctx.program.command('shellchats');
+            const cmd = ctx.program.command('clawchats');
             cmd.command('setup <token>')
-                .description('Set up ShellChats with a setup token')
+                .description('Set up ClawChats with a setup token')
                 .action((token) => handleSetup(String(token)));
             cmd.command('status')
-                .description('Show ShellChats connection status')
+                .description('Show ClawChats connection status')
                 .action(() => handleStatus());
             cmd.command('reset')
-                .description('Disconnect and remove all ShellChats data')
+                .description('Disconnect and remove all ClawChats data')
                 .action(() => handleReset());
             cmd.command('import <path>')
                 .description('Import databases and config from a folder (e.g. migrate from old data directory)')
@@ -632,8 +671,8 @@ const plugin = {
         });
         // Slash command for status from any channel
         api.registerCommand({
-            name: 'shellchats',
-            description: 'Show ShellChats tunnel status',
+            name: 'clawchats',
+            description: 'Show ClawChats tunnel status',
             handler: () => ({ text: formatStatus() }),
         });
     },

package/dist/migrate.d.ts

@@ -1,5 +1,5 @@
 /**
- * Schema migration runner for the ShellChat plugin SQLite database.
+ * Schema migration runner for the ClawChats plugin SQLite database.
  *
  * - Tracks schema version in a `_schema_version` table
  * - Runs migrations sequentially from current version to target

package/dist/migrate.js

@@ -1,5 +1,5 @@
 /**
- * Schema migration runner for the ShellChat plugin SQLite database.
+ * Schema migration runner for the ClawChats plugin SQLite database.
  *
  * - Tracks schema version in a `_schema_version` table
  * - Runs migrations sequentially from current version to target

package/dist/shim.js

@@ -46,7 +46,7 @@ class FakeReq extends Readable {
             }
             else if (parsed && parsed['_multipart']) {
                 // Multipart form data: { _multipart: true, fields: { key: string | { filename, contentType, data } } }
-                const boundary = '----ShellChatBoundary' + Date.now();
+                const boundary = '----ClawChatsBoundary' + Date.now();
                 this.headers['content-type'] = `multipart/form-data; boundary=${boundary}`;
                 const fields = parsed['fields'] || {};
                 const parts = [];

package/dist/signaling-client.d.ts

@@ -1,5 +1,5 @@
 /**
- * SignalingClient — persistent WSS connection to the ShellChat signaling server.
+ * SignalingClient — persistent WSS connection to the ClawChats signaling server.
  *
  * Responsibilities:
  * - Authenticate with the signaling server on connect (gateway-auth)

package/dist/signaling-client.js

@@ -1,5 +1,5 @@
 /**
- * SignalingClient — persistent WSS connection to the ShellChat signaling server.
+ * SignalingClient — persistent WSS connection to the ClawChats signaling server.
  *
  * Responsibilities:
  * - Authenticate with the signaling server on connect (gateway-auth)

package/dist/webrtc-peer.d.ts

@@ -109,7 +109,7 @@ export declare class WebRTCPeerManager extends EventEmitter {
     handleIceCandidate(connectionId: string, candidate: unknown): void;
     /**
      * Close all active peer connections and DataChannels.
-     * Called during plugin shutdown (stopShellChat).
+     * Called during plugin shutdown (stopClawChats).
      */
     closeAll(): void;
     /**

package/dist/webrtc-peer.js

@@ -194,7 +194,7 @@ export class WebRTCPeerManager extends EventEmitter {
     }
     /**
      * Close all active peer connections and DataChannels.
-     * Called during plugin shutdown (stopShellChat).
+     * Called during plugin shutdown (stopClawChats).
      */
     closeAll() {
         console.log(`[WebRTCPeerManager] Closing all connections (${this.peerConnections.size} peers, ${this.activeChannels.size} channels)`);

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "connector",
-  "name": "ShellChats",
-  "description": "Connects your OpenClaw gateway to ShellChats via WebRTC P2P",
+  "name": "ClawChats",
+  "description": "Connects your OpenClaw gateway to ClawChats via WebRTC P2P",
   "kind": "integration",
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@clawchatsai/connector",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "type": "module",
-  "description": "ShellChat OpenClaw plugin — P2P tunnel + local API bridge",
+  "description": "ClawChats OpenClaw plugin — P2P tunnel + local API bridge",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [

package/server.js

@@ -1,4 +1,4 @@
-// ShellChat Backend Server
+// ClawChats Backend Server
 // Single-file Node.js HTTP server with SQLite storage
 // See specs/backend-session-architecture.md for full spec
 
@@ -64,7 +64,7 @@ function _buildDeviceAuth(identity, { clientId, clientMode, role, scopes, token,
 
 // ─── Configuration ──────────────────────────────────────────────────────────
 
-const PORT = parseInt(process.env.SHELLCHAT_PORT || '3001', 10);
+const PORT = parseInt(process.env.CLAWCHATS_PORT || process.env.SHELLCHAT_PORT || '3001', 10);
 const DATA_DIR = path.join(__dirname, 'data');
 const UPLOADS_DIR = path.join(__dirname, 'uploads');
 const WORKSPACES_FILE = path.join(DATA_DIR, 'workspaces.json');
@@ -174,9 +174,9 @@ function parseConfigField(field) {
 }
 
 // Load auth token from config.js or env var
-let AUTH_TOKEN = process.env.SHELLCHAT_AUTH_TOKEN || parseConfigField('authToken') || '';
+let AUTH_TOKEN = process.env.CLAWCHATS_AUTH_TOKEN || process.env.SHELLCHAT_AUTH_TOKEN || parseConfigField('authToken') || '';
 if (!AUTH_TOKEN) {
-  console.error('WARNING: No auth token configured. Set SHELLCHAT_AUTH_TOKEN or create config.js');
+  console.error('WARNING: No auth token configured. Set CLAWCHATS_AUTH_TOKEN or create config.js');
 }
 
 // Load gateway WebSocket URL
@@ -883,7 +883,7 @@ async function handleMarkMessagesRead(req, res, params) {
   // Broadcast unread-update to ALL browser clients (so other tabs/devices sync)
   const workspace = getWorkspaces().active;
   gatewayClient.broadcastToBrowsers(JSON.stringify({
-    type: 'shellchat',
+    type: 'clawchats',
     event: 'unread-update',
     workspace,
     threadId,
@@ -2369,7 +2369,7 @@ class GatewayClient {
 
   saveAssistantMessage(sessionKey, message, seq) {
     const parsed = parseSessionKey(sessionKey);
-    if (!parsed) return; // Non-ShellChat session key, silently ignore
+    if (!parsed) return; // Non-ClawChats session key, silently ignore
 
     // Guard: verify workspace still exists
     const ws = getWorkspaces();
@@ -2424,7 +2424,7 @@ class GatewayClient {
 
       // Broadcast message-saved for active thread reload
       this.broadcastToBrowsers(JSON.stringify({
-        type: 'shellchat',
+        type: 'clawchats',
         event: 'message-saved',
         threadId: parsed.threadId,
         workspace: parsed.workspace,
@@ -2438,7 +2438,7 @@ class GatewayClient {
       // Always broadcast unread-update — browser sends read receipts to clear
       const workspaceUnreadTotal = db.prepare('SELECT COALESCE(SUM(unread_count), 0) as total FROM threads').get().total;
       this.broadcastToBrowsers(JSON.stringify({
-        type: 'shellchat',
+        type: 'clawchats',
         event: 'unread-update',
         workspace: parsed.workspace,
         threadId: parsed.threadId,
@@ -2616,7 +2616,7 @@ class GatewayClient {
     if (!parsed) return;
 
     this.broadcastToBrowsers(JSON.stringify({
-      type: 'shellchat',
+      type: 'clawchats',
       event: 'agent-activity',
       workspace: parsed.workspace,
       threadId: parsed.threadId,
@@ -2761,7 +2761,7 @@ class GatewayClient {
 
             // Notify browsers to re-render this message with activity data
             this.broadcastToBrowsers(JSON.stringify({
-              type: 'shellchat',
+              type: 'clawchats',
               event: 'activity-saved',
               workspace: parsed.workspace,
               threadId: parsed.threadId,
@@ -2844,7 +2844,7 @@ class GatewayClient {
 
   broadcastGatewayStatus(connected) {
     const msg = JSON.stringify({
-      type: 'shellchat',
+      type: 'clawchats',
       event: 'gateway-status',
       connected
     });
@@ -2873,7 +2873,7 @@ class GatewayClient {
     // Send current gateway status
     if (ws.readyState === WS.OPEN) {
       ws.send(JSON.stringify({
-        type: 'shellchat',
+        type: 'clawchats',
         event: 'gateway-status',
         connected: this.connected
       }));
@@ -2887,7 +2887,7 @@ class GatewayClient {
       }
       if (streams.length > 0) {
         ws.send(JSON.stringify({
-          type: 'shellchat',
+          type: 'clawchats',
           event: 'stream-sync',
           streams
         }));
@@ -2924,7 +2924,7 @@ class GatewayClient {
           // Broadcast unread-update clear to ALL browser clients
           const workspaceUnreadTotal = db.prepare('SELECT COALESCE(SUM(unread_count), 0) as total FROM threads').get().total;
           this.broadcastToBrowsers(JSON.stringify({
-            type: 'shellchat',
+            type: 'clawchats',
             event: 'unread-update',
             workspace,
             threadId,
@@ -2952,7 +2952,7 @@ function syncThreadUnreadCount(db, threadId) {
 function parseSessionKey(sessionKey) {
   if (!sessionKey) return null;
   const match = sessionKey.match(/^agent:main:([^:]+):chat:([^:]+)$/);
-  if (!match) return null; // Non-ShellChat keys — silently ignore
+  if (!match) return null; // Non-ClawChats keys — silently ignore
   return { workspace: match[1], threadId: match[2] };
 }
 
@@ -2973,7 +2973,7 @@ const gatewayClient = new GatewayClient();
 
 // ─── createApp Factory ───────────────────────────────────────────────────────
 // Returns an isolated instance of the app state + handlers.
-// Used by the plugin (signaling/index.js) to embed ShellChat logic without
+// Used by the plugin (signaling/index.js) to embed ClawChats logic without
 // spinning up a standalone HTTP server.
 
 export function createApp(config = {}) {
@@ -2986,7 +2986,7 @@ export function createApp(config = {}) {
 
   let _AUTH_TOKEN = config.authToken !== undefined
     ? config.authToken
-    : (process.env.SHELLCHAT_AUTH_TOKEN || parseConfigField('authToken') || '');
+    : (process.env.CLAWCHATS_AUTH_TOKEN || process.env.SHELLCHAT_AUTH_TOKEN || parseConfigField('authToken') || '');
 
   // Separate token for gateway WS auth (falls back to _AUTH_TOKEN for direct mode)
   const _GATEWAY_TOKEN = config.gatewayToken !== undefined
@@ -3232,7 +3232,7 @@ export function createApp(config = {}) {
     const remaining = syncThreadUnreadCount(db, threadId);
     const workspace = _getWorkspaces().active;
     _gatewayClient.broadcastToBrowsers(JSON.stringify({
-      type: 'shellchat', event: 'unread-update', workspace, threadId,
+      type: 'clawchats', event: 'unread-update', workspace, threadId,
       action: 'read', messageIds, unreadCount: remaining, timestamp: Date.now()
     }));
     send(res, 200, { unread_count: remaining });
@@ -3679,9 +3679,9 @@ export function createApp(config = {}) {
         const threadInfo = db.prepare('SELECT title FROM threads WHERE id = ?').get(parsed.threadId);
         const unreadCount = db.prepare('SELECT COUNT(*) as c FROM unread_messages WHERE thread_id = ?').get(parsed.threadId).c;
         const preview = content.length > 120 ? content.substring(0, 120) + '...' : content;
-        this.broadcastToBrowsers(JSON.stringify({ type: 'shellchat', event: 'message-saved', threadId: parsed.threadId, workspace: parsed.workspace, messageId, timestamp: now, title: threadInfo?.title || 'Chat', preview, unreadCount }));
+        this.broadcastToBrowsers(JSON.stringify({ type: 'clawchats', event: 'message-saved', threadId: parsed.threadId, workspace: parsed.workspace, messageId, timestamp: now, title: threadInfo?.title || 'Chat', preview, unreadCount }));
         const workspaceUnreadTotal = db.prepare('SELECT COALESCE(SUM(unread_count), 0) as total FROM threads').get().total;
-        this.broadcastToBrowsers(JSON.stringify({ type: 'shellchat', event: 'unread-update', workspace: parsed.workspace, threadId: parsed.threadId, messageId, action: 'new', unreadCount, workspaceUnreadTotal, title: threadInfo?.title || 'Chat', preview, timestamp: now }));
+        this.broadcastToBrowsers(JSON.stringify({ type: 'clawchats', event: 'unread-update', workspace: parsed.workspace, threadId: parsed.threadId, messageId, action: 'new', unreadCount, workspaceUnreadTotal, title: threadInfo?.title || 'Chat', preview, timestamp: now }));
         console.log(`Saved assistant message to ${parsed.workspace}/${parsed.threadId} (seq: ${seq})`);
       } catch (e) { console.error(`Failed to save assistant message:`, e.message); }
     }
@@ -3759,7 +3759,7 @@ export function createApp(config = {}) {
     broadcastActivityUpdate(runId, log) {
       const parsed = log.sessionKey ? parseSessionKey(log.sessionKey) : null;
       if (!parsed) return;
-      this.broadcastToBrowsers(JSON.stringify({ type: 'shellchat', event: 'agent-activity', workspace: parsed.workspace, threadId: parsed.threadId, runId, steps: log.steps, summary: this.generateActivitySummary(log.steps) }));
+      this.broadcastToBrowsers(JSON.stringify({ type: 'clawchats', event: 'agent-activity', workspace: parsed.workspace, threadId: parsed.threadId, runId, steps: log.steps, summary: this.generateActivitySummary(log.steps) }));
     }
 
     finalizeActivityLog(runId, log) {
@@ -3824,7 +3824,7 @@ export function createApp(config = {}) {
               metadata.activitySummary = this.generateActivitySummary(log.steps);
               db.prepare('UPDATE messages SET metadata = ? WHERE id = ?').run(JSON.stringify(metadata), msg.id);
               console.log(`[ActivityLog] Saved ${toolSteps.length} tool steps for message ${msg.id}`);
-              this.broadcastToBrowsers(JSON.stringify({ type: 'shellchat', event: 'activity-saved', workspace: parsed.workspace, threadId: parsed.threadId, messageId: msg.id }));
+              this.broadcastToBrowsers(JSON.stringify({ type: 'clawchats', event: 'activity-saved', workspace: parsed.workspace, threadId: parsed.threadId, messageId: msg.id }));
             }
           }
         } catch (e) { console.error('Failed to save activity log:', e.message); }
@@ -3864,7 +3864,7 @@ export function createApp(config = {}) {
     }
 
     broadcastGatewayStatus(connected) {
-      this.broadcastToBrowsers(JSON.stringify({ type: 'shellchat', event: 'gateway-status', connected }));
+      this.broadcastToBrowsers(JSON.stringify({ type: 'clawchats', event: 'gateway-status', connected }));
     }
 
     sendToGateway(data) {
@@ -3883,12 +3883,12 @@ export function createApp(config = {}) {
     addBrowserClient(ws) {
       this.browserClients.set(ws, { activeWorkspace: null, activeThreadId: null });
       if (ws.readyState === WS.OPEN) {
-        ws.send(JSON.stringify({ type: 'shellchat', event: 'gateway-status', connected: this.connected }));
+        ws.send(JSON.stringify({ type: 'clawchats', event: 'gateway-status', connected: this.connected }));
         const streams = [];
         for (const [sessionKey, state] of this.streamState.entries()) {
           if (state.state === 'streaming') streams.push({ sessionKey, threadId: state.threadId, buffer: state.buffer });
         }
-        if (streams.length > 0) ws.send(JSON.stringify({ type: 'shellchat', event: 'stream-sync', streams }));
+        if (streams.length > 0) ws.send(JSON.stringify({ type: 'clawchats', event: 'stream-sync', streams }));
       }
     }
 
@@ -3908,7 +3908,7 @@ export function createApp(config = {}) {
           if (deleted.changes > 0) {
             syncThreadUnreadCount(db, threadId);
             const workspaceUnreadTotal = db.prepare('SELECT COALESCE(SUM(unread_count), 0) as total FROM threads').get().total;
-            this.broadcastToBrowsers(JSON.stringify({ type: 'shellchat', event: 'unread-update', workspace, threadId, action: 'clear', unreadCount: 0, workspaceUnreadTotal, timestamp: Date.now() }));
+            this.broadcastToBrowsers(JSON.stringify({ type: 'clawchats', event: 'unread-update', workspace, threadId, action: 'clear', unreadCount: 0, workspaceUnreadTotal, timestamp: Date.now() }));
           }
         } catch (e) { console.error('Failed to auto-clear unreads on active-thread:', e.message); }
       }
@@ -4024,7 +4024,7 @@ export function createApp(config = {}) {
             const token = msg.params?.auth?.token;
             if (token === _AUTH_TOKEN || !_AUTH_TOKEN) {
               console.log('Browser client authenticated');
-              ws.send(JSON.stringify({ type: 'res', id: msg.id, ok: true, payload: { type: 'hello-ok', protocol: 3, server: { version: '0.1.0', host: 'shellchat-backend' } } }));
+              ws.send(JSON.stringify({ type: 'res', id: msg.id, ok: true, payload: { type: 'hello-ok', protocol: 3, server: { version: '0.1.0', host: 'clawchats-backend' } } }));
             } else {
               console.log('Browser client auth failed');
               ws.send(JSON.stringify({ type: 'res', id: msg.id, ok: false, error: { code: 'AUTH_FAILED', message: 'Invalid auth token' } }));
@@ -4032,12 +4032,12 @@ export function createApp(config = {}) {
             }
             return;
           }
-          if (msg.type === 'shellchat') {
+          if (msg.type === 'clawchats' || msg.type === 'shellchat') { // backward compat: accept legacy 'shellchat' type
             if (msg.action === 'active-thread') { _gatewayClient.setActiveThread(ws, msg.workspace, msg.threadId); console.log(`Browser client set active thread: ${msg.workspace}/${msg.threadId}`); return; }
-            if (msg.action === 'debug-start') { const result = _debugLogger.start(msg.ts, ws); if (result.error === 'already-active') ws.send(JSON.stringify({ type: 'shellchat', event: 'debug-error', error: 'Recording already active in another tab', sessionId: result.sessionId })); else ws.send(JSON.stringify({ type: 'shellchat', event: 'debug-started', sessionId: result.sessionId })); return; }
-            if (msg.action === 'debug-dump') { const { sessionId, files } = _debugLogger.saveDump(msg); ws.send(JSON.stringify({ type: 'shellchat', event: 'debug-saved', sessionId, files })); return; }
+            if (msg.action === 'debug-start') { const result = _debugLogger.start(msg.ts, ws); if (result.error === 'already-active') ws.send(JSON.stringify({ type: 'clawchats', event: 'debug-error', error: 'Recording already active in another tab', sessionId: result.sessionId })); else ws.send(JSON.stringify({ type: 'clawchats', event: 'debug-started', sessionId: result.sessionId })); return; }
+            if (msg.action === 'debug-dump') { const { sessionId, files } = _debugLogger.saveDump(msg); ws.send(JSON.stringify({ type: 'clawchats', event: 'debug-saved', sessionId, files })); return; }
           }
-        } catch { /* Not JSON or not a ShellChat message, forward to gateway */ }
+        } catch { /* Not JSON or not a ClawChats message, forward to gateway */ }
         _gatewayClient.sendToGateway(msgStr);
       });
 
@@ -4086,7 +4086,7 @@ if (isDirectRun) {
   });
 
   server.listen(PORT, () => {
-    console.log(`ShellChat backend listening on port ${PORT}`);
+    console.log(`ClawChats backend listening on port ${PORT}`);
     console.log(`Active workspace: ${app.getWorkspaces().active}`);
     console.log(`Data dir: ${app.dataDir}`);