@openclaw-cloud/agent-controller 0.2.0 → 0.2.2

package/CLAUDE.md

@@ -91,7 +91,7 @@ src/
 
 ### Command dispatch flow
 ```
-Centrifugo WS message → connection.ts (handler map) → handlers/<type>.ts → AgentResponse → publish back
+Centrifugo WS message → connection.ts (handler map) → handlers/<type>.ts → AgentResponse → POST /api/internal/agent-response
 ```
 
 Handler map in `connection.ts`:
@@ -132,13 +132,16 @@ Agent-controller is a Node.js process that runs inside every agent container (K8
 ### Communication Flow
 ```
 Backend → Centrifugo WS (port 8000) → agent-controller → local agent process
-agent-controller → Centrifugo HTTP API (port 9000) → Backend (heartbeat processing)
+agent-controller → Backend HTTP API → /api/internal/agent-response  (command responses)
+agent-controller → Backend HTTP API → /api/internal/agent-heartbeat  (heartbeat)
 ```
 
+Centrifugo WS is **read-only** from agent-controller's perspective — all outbound traffic goes through the backend HTTP API, not directly to Centrifugo.
+
 ### Key Components
-- **WebSocket client** — Connects to Centrifugo, subscribes to agent channel
-- **Heartbeat publisher** — Sends periodic heartbeats via Centrifugo HTTP API (server-side publish)
-- **Command handlers** — Processes commands from backend (backup, reconfigure, etc.)
+- **WebSocket client** — Connects to Centrifugo, subscribes to agent channel (read-only)
+- **Heartbeat publisher** — Sends periodic heartbeats via `POST /api/internal/agent-heartbeat`
+- **Command handlers** — Processes commands from backend, sends responses via `POST /api/internal/agent-response`
 - **Board handler** — Kanban board integration (claim cards, move cards, report status)
 - **JWT auth** — Fetches JWT from backend's `/api/internal/centrifugo-token` endpoint, auto-refreshes before expiry (24h TTL)
 
@@ -146,9 +149,7 @@ agent-controller → Centrifugo HTTP API (port 9000) → Backend (heartbeat proc
 - `AGENT_ID` — UUID of this agent
 - `AGENT_TOKEN` — Internal auth token
 - `CENTRIFUGO_URL` — WebSocket URL (port 8000, converted from http→ws)
-- `CENTRIFUGO_INTERNAL_URL` — HTTP API URL (port 9000) for server-side publish
-- `CENTRIFUGO_API_KEY` — API key for HTTP API auth
-- `API_BASE_URL` — Backend API URL for JWT fetch
+- `API_BASE_URL` — Backend API URL (JWT fetch, agent responses, heartbeat)
 
 ### Deployment
 

package/bin/agent-controller.js

@@ -14,6 +14,12 @@ if (command === '--version' || command === '-v') {
 } else if (command === 'self-update') {
   const { selfUpdate } = await import('../dist/commands/self-update.js');
   await selfUpdate(pkg.version);
+} else if (command === 'install') {
+  const { install } = await import('../dist/commands/install.js');
+  await install();
+} else if (command === 'uninstall') {
+  const { uninstall } = await import('../dist/commands/uninstall.js');
+  await uninstall();
 } else {
   const { main } = await import('../dist/index.js');
   main();

package/dist/commands/install.d.ts

@@ -0,0 +1 @@
+export declare function install(): Promise<void>;

package/dist/commands/install.js

@@ -0,0 +1,54 @@
+import { createInterface } from 'node:readline';
+async function prompt(rl, question) {
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            resolve(answer.trim());
+        });
+    });
+}
+async function getOrPrompt(rl, envKey, question) {
+    const fromEnv = process.env[envKey];
+    if (fromEnv) {
+        const display = envKey.includes('TOKEN') ? '***' : fromEnv;
+        console.log(`  ${envKey}: ${display} (from environment)`);
+        return fromEnv;
+    }
+    return prompt(rl, question);
+}
+export async function install() {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    console.log('OpenClaw Agent Controller — Installation Wizard');
+    console.log('================================================');
+    console.log('');
+    const centrifugoUrl = await getOrPrompt(rl, 'CENTRIFUGO_URL', 'CENTRIFUGO_URL (e.g. wss://ws.openclaw-cloud.io): ');
+    const agentToken = await getOrPrompt(rl, 'AGENT_TOKEN', 'AGENT_TOKEN: ');
+    const agentId = await getOrPrompt(rl, 'AGENT_ID', 'AGENT_ID: ');
+    const backendInternalUrl = await getOrPrompt(rl, 'BACKEND_INTERNAL_URL', 'BACKEND_INTERNAL_URL (e.g. https://api.openclaw-cloud.io): ');
+    rl.close();
+    if (!centrifugoUrl || !agentToken || !agentId || !backendInternalUrl) {
+        console.error('All fields are required. Aborting.');
+        process.exit(1);
+    }
+    const config = { centrifugoUrl, agentToken, agentId, backendInternalUrl };
+    const platform = process.platform;
+    console.log('');
+    console.log(`Detected platform: ${platform}`);
+    console.log('');
+    if (platform === 'darwin') {
+        const { installMacOS } = await import('../platform/macos.js');
+        await installMacOS(config);
+    }
+    else if (platform === 'linux') {
+        const { installLinux } = await import('../platform/linux.js');
+        await installLinux(config);
+    }
+    else if (platform === 'win32') {
+        const { installWindows } = await import('../platform/windows.js');
+        await installWindows(config);
+    }
+    else {
+        console.error(`Unsupported platform: ${platform}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/commands/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"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"}

package/dist/commands/uninstall.d.ts

@@ -0,0 +1 @@
+export declare function uninstall(): Promise<void>;

package/dist/commands/uninstall.js

@@ -0,0 +1,22 @@
+export async function uninstall() {
+    const platform = process.platform;
+    console.log(`Uninstalling Agent Controller on platform: ${platform}`);
+    console.log('');
+    if (platform === 'darwin') {
+        const { uninstallMacOS } = await import('../platform/macos.js');
+        await uninstallMacOS();
+    }
+    else if (platform === 'linux') {
+        const { uninstallLinux } = await import('../platform/linux.js');
+        await uninstallLinux();
+    }
+    else if (platform === 'win32') {
+        const { uninstallWindows } = await import('../platform/windows.js');
+        await uninstallWindows();
+    }
+    else {
+        console.error(`Unsupported platform: ${platform}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=uninstall.js.map

package/dist/commands/uninstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.js","sourceRoot":"","sources":["../../src/commands/uninstall.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,OAAO,CAAC,GAAG,CAAC,8CAA8C,QAAQ,EAAE,CAAC,CAAC;IACtE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAChE,MAAM,cAAc,EAAE,CAAC;IACzB,CAAC;SAAM,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QAChC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAChE,MAAM,cAAc,EAAE,CAAC;IACzB,CAAC;SAAM,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QAChC,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;QACpE,MAAM,gBAAgB,EAAE,CAAC;IAC3B,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/index.js

@@ -19,9 +19,6 @@ export function main() {
     const token = requireEnv('AGENT_TOKEN');
     const agentId = requireEnv('AGENT_ID');
     const backendUrl = requireEnv('BACKEND_INTERNAL_URL');
-    // Read for backward compatibility but no longer used directly
-    void process.env.CENTRIFUGO_INTERNAL_URL;
-    void process.env.CENTRIFUGO_API_KEY;
     if (DEBUG)
         console.log('[debug] Debug mode enabled');
     console.log(`Starting agent-controller for agent: ${agentId}`);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/platform/linux.d.ts

@@ -0,0 +1,8 @@
+export interface PlatformConfig {
+    centrifugoUrl: string;
+    agentToken: string;
+    agentId: string;
+    backendInternalUrl: string;
+}
+export declare function installLinux(config: PlatformConfig): Promise<void>;
+export declare function uninstallLinux(): Promise<void>;

package/dist/platform/linux.js

@@ -0,0 +1,96 @@
+import { exec } from 'node:child_process';
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+function execAsync(cmd) {
+    return new Promise((resolve, reject) => {
+        exec(cmd, (err, stdout) => {
+            if (err)
+                reject(err);
+            else
+                resolve(stdout.toString().trim());
+        });
+    });
+}
+async function which(bin) {
+    try {
+        return await execAsync(`which "${bin}"`);
+    }
+    catch {
+        return '';
+    }
+}
+export async function installLinux(config) {
+    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() {
+    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.');
+}
+//# sourceMappingURL=linux.js.map

package/dist/platform/linux.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux.js","sourceRoot":"","sources":["../../src/platform/linux.ts"],"names":[],"mappings":"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"}

package/dist/platform/macos.d.ts

@@ -0,0 +1,8 @@
+export interface PlatformConfig {
+    centrifugoUrl: string;
+    agentToken: string;
+    agentId: string;
+    backendInternalUrl: string;
+}
+export declare function installMacOS(config: PlatformConfig): Promise<void>;
+export declare function uninstallMacOS(): Promise<void>;

package/dist/platform/macos.js

@@ -0,0 +1,109 @@
+import { exec } from 'node:child_process';
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+function execAsync(cmd) {
+    return new Promise((resolve, reject) => {
+        exec(cmd, (err, stdout) => {
+            if (err)
+                reject(err);
+            else
+                resolve(stdout.toString().trim());
+        });
+    });
+}
+async function which(bin) {
+    try {
+        return await execAsync(`which "${bin}"`);
+    }
+    catch {
+        return '';
+    }
+}
+export async function installMacOS(config) {
+    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() {
+    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.');
+}
+//# sourceMappingURL=macos.js.map

package/dist/platform/macos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"macos.js","sourceRoot":"","sources":["../../src/platform/macos.ts"],"names":[],"mappings":"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"}

package/dist/platform/windows.d.ts

@@ -0,0 +1,8 @@
+export interface PlatformConfig {
+    centrifugoUrl: string;
+    agentToken: string;
+    agentId: string;
+    backendInternalUrl: string;
+}
+export declare function installWindows(config: PlatformConfig): Promise<void>;
+export declare function uninstallWindows(): Promise<void>;

package/dist/platform/windows.js

@@ -0,0 +1,77 @@
+import { exec } from 'node:child_process';
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+function execAsync(cmd) {
+    return new Promise((resolve, reject) => {
+        exec(cmd, (err, stdout) => {
+            if (err)
+                reject(err);
+            else
+                resolve(stdout.toString().trim());
+        });
+    });
+}
+async function which(bin) {
+    try {
+        return await execAsync(`where "${bin}"`);
+    }
+    catch {
+        return '';
+    }
+}
+export async function installWindows(config) {
+    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() {
+    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.');
+}
+//# sourceMappingURL=windows.js.map

package/dist/platform/windows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows.js","sourceRoot":"","sources":["../../src/platform/windows.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw-cloud/agent-controller",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "type": "module",
   "main": "dist/index.js",
   "bin": {

package/src/commands/install.ts

@@ -0,0 +1,64 @@
+import { createInterface } from 'node:readline';
+
+async function prompt(rl: ReturnType<typeof createInterface>, question: string): Promise<string> {
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      resolve(answer.trim());
+    });
+  });
+}
+
+async function getOrPrompt(
+  rl: ReturnType<typeof createInterface>,
+  envKey: string,
+  question: string,
+): Promise<string> {
+  const fromEnv = process.env[envKey];
+  if (fromEnv) {
+    const display = envKey.includes('TOKEN') ? '***' : fromEnv;
+    console.log(`  ${envKey}: ${display} (from environment)`);
+    return fromEnv;
+  }
+  return prompt(rl, question);
+}
+
+export async function install(): Promise<void> {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+
+  console.log('OpenClaw Agent Controller — Installation Wizard');
+  console.log('================================================');
+  console.log('');
+
+  const centrifugoUrl = await getOrPrompt(rl, 'CENTRIFUGO_URL', 'CENTRIFUGO_URL (e.g. wss://ws.openclaw-cloud.io): ');
+  const agentToken = await getOrPrompt(rl, 'AGENT_TOKEN', 'AGENT_TOKEN: ');
+  const agentId = await getOrPrompt(rl, 'AGENT_ID', 'AGENT_ID: ');
+  const backendInternalUrl = await getOrPrompt(rl, 'BACKEND_INTERNAL_URL', 'BACKEND_INTERNAL_URL (e.g. https://api.openclaw-cloud.io): ');
+
+  rl.close();
+
+  if (!centrifugoUrl || !agentToken || !agentId || !backendInternalUrl) {
+    console.error('All fields are required. Aborting.');
+    process.exit(1);
+  }
+
+  const config = { centrifugoUrl, agentToken, agentId, backendInternalUrl };
+
+  const platform = process.platform;
+  console.log('');
+  console.log(`Detected platform: ${platform}`);
+  console.log('');
+
+  if (platform === 'darwin') {
+    const { installMacOS } = await import('../platform/macos.js');
+    await installMacOS(config);
+  } else if (platform === 'linux') {
+    const { installLinux } = await import('../platform/linux.js');
+    await installLinux(config);
+  } else if (platform === 'win32') {
+    const { installWindows } = await import('../platform/windows.js');
+    await installWindows(config);
+  } else {
+    console.error(`Unsupported platform: ${platform}`);
+    process.exit(1);
+  }
+}

package/src/commands/uninstall.ts

@@ -0,0 +1,19 @@
+export async function uninstall(): Promise<void> {
+  const platform = process.platform;
+  console.log(`Uninstalling Agent Controller on platform: ${platform}`);
+  console.log('');
+
+  if (platform === 'darwin') {
+    const { uninstallMacOS } = await import('../platform/macos.js');
+    await uninstallMacOS();
+  } else if (platform === 'linux') {
+    const { uninstallLinux } = await import('../platform/linux.js');
+    await uninstallLinux();
+  } else if (platform === 'win32') {
+    const { uninstallWindows } = await import('../platform/windows.js');
+    await uninstallWindows();
+  } else {
+    console.error(`Unsupported platform: ${platform}`);
+    process.exit(1);
+  }
+}

package/src/index.ts

@@ -22,10 +22,6 @@ export function main(): void {
   const token = requireEnv('AGENT_TOKEN');
   const agentId = requireEnv('AGENT_ID');
   const backendUrl = requireEnv('BACKEND_INTERNAL_URL');
-  // Read for backward compatibility but no longer used directly
-  void process.env.CENTRIFUGO_INTERNAL_URL;
-  void 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)`);

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.');
+}