---
read_when:
    - Mengemas OpenClaw.app
    - Melakukan debug pada layanan launchd Gateway macOS
    - Menginstal CLI Gateway untuk macOS
summary: Runtime Gateway di macOS (layanan launchd eksternal)
title: Gateway di macOS
x-i18n:
    generated_at: "2026-05-07T13:21:39Z"
    model: gpt-5.5
    provider: openai
    source_hash: caf129918c46f8f54026e9db04e8ad5a033148899d3029fe1a362bb14c7f25f8
    source_path: platforms/mac/bundled-gateway.md
    workflow: 16
---

OpenClaw.app tidak lagi membundel Node/Bun atau runtime Gateway. Aplikasi macOS
mengharapkan pemasangan CLI `openclaw` **eksternal**, tidak menjalankan Gateway
sebagai proses anak, dan mengelola layanan launchd per pengguna untuk menjaga
Gateway tetap berjalan (atau tersambung ke Gateway lokal yang sudah ada jika
sudah berjalan).

## Instal CLI (wajib untuk mode lokal)

Node 24 adalah runtime default di Mac. Node 22 LTS, saat ini `22.16+`, masih berfungsi untuk kompatibilitas. Lalu instal `openclaw` secara global:

```bash
npm install -g openclaw@<version>
```

Tombol **Instal CLI** di aplikasi macOS menjalankan alur pemasangan global yang
sama dengan yang digunakan aplikasi secara internal: aplikasi lebih memilih npm
terlebih dahulu, lalu pnpm, lalu bun jika itu satu-satunya pengelola paket yang
terdeteksi. Node tetap menjadi runtime Gateway yang direkomendasikan.

## Launchd (Gateway sebagai LaunchAgent)

Label:

- `ai.openclaw.gateway` (atau `ai.openclaw.<profile>`; warisan `com.openclaw.*` mungkin tetap ada)

Lokasi plist (per pengguna):

- `~/Library/LaunchAgents/ai.openclaw.gateway.plist`
  (atau `~/Library/LaunchAgents/ai.openclaw.<profile>.plist`)

Pengelola:

- Aplikasi macOS memiliki pemasangan/pembaruan LaunchAgent dalam mode Lokal.
- CLI juga dapat memasangnya: `openclaw gateway install`.

Perilaku:

- "OpenClaw Aktif" mengaktifkan/menonaktifkan LaunchAgent.
- Keluar dari aplikasi **tidak** menghentikan gateway (launchd menjaganya tetap aktif).
- Jika Gateway sudah berjalan pada port yang dikonfigurasi, aplikasi akan
  tersambung ke Gateway tersebut alih-alih memulai yang baru.

Pencatatan log:

- stdout/err launchd: `/tmp/openclaw/openclaw-gateway.log`

## Kompatibilitas versi

Aplikasi macOS memeriksa versi gateway terhadap versinya sendiri. Jika keduanya
tidak kompatibel, perbarui CLI global agar sesuai dengan versi aplikasi.

## Pemeriksaan smoke

```bash
openclaw --version

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

Kemudian:

```bash
openclaw gateway call health --url ws://127.0.0.1:18999 --timeout 3000
```

## Terkait

- [aplikasi macOS](/id/platforms/macos)
- [Runbook Gateway](/id/gateway)