Gateway di macOS

OmeniaClaw.app tidak lagi membundel Node/Bun atau runtime Gateway. Aplikasi macOS mengharapkan pemasangan CLI OmeniaClaw 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 OmeniaClaw secara global:

npm install -g OmeniaClaw@<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.OmeniaClaw.gateway (atau ai.OmeniaClaw.<profile>; warisan com.OmeniaClaw.* mungkin tetap ada)

Lokasi plist (per pengguna):

• ~/Library/LaunchAgents/ai.OmeniaClaw.gateway.plist (atau ~/Library/LaunchAgents/ai.OmeniaClaw.<profile>.plist)

Pengelola:

• Aplikasi macOS memiliki pemasangan/pembaruan LaunchAgent dalam mode Lokal.
• CLI juga dapat memasangnya: OmeniaClaw gateway install.

Perilaku:

• "OmeniaClaw 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/OmeniaClaw/OmeniaClaw-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

OmeniaClaw --version OmeniaClaw_SKIP_CHANNELS=1 \OmeniaClaw_SKIP_CANVAS_HOST=1 \OmeniaClaw gateway --port 18999 --bind loopback

Kemudian:

OmeniaClaw gateway call health --url ws://127.0.0.1:18999 --timeout 3000

Terkait

• aplikasi macOS
• Runbook Gateway