메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

macOS 앱은 기본적으로 launchd를 통해 Gateway를 관리하며 Gateway를 자식 프로세스로 생성하지 않습니다. 먼저 구성된 포트에서 이미 실행 중인 Gateway에 연결을 시도합니다. 연결할 수 있는 Gateway가 없으면 외부 openclaw CLI를 통해 launchd 서비스를 활성화합니다(내장 런타임 없음). 이를 통해 로그인 시 안정적인 자동 시작과 충돌 시 재시작을 제공합니다. 자식 프로세스 모드(앱이 Gateway를 직접 생성)는 현재 사용되지 않습니다. UI와 더 긴밀하게 연결해야 한다면 터미널에서 Gateway를 수동으로 실행하세요.

​
기본 동작(launchd)

  • 앱은 ai.openclaw.gateway 레이블이 지정된 사용자별 LaunchAgent를 설치합니다 (--profile/OPENCLAW_PROFILE을 사용하는 경우 ai.openclaw.<profile>, 레거시 com.openclaw.*도 지원).
  • 로컬 모드가 활성화되면 앱은 LaunchAgent가 로드되어 있는지 확인하고 필요한 경우 Gateway를 시작합니다.
  • 로그는 launchd Gateway 로그 경로에 기록됩니다(디버그 설정에서 확인 가능).
일반적인 명령: 
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가 설정되어 앱은 이미 실행 중인 Gateway에만 연결합니다. 디버그 설정에서도 같은 동작을 전환할 수 있습니다.

​
원격 모드

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

​
launchd를 선호하는 이유

  • 로그인 시 자동 시작.
  • 내장 재시작/KeepAlive 의미 체계.
  • 예측 가능한 로그와 감독.
진정한 자식 프로세스 모드가 다시 필요해진다면 별도의 명시적인 개발 전용 모드로 문서화해야 합니다.

​
관련 항목