> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openclaw.kr/llms.txt
> Use this file to discover all available pages before exploring further.

# macOS에서의 게이트웨이

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

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

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

macOS의 기본 런타임은 Node 24입니다. 호환성을 위해 Node 22 LTS, 현재 `22.16+`, 도 계속 지원됩니다. 그런 다음 `openclaw`를 전역으로 설치합니다:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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를 앱 버전에 맞게 업데이트하십시오.

## 연기 검증

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw --version

OPENCLAW_SKIP_CHANNELS=1 \
OPENCLAW_SKIP_CANVAS_HOST=1 \
openclaw gateway --port 18999 --bind loopback
```

그러고 나서:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway call health --url ws://127.0.0.1:18999 --timeout 3000
```

```
```