Skip to main content
Alur penggunaan pertama aplikasi macOS: pilih tempat Gateway berjalan, hubungkan backend AI yang terverifikasi, berikan izin, lalu serahkan prosesnya ke ritual bootstrap milik agen. Untuk onboarding CLI dan perbandingan kedua jalur tersebut, lihat Ikhtisar Onboarding.
1

Setujui peringatan macOS

2

Setujui pencarian jaringan lokal

3

Sambutan dan pemberitahuan keamanan

Baca pemberitahuan keamanan yang ditampilkan dan tentukan pilihan sesuai pertimbangan Anda

Model kepercayaan keamanan:
  • Secara default, OpenClaw adalah agen pribadi: satu batas operator tepercaya.
  • Penyiapan bersama/multipengguna perlu diperketat: pisahkan batas kepercayaan, minimalkan akses alat, dan ikuti panduan Keamanan.
  • Onboarding lokal secara default menetapkan konfigurasi baru ke tools.profile: "coding" agar penyiapan baru tetap memiliki alat sistem berkas/runtime tanpa profil full yang tidak dibatasi.
  • Jika hook/webhook atau sumber konten tidak tepercaya lainnya diaktifkan, gunakan tingkatan model modern yang kuat dan pertahankan kebijakan alat/sandboxing yang ketat.
4

Lokal vs Jarak Jauh

Di mana Gateway berjalan?
  • Mac Ini (Hanya lokal): onboarding mengonfigurasi autentikasi dan menulis kredensial secara lokal.
  • Jarak Jauh (melalui SSH/Tailnet): onboarding tidak mengonfigurasi autentikasi lokal; kredensial harus sudah tersedia di host gateway. Kolom token gateway jarak jauh menyimpan token yang digunakan aplikasi macOS untuk terhubung ke Gateway tersebut; nilai SecretRef gateway.remote.token yang ada dipertahankan hingga Anda menggantinya.
  • Konfigurasikan nanti: lewati penyiapan dan biarkan aplikasi belum dikonfigurasi.
Kiat autentikasi Gateway:
  • Mode autentikasi Gateway secara default adalah token, bahkan untuk binding loopback, sehingga klien WS lokal harus melakukan autentikasi.
  • Menetapkan gateway.auth.mode: "none" memungkinkan proses lokal apa pun terhubung; gunakan hanya pada mesin yang sepenuhnya tepercaya.
  • Gunakan token untuk akses multimesin atau binding non-loopback.
5

CLI

Penyiapan lokal menginstal CLI openclaw global melalui npm, pnpm, atau bun, dengan memprioritaskan npm. Node tetap menjadi runtime yang direkomendasikan untuk Gateway itu sendiri. Instalasi kompatibel yang sudah ada akan digunakan kembali.
6

Hubungkan AI Anda

Gateway terhubung yang sudah memiliki model agen terkonfigurasi akan melewati halaman ini sepenuhnya dan membuka UI agen normal. Penyiapan OpenClaw dan penyedia hanya dijalankan untuk Gateway yang baru atau belum lengkap.Setelah Gateway siap, onboarding mencari akses AI yang sudah Anda miliki: login Claude Code atau Codex, OPENAI_API_KEY / ANTHROPIC_API_KEY, atau model berkemampuan alat dengan konteks efektif terukur minimal 16K yang sudah terinstal pada server Ollama atau LM Studio yang dapat dijangkau. Deteksi berjalan di host Gateway, termasuk saat aplikasi macOS terhubung ke Gateway Linux. Opsi terbaik diuji dengan completion nyata dan hanya disimpan setelah memberikan jawaban; saat pengujian gagal, aplikasi otomatis mencoba opsi berikutnya dan menampilkan alasan kegagalan opsi sebelumnya. Jika beberapa opsi ditemukan, Anda dapat beralih di antaranya sebelum melanjutkan. Penemuan lokal otomatis tidak pernah mengambil atau mengunduh model.Untuk menggunakan langganan Claude saat host Gateway tidak memiliki login CLI Claude, jalankan claude setup-token pada mesin apa pun yang telah menginstal Claude Code, lalu tempelkan token yang dicetak sebagai Anthropic setup-token di bagian Connect with an API key or token.CLI Gemini, Antigravity, Pi, dan OpenCode yang terinstal ditampilkan sebagai konteks saat tidak dapat dipilih sebagai jalur inferensi penyiapan terpandu yang dapat digunakan kembali. Gemini dan Antigravity tidak dapat memberlakukan pemeriksaan inferensi tanpa alat. Pi dan OpenCode merupakan harness agen lengkap, bukan jalur inferensi penyiapan; integrasi sesinya memerlukan penyiapan runtime dan plugin secara terpisah.Anda juga dapat masuk melalui alur OAuth atau pemasangan perangkat milik penyedia. Pilihan bawaan mencakup OpenAI/ChatGPT, OpenRouter, GitHub Copilot, Google Gemini CLI, xAI, MiniMax Global dan CN, serta Chutes. Daftar ini berasal dari plugin penyedia inferensi teks aktif milik Gateway, bukan dari daftar tetap aplikasi, sehingga penyedia lain dapat ikut serta tanpa menambahkan kode macOS khusus penyedia.Pemilih kunci/token manual menggunakan registri penyedia yang sama. Pada setiap jalur, penyedia memasok model awal dan konfigurasinya; OpenClaw memverifikasi kredensial dengan pengujian langsung yang sama sebelum menyimpan profil autentikasinya. Tombol Next tetap terkunci hingga satu backend berhasil, sehingga percakapan agen pertama tidak dapat dimulai tanpa inferensi yang berfungsi. Setelah pemeriksaan langsung tersebut berhasil, OpenClaw tersedia untuk membantu mengonfigurasi ruang kerja, Gateway, saluran, dan fitur opsional lainnya yang tersisa. Saat OpenClaw menawarkan daftar singkat pilihan, aplikasi menampilkan kartu opsi native; memilih salah satunya akan mengirimkan pilihan tersebut, dan Skip for now selalu membiarkan pilihan tersebut tetap opsional. OpenClaw juga tersedia nanti di Settings → OpenClaw.
7

Impor memori (ditampilkan saat terdeteksi)

Untuk Gateway lokal, onboarding memeriksa Mac guna menemukan memori dari alat AI yang didukung: memori otomatis Claude Code, memori terkonsolidasi Codex, dan berkas memori Hermes. Saat ditemukan, halaman ini mencantumkan setiap sumber beserta jumlah memorinya dan memungkinkan Anda mengimpor sumber yang dipilih ke dalam ruang kerja agen di bawah memory/imports/ untuk pengingatan terindeks. Berkas yang sudah diimpor dilewati, dan halaman ini tidak pernah muncul jika tidak ada yang dapat diimpor. Melewati langkah ini aman; halaman impor Memory pada dasbor menawarkan impor yang sama nanti dengan kontrol per berkas.
8

Izin

Pilih izin yang ingin Anda berikan kepada OpenClaw

Onboarding meminta izin TCC untuk: Automation (AppleScript), Notifications, Accessibility, Screen Recording, Microphone, Speech Recognition, Camera, dan Location.
9

Selesai

Setelah inferensi berhasil, OpenClaw menangani penyiapan opsional yang tersisa dan dapat menyerahkan Anda ke percakapan agen normal. Menyelesaikan panduan izin membuka percakapan yang sama; aplikasi tidak membuat ruang kerja atau memulai percakapan penyiapan agen terpisah sebelum OpenClaw. Lihat Bootstrap untuk mengetahui apa yang terjadi pada host gateway selama giliran nyata pertama agen.

​
Terkait