@openclaw-cloud/agent-controller 0.1.8 → 0.2.1

package/src/index.ts

@@ -22,14 +22,12 @@ export function main(): void {
   const token = requireEnv('AGENT_TOKEN');
   const agentId = requireEnv('AGENT_ID');
   const backendUrl = requireEnv('BACKEND_INTERNAL_URL');
-  const centrifugoInternalUrl = process.env.CENTRIFUGO_INTERNAL_URL || '';
-  const centrifugoApiKey = process.env.CENTRIFUGO_API_KEY || '';
-
   if (DEBUG) console.log('[debug] Debug mode enabled');
   console.log(`Starting agent-controller for agent: ${agentId}`);
   console.log(`Backend URL: ${backendUrl} (JWT mode)`);
 
-  const { client } = createConnection({ url, token, agentId, backendUrl });
+  const api = createAgentApi(backendUrl, token);
+  const { client } = createConnection({ url, token, agentId, backendUrl, api });
 
   // Chat provider via OpenClaw Gateway WS
   const gatewayWsUrl = process.env.OPENCLAW_GATEWAY_WS || 'ws://localhost:18789';
@@ -46,50 +44,39 @@ export function main(): void {
     console.warn('OPENCLAW_GATEWAY_TOKEN not set, chat provider disabled');
   }
 
-  // Board handler (optional — requires BACKEND_URL and AGENT_TOKEN)
-  let boardHandler: BoardHandler | null = null;
-  const apiBaseUrl = process.env.BACKEND_URL || backendUrl;
-  if (apiBaseUrl && token) {
-    const api = createAgentApi(apiBaseUrl, token);
-    boardHandler = new BoardHandler(api);
+  // Board handler
+  const boardHandler = new BoardHandler(api);
 
-    // Initialize board handler after connection is established
-    boardHandler.initialize().then((workspaceId) => {
-      if (!workspaceId) {
-        console.log('No board found for this agent, board handler dormant');
-        return;
-      }
+  // Initialize board handler after connection is established
+  boardHandler.initialize().then((workspaceId) => {
+    if (!workspaceId) {
+      console.log('No board found for this agent, board handler dormant');
+      return;
+    }
 
-      const boardChannel = `board:${workspaceId}`;
-      const boardSub = client.newSubscription(boardChannel);
+    const boardChannel = `board:${workspaceId}`;
+    const boardSub = client.newSubscription(boardChannel);
 
-      boardSub.on('publication', (ctx) => {
-        const event = ctx.data as BoardEvent;
-        if (!event || !event.event) return;
-        boardHandler!.onBoardEvent(event).catch((err) => {
-          console.error('Board event handler error:', err instanceof Error ? err.message : err);
-        });
+    boardSub.on('publication', (ctx) => {
+      const event = ctx.data as BoardEvent;
+      if (!event || !event.event) return;
+      boardHandler.onBoardEvent(event).catch((err) => {
+        console.error('Board event handler error:', err instanceof Error ? err.message : err);
       });
-
-      boardSub.subscribe();
-      console.log(`Subscribed to board channel: ${boardChannel}`);
-    }).catch((err) => {
-      console.error('Board handler init error:', err instanceof Error ? err.message : err);
     });
-  }
 
-  let heartbeatTimer: NodeJS.Timeout | undefined;
-  if (centrifugoInternalUrl && centrifugoApiKey) {
-    console.log(`Heartbeat via Centrifugo internal API: ${centrifugoInternalUrl}`);
-    heartbeatTimer = startHeartbeat({
-      centrifugoInternalUrl,
-      centrifugoApiKey,
-      agentId,
-      ...(boardHandler ? { getBoardStatus: () => boardHandler!.getBoardStatus() } : {}),
-    });
-  } else {
-    console.warn('CENTRIFUGO_INTERNAL_URL or CENTRIFUGO_API_KEY not set, heartbeat disabled');
-  }
+    boardSub.subscribe();
+    console.log(`Subscribed to board channel: ${boardChannel}`);
+  }).catch((err) => {
+    console.error('Board handler init error:', err instanceof Error ? err.message : err);
+  });
+
+  console.log('Heartbeat via backend API');
+  const heartbeatTimer = startHeartbeat({
+    api,
+    agentId,
+    getBoardStatus: () => boardHandler.getBoardStatus(),
+  });
 
   const shutdown = () => {
     console.log('Shutting down...');

package/src/platform/linux.ts

@@ -0,0 +1,108 @@
+import { exec } from 'node:child_process';
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+export interface PlatformConfig {
+  centrifugoUrl: string;
+  agentToken: string;
+  agentId: string;
+  backendInternalUrl: string;
+}
+
+function execAsync(cmd: string): Promise<string> {
+  return new Promise((resolve, reject) => {
+    exec(cmd, (err, stdout) => {
+      if (err) reject(err);
+      else resolve(stdout.toString().trim());
+    });
+  });
+}
+
+async function which(bin: string): Promise<string> {
+  try {
+    return await execAsync(`which "${bin}"`);
+  } catch {
+    return '';
+  }
+}
+
+export async function installLinux(config: PlatformConfig): Promise<void> {
+  const home = homedir();
+  const systemdDir = join(home, '.config', 'systemd', 'user');
+  const servicePath = join(systemdDir, 'agent-controller.service');
+
+  const nodePath = process.execPath;
+  let agentControllerPath = await which('agent-controller');
+  if (!agentControllerPath) {
+    agentControllerPath = join(nodePath, '..', 'agent-controller');
+  }
+
+  mkdirSync(systemdDir, { recursive: true });
+
+  const service = `[Unit]
+Description=OpenClaw Agent Controller
+After=network.target
+
+[Service]
+Type=simple
+Restart=always
+RestartSec=10
+Environment=CENTRIFUGO_URL=${config.centrifugoUrl}
+Environment=AGENT_TOKEN=${config.agentToken}
+Environment=AGENT_ID=${config.agentId}
+Environment=BACKEND_INTERNAL_URL=${config.backendInternalUrl}
+ExecStart="${nodePath}" "${agentControllerPath}"
+
+[Install]
+WantedBy=default.target
+`;
+
+  writeFileSync(servicePath, service, 'utf8');
+  console.log(`Written: ${servicePath}`);
+
+  try {
+    await execAsync('systemctl --user daemon-reload');
+    console.log('systemd daemon reloaded.');
+    await execAsync('systemctl --user enable --now agent-controller');
+    console.log('Service enabled and started.');
+  } catch (err) {
+    console.warn('systemctl command failed:', err instanceof Error ? err.message : err);
+  }
+
+  console.log('');
+  console.log('Agent Controller installed as a systemd user service.');
+  console.log('');
+  console.log('Useful commands:');
+  console.log('  Start:     systemctl --user start agent-controller');
+  console.log('  Stop:      systemctl --user stop agent-controller');
+  console.log('  Status:    systemctl --user status agent-controller');
+  console.log('  Logs:      journalctl --user -u agent-controller -f');
+  console.log('  Uninstall: agent-controller uninstall');
+}
+
+export async function uninstallLinux(): Promise<void> {
+  try {
+    await execAsync('systemctl --user disable --now agent-controller');
+    console.log('Service disabled and stopped.');
+  } catch (err) {
+    console.warn('systemctl disable failed (may not be enabled):', err instanceof Error ? err.message : err);
+  }
+
+  const servicePath = join(homedir(), '.config', 'systemd', 'user', 'agent-controller.service');
+  const { unlinkSync, existsSync } = await import('node:fs');
+  if (existsSync(servicePath)) {
+    unlinkSync(servicePath);
+    console.log(`Removed: ${servicePath}`);
+  } else {
+    console.log(`Service file not found: ${servicePath}`);
+  }
+
+  try {
+    await execAsync('systemctl --user daemon-reload');
+  } catch {
+    // best-effort
+  }
+
+  console.log('Agent Controller uninstalled.');
+}

package/src/platform/macos.ts

@@ -0,0 +1,122 @@
+import { exec } from 'node:child_process';
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+export interface PlatformConfig {
+  centrifugoUrl: string;
+  agentToken: string;
+  agentId: string;
+  backendInternalUrl: string;
+}
+
+function execAsync(cmd: string): Promise<string> {
+  return new Promise((resolve, reject) => {
+    exec(cmd, (err, stdout) => {
+      if (err) reject(err);
+      else resolve(stdout.toString().trim());
+    });
+  });
+}
+
+async function which(bin: string): Promise<string> {
+  try {
+    return await execAsync(`which "${bin}"`);
+  } catch {
+    return '';
+  }
+}
+
+export async function installMacOS(config: PlatformConfig): Promise<void> {
+  const home = homedir();
+  const launchAgentsDir = join(home, 'Library', 'LaunchAgents');
+  const plistPath = join(launchAgentsDir, 'com.openclaw.agent-controller.plist');
+  const logDir = join(home, 'Library', 'Logs');
+  const logFile = join(logDir, 'agent-controller.log');
+  const errFile = join(logDir, 'agent-controller.err');
+
+  const nodePath = process.execPath;
+  let agentControllerPath = await which('agent-controller');
+  if (!agentControllerPath) {
+    // Fallback: derive from node path
+    agentControllerPath = join(nodePath, '..', 'agent-controller');
+  }
+
+  mkdirSync(launchAgentsDir, { recursive: true });
+
+  const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.openclaw.agent-controller</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${nodePath}</string>
+    <string>${agentControllerPath}</string>
+  </array>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>CENTRIFUGO_URL</key>
+    <string>${config.centrifugoUrl}</string>
+    <key>AGENT_TOKEN</key>
+    <string>${config.agentToken}</string>
+    <key>AGENT_ID</key>
+    <string>${config.agentId}</string>
+    <key>BACKEND_INTERNAL_URL</key>
+    <string>${config.backendInternalUrl}</string>
+  </dict>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${logFile}</string>
+  <key>StandardErrorPath</key>
+  <string>${errFile}</string>
+</dict>
+</plist>
+`;
+
+  writeFileSync(plistPath, plist, 'utf8');
+  console.log(`Written: ${plistPath}`);
+
+  try {
+    await execAsync(`launchctl load -w "${plistPath}"`);
+    console.log('Service loaded via launchctl.');
+  } catch (err) {
+    console.warn('launchctl load failed (may already be loaded):', err instanceof Error ? err.message : err);
+  }
+
+  console.log('');
+  console.log('Agent Controller installed as a macOS LaunchAgent.');
+  console.log('');
+  console.log('Useful commands:');
+  console.log(`  Start:     launchctl load -w "${plistPath}"`);
+  console.log(`  Stop:      launchctl unload "${plistPath}"`);
+  console.log(`  Logs:      tail -f "${logFile}"`);
+  console.log(`  Errors:    tail -f "${errFile}"`);
+  console.log(`  Uninstall: agent-controller uninstall`);
+}
+
+export async function uninstallMacOS(): Promise<void> {
+  const home = homedir();
+  const plistPath = join(home, 'Library', 'LaunchAgents', 'com.openclaw.agent-controller.plist');
+
+  try {
+    await execAsync(`launchctl unload "${plistPath}"`);
+    console.log('Service unloaded via launchctl.');
+  } catch (err) {
+    console.warn('launchctl unload failed (may not be loaded):', err instanceof Error ? err.message : err);
+  }
+
+  const { unlinkSync, existsSync } = await import('node:fs');
+  if (existsSync(plistPath)) {
+    unlinkSync(plistPath);
+    console.log(`Removed: ${plistPath}`);
+  } else {
+    console.log(`Plist not found: ${plistPath}`);
+  }
+
+  console.log('Agent Controller uninstalled.');
+}

package/src/platform/windows.ts

@@ -0,0 +1,92 @@
+import { exec } from 'node:child_process';
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+
+export interface PlatformConfig {
+  centrifugoUrl: string;
+  agentToken: string;
+  agentId: string;
+  backendInternalUrl: string;
+}
+
+function execAsync(cmd: string): Promise<string> {
+  return new Promise((resolve, reject) => {
+    exec(cmd, (err, stdout) => {
+      if (err) reject(err);
+      else resolve(stdout.toString().trim());
+    });
+  });
+}
+
+async function which(bin: string): Promise<string> {
+  try {
+    return await execAsync(`where "${bin}"`);
+  } catch {
+    return '';
+  }
+}
+
+export async function installWindows(config: PlatformConfig): Promise<void> {
+  const appData = process.env['APPDATA'] ?? join(process.env['USERPROFILE'] ?? 'C:\\Users\\Default', 'AppData', 'Roaming');
+  const openclawDir = join(appData, 'openclaw');
+  const wrapperPath = join(openclawDir, 'agent-controller.cmd');
+
+  const nodePath = process.execPath;
+  let agentControllerPath = await which('agent-controller');
+  if (!agentControllerPath) {
+    agentControllerPath = join(nodePath, '..', 'agent-controller');
+  }
+
+  mkdirSync(openclawDir, { recursive: true });
+
+  const wrapper = `@echo off
+set CENTRIFUGO_URL=${config.centrifugoUrl}
+set AGENT_TOKEN=${config.agentToken}
+set AGENT_ID=${config.agentId}
+set BACKEND_INTERNAL_URL=${config.backendInternalUrl}
+"${nodePath}" "${agentControllerPath}"
+`;
+
+  writeFileSync(wrapperPath, wrapper, 'utf8');
+  console.log(`Written: ${wrapperPath}`);
+
+  try {
+    await execAsync(
+      `schtasks /create /tn "OpenClaw Agent Controller" /tr "${wrapperPath}" /sc ONLOGON /rl HIGHEST /f`
+    );
+    console.log('Scheduled task created.');
+  } catch (err) {
+    console.warn('schtasks create failed:', err instanceof Error ? err.message : err);
+  }
+
+  console.log('');
+  console.log('Agent Controller installed as a Windows scheduled task (ONLOGON).');
+  console.log('');
+  console.log('Useful commands:');
+  console.log('  Start:     schtasks /run /tn "OpenClaw Agent Controller"');
+  console.log('  Stop:      schtasks /end /tn "OpenClaw Agent Controller"');
+  console.log('  Uninstall: agent-controller uninstall');
+  console.log(`  Wrapper:   ${wrapperPath}`);
+}
+
+export async function uninstallWindows(): Promise<void> {
+  try {
+    await execAsync('schtasks /delete /tn "OpenClaw Agent Controller" /f');
+    console.log('Scheduled task deleted.');
+  } catch (err) {
+    console.warn('schtasks delete failed (may not exist):', err instanceof Error ? err.message : err);
+  }
+
+  const appData = process.env['APPDATA'] ?? join(process.env['USERPROFILE'] ?? 'C:\\Users\\Default', 'AppData', 'Roaming');
+  const wrapperPath = join(appData, 'openclaw', 'agent-controller.cmd');
+
+  const { unlinkSync, existsSync } = await import('node:fs');
+  if (existsSync(wrapperPath)) {
+    unlinkSync(wrapperPath);
+    console.log(`Removed: ${wrapperPath}`);
+  } else {
+    console.log(`Wrapper not found: ${wrapperPath}`);
+  }
+
+  console.log('Agent Controller uninstalled.');
+}