Langsung ke konten utama
Dokumen ini menjelaskan alur penyiapan pertama kali yang saat ini berlaku. Tujuannya adalah pengalaman “hari 0” yang lancar: pilih tempat Gateway berjalan, hubungkan autentikasi, jalankan wizard, dan biarkan agen melakukan bootstrap sendiri. Untuk gambaran umum jalur onboarding, lihat Ikhtisar Onboarding.
1

Setujui peringatan macOS

2

Setujui pencarian jaringan lokal

3

Sambutan dan pemberitahuan keamanan

Model kepercayaan keamanan:
  • Secara default, OpenClaw adalah agen pribadi: satu batas operator tepercaya.
  • Penyiapan bersama/multi-pengguna memerlukan penguncian (pisahkan batas kepercayaan, jaga akses alat tetap minimal, dan ikuti Keamanan).
  • Onboarding lokal sekarang menetapkan default konfigurasi baru ke tools.profile: "coding" sehingga penyiapan lokal baru tetap mempertahankan alat filesystem/runtime tanpa memaksa profil full yang tidak dibatasi.
  • Jika hook/webhook atau feed konten tidak tepercaya lainnya diaktifkan, gunakan tingkat 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 dapat mengonfigurasi autentikasi dan menulis kredensial secara lokal.
  • Jarak Jauh (melalui SSH/Tailnet): onboarding tidak mengonfigurasi autentikasi lokal; kredensial harus ada di host gateway. Kolom token gateway jarak jauh menyimpan token yang digunakan aplikasi macOS untuk terhubung ke Gateway tersebut; nilai gateway.remote.token non-plaintext yang ada dipertahankan hingga Anda menggantinya.
  • Konfigurasi nanti: lewati penyiapan dan biarkan aplikasi belum dikonfigurasi.
Kiat autentikasi Gateway:
  • Wizard sekarang menghasilkan token bahkan untuk loopback, sehingga klien WS lokal harus diautentikasi.
  • Jika Anda menonaktifkan autentikasi, proses lokal apa pun dapat terhubung; gunakan itu hanya pada mesin yang sepenuhnya tepercaya.
  • Gunakan token untuk akses multi-mesin atau bind non-loopback.
5

Izin

Onboarding meminta izin TCC yang diperlukan untuk:
  • Otomasi (AppleScript)
  • Notifikasi
  • Aksesibilitas
  • Perekaman Layar
  • Mikrofon
  • Pengenalan Ucapan
  • Kamera
  • Lokasi
6

CLI

Langkah ini opsional
Aplikasi dapat menginstal CLI openclaw global melalui npm, pnpm, atau bun. Aplikasi mengutamakan npm terlebih dahulu, lalu pnpm, lalu bun jika itu satu-satunya manajer paket yang terdeteksi. Untuk runtime Gateway, Node tetap menjadi jalur yang direkomendasikan.
7

Chat Onboarding (sesi khusus)

Setelah penyiapan, aplikasi membuka sesi chat onboarding khusus agar agen dapat memperkenalkan dirinya dan memandu langkah berikutnya. Ini memisahkan panduan pertama kali dari percakapan normal Anda. Lihat Bootstrapping untuk mengetahui apa yang terjadi pada host gateway selama agen pertama kali berjalan.

​
Terkait