Langsung ke konten utama

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.

​
Penyiapan pengembang macOS

Bangun dan jalankan aplikasi macOS OpenClaw dari sumber.

​
Prasyarat

Sebelum membangun aplikasi, pastikan Anda telah menginstal yang berikut:
  1. Xcode 26.2+: Diperlukan untuk pengembangan Swift.
  2. Node.js 24 & pnpm: Direkomendasikan untuk Gateway, CLI, dan skrip pengemasan. Node 22 LTS, saat ini 22.16+, tetap didukung untuk kompatibilitas.

​
1. Instal Dependensi

Instal dependensi seluruh proyek: 
pnpm install

​
2. Bangun dan Kemas Aplikasi

Untuk membangun aplikasi macOS dan mengemasnya ke dalam dist/OpenClaw.app, jalankan: 
./scripts/package-mac-app.sh
Jika Anda tidak memiliki sertifikat Apple Developer ID, skrip akan otomatis menggunakan penandatanganan ad-hoc (-). Untuk mode jalankan dev, flag penandatanganan, dan pemecahan masalah Team ID, lihat README aplikasi macOS: https://github.com/openclaw/openclaw/blob/main/apps/macos/README.md
Catatan: Aplikasi yang ditandatangani ad-hoc dapat memicu prompt keamanan. Jika aplikasi langsung crash dengan “Abort trap 6”, lihat bagian Pemecahan Masalah.

​
3. Instal CLI

Aplikasi macOS mengharapkan instalasi CLI openclaw global untuk mengelola tugas latar belakang. Untuk menginstalnya (direkomendasikan):
  1. Buka aplikasi OpenClaw.
  2. Buka tab pengaturan General.
  3. Klik “Install CLI”.
Sebagai alternatif, instal secara manual: 
npm install -g openclaw@<version>
pnpm add -g openclaw@<version> dan bun add -g openclaw@<version> juga berfungsi. Untuk runtime Gateway, Node tetap menjadi jalur yang direkomendasikan.

​
Pemecahan Masalah

​
Build gagal: toolchain atau SDK tidak cocok

Build aplikasi macOS mengharapkan SDK macOS terbaru dan toolchain Swift 6.2. Dependensi sistem (wajib):
  • Versi macOS terbaru yang tersedia di Software Update (diwajibkan oleh SDK Xcode 26.2)
  • Xcode 26.2 (toolchain Swift 6.2)
Pemeriksaan: 
xcodebuild -version
xcrun swift --version
Jika versi tidak cocok, perbarui macOS/Xcode dan jalankan ulang build.

​
Aplikasi crash saat pemberian izin

Jika aplikasi crash ketika Anda mencoba mengizinkan akses Speech Recognition atau Microphone, ini mungkin disebabkan oleh cache TCC yang rusak atau ketidakcocokan tanda tangan. Perbaikan:
  1. Reset izin TCC: 
    tccutil reset All ai.openclaw.mac.debug
  2. Jika gagal, ubah BUNDLE_ID sementara di scripts/package-mac-app.sh untuk memaksa “clean slate” dari macOS.

​
Gateway “Starting…” tanpa henti

Jika status Gateway tetap di “Starting…”, periksa apakah ada proses zombie yang menahan port: 
openclaw gateway status
openclaw gateway stop

# If you're not using a LaunchAgent (dev mode / manual runs), find the listener:
lsof -nP -iTCP:18789 -sTCP:LISTEN
Jika proses manual menahan port, hentikan proses tersebut (Ctrl+C). Sebagai upaya terakhir, hentikan paksa PID yang Anda temukan di atas.

​
Terkait