메인 콘텐츠로 건너뛰기

​
macOS에서의 게이트웨이 (외부 launchd)

OpenClaw.app은 더 이상 Node/Bun이나 게이트웨이 런타임을 포함하지 않습니다. macOS 앱은 외부 openclaw CLI 설치를 기대하며, 게이트웨이를 자식 프로세스로 생성하지 않고, 게이트웨이를 계속 실행하기 위해 사용자별 launchd 서비스를 관리합니다 (또는 이미 로컬 게이트웨이가 실행 중인 경우 이에 연결합니다).

​
CLI 설치 (로컬 모드에 필수)

macOS의 기본 런타임은 Node 24입니다. 호환성을 위해 Node 22 LTS, 현재 22.16+, 도 계속 지원됩니다. 그런 다음 openclaw를 전역으로 설치합니다: 
npm install -g openclaw@<version>
macOS 앱의 CLI 설치 버튼은 npm/pnpm을 통해 동일한 흐름을 실행합니다 (Bun은 게이트웨이 런타임에 권장되지 않음).

​
Launchd (LaunchAgent로서의 게이트웨이)

라벨:
  • ai.openclaw.gateway (또는 ai.openclaw.<profile>; 기존 com.openclaw.*는 남아있을 수 있음)
Plist 위치 (사용자별):
  • ~/Library/LaunchAgents/ai.openclaw.gateway.plist (또는 ~/Library/LaunchAgents/ai.openclaw.<profile>.plist)
관리자:
  • macOS 앱은 로컬 모드에서 LaunchAgent 설치/업데이트를 소유합니다.
  • CLI도 설치할 수 있습니다: openclaw gateway install.
동작:
  • “OpenClaw 활성”은 LaunchAgent를 활성화/비활성화합니다.
  • 앱 종료는 게이트웨이를 중지하지 않습니다 (launchd가 계속 실행되도록 유지).
  • 구성된 포트에서 게이트웨이가 이미 실행 중인 경우, 앱은 새로 시작하지 않고 해당 게이트웨이에 연결합니다.
로깅:
  • launchd stdout/err: /tmp/openclaw/openclaw-gateway.log

​
버전 호환성

macOS 앱은 게이트웨이 버전을 자신의 버전과 비교합니다. 호환되지 않는 경우, 글로벌 CLI를 앱 버전에 맞게 업데이트하십시오.

​
연기 검증

openclaw --version

OPENCLAW_SKIP_CHANNELS=1 \
OPENCLAW_SKIP_CANVAS_HOST=1 \
openclaw gateway --port 18999 --bind loopback
그러고 나서: 
openclaw gateway call health --url ws://127.0.0.1:18999 --timeout 3000