vultr/openclaw
1
0
Fork 0
mirror of https://github.com/openclaw/openclaw.git synced 2026-05-06 02:30:24 +00:00
Code Issues Packages Projects Releases Wiki Activity

Gateway: clarify launchctl domain bootstrap error (#13795)

Browse Source
This commit is contained in:
Vincent Koc
2026-02-19 02:03:23 -08:00
committed by GitHub
parent 88f698974a
commit be7462af1e
2 changed files with 82 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
src/daemon/launchd.ts
View File

@@ -334,6 +334,14 @@ function isLaunchctlNotLoaded(res: { stdout: string; stderr: string; code: numbe
);
}
function isUnsupportedGuiDomain(detail: string): boolean {
const normalized = detail.toLowerCase();
return (
normalized.includes("domain does not support specified action") ||
normalized.includes("bootstrap failed: 125")
);
}
export async function stopLaunchAgent({
stdout,
env,
@@ -402,7 +410,19 @@ export async function installLaunchAgent({
await execLaunchctl(["enable", `${domain}/${label}`]);
const boot = await execLaunchctl(["bootstrap", domain, plistPath]);
if (boot.code !== 0) {
throw new Error(`launchctl bootstrap failed: ${boot.stderr || boot.stdout}`.trim());
const detail = (boot.stderr || boot.stdout).trim();
if (isUnsupportedGuiDomain(detail)) {
throw new Error(
[
`launchctl bootstrap failed: ${detail}`,
`LaunchAgent install requires a logged-in macOS GUI session for this user (${domain}).`,
"This usually means you are running from SSH/headless context or as the wrong user (including sudo).",
"Fix: sign in to the macOS desktop as the target user and rerun `openclaw gateway install --force`.",
"Headless deployments should use a dedicated logged-in user session or a custom LaunchDaemon (not shipped): https://docs.openclaw.ai/gateway",
].join("\n"),
);
}
throw new Error(`launchctl bootstrap failed: ${detail}`);
}
await execLaunchctl(["kickstart", "-k", `${domain}/${label}`]);