macOS에서 게이트웨이 라이프사이클

macOS 앱은 기본적으로 launchd를 통해 게이트웨이를 관리하며 게이트웨이를 자식 프로세스로 생성하지 않습니다. 먼저 구성된 포트에서 이미 실행 중인 게이트웨이에 연결을 시도합니다. 도달할 수 없으면 외부 openclaw CLI를 통해 launchd 서비스를 활성화합니다 (임베딩된 런타임 없음). 이를 통해 로그인 시 안정적인 자동 시작과 충돌 시 재시작이 가능합니다.

자식 프로세스 모드 (앱이 직접 게이트웨이를 생성)는 현재 사용되지 않습니다. UI와 더 긴밀한 결합이 필요하다면 터미널에서 게이트웨이를 수동으로 실행하십시오.

기본 동작 (launchd)

• 앱은 ai.openclaw.gateway로 레이블된 사용자별 LaunchAgent를 설치합니다 (--profile/OPENCLAW_PROFILE 사용 시 ai.openclaw.<profile>; 레거시 com.openclaw.* 지원됨).
• 로컬 모드가 활성화되면 앱은 LaunchAgent가 로드되어 있고 필요한 경우 게이트웨이를 시작하도록 합니다.
• 로그는 launchd 게이트웨이 로그 경로에 기록됩니다 (Debug Settings에서 볼 수 있음).

공통 명령:

launchctl kickstart -k gui/$UID/ai.openclaw.gateway
launchctl bootout gui/$UID/ai.openclaw.gateway

명명된 프로필 실행 시 레이블을 ai.openclaw.<profile>로 교체하십시오.

서명되지 않은 개발 빌드

scripts/restart-mac.sh --no-sign은 서명 키가 없는 빠른 로컬 빌드용입니다. launchd가 서명되지 않은 릴레이 바이너리를 가리키지 않도록 다음을 수행합니다:

• ~/.openclaw/disable-launchagent를 씁니다.

scripts/restart-mac.sh의 서명된 실행은 마커가 있으면 이 재정의를 지웁니다. 수동으로 재설정하려면:

rm ~/.openclaw/disable-launchagent

연결 전용 모드

macOS 앱이 launchd를 절대 설치하거나 관리하지 않도록 강제하려면 --attach-only (또는 --no-launchd)로 시작하십시오. 이렇게 하면 ~/.openclaw/disable-launchagent가 설정되므로 앱은 이미 실행 중인 게이트웨이에만 연결합니다. Debug Settings에서 동일한 동작을 전환할 수 있습니다.

원격 모드

원격 모드는 로컬 게이트웨이를 시작하지 않습니다. 앱은 원격 호스트에 SSH 터널을 사용하고 해당 터널을 통해 연결합니다.

launchd를 선호하는 이유

• 로그인 시 자동 시작.
• 내장된 재시작/KeepAlive 의미론.
• 예측 가능한 로그 및 감독.

진정한 자식 프로세스 모드가 다시 필요한 경우 별도의 명시적 개발 전용 모드로 문서화해야 합니다.