Orientasi awal (aplikasi macOS)

Setujui peringatan macOS

Izinkan pencarian jaringan lokal

Sambutan dan pemberitahuan keamanan

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 Keamanan.
• Orientasi 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 umpan konten tidak tepercaya lainnya diaktifkan, gunakan tingkat model modern yang kuat serta pertahankan kebijakan alat dan sandboxing yang ketat.

Lokal vs Jarak Jauh

Di mana Gateway dijalankan?

• Mac Ini (Hanya lokal): orientasi mengonfigurasi autentikasi dan menulis kredensial secara lokal.
• Jarak Jauh (melalui SSH/Tailnet): orientasi 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 sudah ada dipertahankan hingga Anda menggantinya.
• Konfigurasikan nanti: lewati penyiapan dan biarkan aplikasi belum dikonfigurasi.

CLI

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

Hubungkan AI Anda

Gateway terhubung yang sudah memiliki model agen terkonfigurasi akan melewati halaman ini sepenuhnya dan membuka antarmuka agen normal. Penyiapan Crestodian dan penyedia hanya dijalankan untuk Gateway yang baru atau belum lengkap.

Setelah Gateway siap, orientasi akan mencari akses AI yang sudah Anda miliki: login Claude Code atau Codex, maupun OPENAI_API_KEY / ANTHROPIC_API_KEY. Opsi terbaik diuji dengan penyelesaian nyata dan hanya disimpan setelah berhasil memberikan jawaban; jika pengujian gagal, aplikasi secara otomatis mencoba opsi berikutnya dan menampilkan alasan kegagalan opsi sebelumnya. Jika ditemukan beberapa opsi, Anda dapat beralih di antaranya sebelum melanjutkan.

Gemini CLI tetap tersedia untuk agen normal setelah penyiapan, tetapi tidak ditawarkan di sini karena tidak dapat memberlakukan pemeriksaan inferensi tanpa alat.

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 tersebut 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. Dalam setiap jalur, penyedia memasok model awal dan konfigurasinya; OpenClaw memverifikasi kredensial dengan pengujian langsung yang sama sebelum menyimpan profil autentikasinya. Berikutnya tetap terkunci hingga satu backend berhasil, sehingga percakapan agen pertama tidak dapat dimulai tanpa inferensi yang berfungsi. Setelah pemeriksaan langsung tersebut berhasil, Crestodian tersedia untuk membantu mengonfigurasi ruang kerja, Gateway, saluran, dan fitur opsional lainnya; Crestodian juga tersedia nanti di Settings → Crestodian.

Izin

Orientasi meminta izin TCC untuk: Otomasi (AppleScript), Notifikasi, Aksesibilitas, Perekaman Layar, Mikrofon, Pengenalan Ucapan, Kamera, dan Lokasi.

Selesai

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