fix(desktop): auto-clear launchd disabled override on bootstrap (#836)

Users who previously ran `launchctl unload -w` to clean up zombie
OpenClaw processes get a persistent "disabled" flag in launchd's
database. This causes all subsequent `launchctl bootstrap` calls to
fail with error 5 (Input/output error), even when the plist and all
referenced paths are valid.

Add isServiceDisabled() check + enableService() call before bootstrap,
and as a fallback in the error 5 retry path.

Closes #780

Author: lefarcen

apps/desktop/main/services/launchd-manager.ts

@@ -26,12 +26,14 @@ export class LaunchdManager {
   private readonly plistDir: string;
   private readonly uid: number;
   private readonly domain: string;
+  private readonly log: (message: string) => void;
 
-  constructor(opts?: { plistDir?: string }) {
+  constructor(opts?: { plistDir?: string; log?: (message: string) => void }) {
     this.plistDir =
       opts?.plistDir ?? path.join(os.homedir(), "Library/LaunchAgents");
     this.uid = os.userInfo().uid;
     this.domain = `gui/${this.uid}`;
+    this.log = opts?.log ?? console.log;
   }
 
   /**
@@ -72,6 +74,16 @@ export class LaunchdManager {
 
     await fs.writeFile(plistPath, plistContent, "utf8");
 
+    // Clear any persistent "disabled" override left by legacy `launchctl unload -w`.
+    // Without this, bootstrap fails with error 5 (Input/output error).
+    const disabled = await this.isServiceDisabled(label);
+    if (disabled) {
+      this.log(
+        `installService: ${label} has disabled override, clearing with launchctl enable`,
+      );
+      await this.enableService(label);
+    }
+
     // Bootstrap with retry: "Input/output error" (code 5) means launchd
     // has stale state for this label. Bootout to clear it, then retry.
     for (let attempt = 0; attempt < 2; attempt++) {
@@ -95,6 +107,8 @@ export class LaunchdManager {
           } catch {
             // may already be unregistered
           }
+          // Also clear disabled override in case that's the cause
+          await this.enableService(label).catch(() => {});
           await new Promise((r) => setTimeout(r, 1000));
           continue;
         }
@@ -259,6 +273,45 @@ export class LaunchdManager {
     return env;
   }
 
+  /**
+   * Check if a service has a persistent "disabled" override in launchd's database.
+   * This happens when someone runs `launchctl unload -w` which writes a sticky
+   * disabled flag, causing all subsequent `launchctl bootstrap` calls to fail
+   * with error 5 (Input/output error).
+   */
+  async isServiceDisabled(label: string): Promise<boolean> {
+    try {
+      const { stdout } = await execFileAsync("launchctl", [
+        "print-disabled",
+        this.domain,
+      ]);
+      // Output format: "io.nexu.controller" => true
+      const pattern = new RegExp(
+        `"${label.replace(/\./g, "\\.")}"\\s*=>\\s*true`,
+      );
+      return pattern.test(stdout);
+    } catch {
+      // Command failed or label not found — assume not disabled
+      return false;
+    }
+  }
+
+  /**
+   * Clear a persistent "disabled" override for a service.
+   * Runs `launchctl enable gui/<uid>/<label>` so that subsequent bootstrap
+   * calls succeed. Tolerates errors (the label may not be in the disabled database).
+   */
+  async enableService(label: string): Promise<void> {
+    try {
+      await execFileAsync("launchctl", ["enable", `${this.domain}/${label}`]);
+      this.log(`enableService: cleared disabled override for ${label}`);
+    } catch (err) {
+      this.log(
+        `enableService: failed to clear disabled override for ${label}: ${err instanceof Error ? err.message : String(err)}`,
+      );
+    }
+  }
+
   /**
    * Check if service is registered with launchd.
    */