Langsung ke konten utama
Onboarding CLI adalah jalur penyiapan terminal yang direkomendasikan untuk OpenClaw di macOS, Linux, atau Windows. Pengguna desktop Windows juga dapat memulai dengan Windows Hub. Ini mengonfigurasi Gateway lokal atau koneksi Gateway jarak jauh, ditambah saluran, Skills, dan default ruang kerja dalam satu alur terpandu. 
openclaw onboard
QuickStart biasanya hanya membutuhkan beberapa menit, tetapi onboarding penuh dapat memakan waktu lebih lama ketika login penyedia, pemasangan saluran, pemasangan daemon, unduhan jaringan, Skills, atau Plugin opsional memerlukan penyiapan tambahan. Wizard menampilkan perkiraan waktu ini di awal, dan langkah opsional dapat dilewati lalu dikunjungi kembali nanti dengan openclaw configure.

​
Lokal

Wizard CLI melokalkan teks onboarding tetap. Lokal ditentukan dari OPENCLAW_LOCALE, lalu LC_ALL, lalu LC_MESSAGES, lalu LANG, dan jika tidak ada akan kembali ke bahasa Inggris. Lokal wizard yang didukung adalah en, zh-CN, dan zh-TW. 
OPENCLAW_LOCALE=zh-CN openclaw onboard
Nama dan pengenal stabil tetap literal: OpenClaw, Gateway, Tailscale, perintah, kunci konfigurasi, URL, ID penyedia, ID model, serta label Plugin/saluran tidak diterjemahkan.
Obrolan pertama tercepat: buka Control UI (penyiapan saluran tidak diperlukan). Jalankan openclaw dashboard dan mengobrol di browser. Dokumen: Dashboard.
Untuk mengonfigurasi ulang nanti: 
openclaw configure
openclaw agents add <name>
--json tidak berarti mode non-interaktif. Untuk skrip, gunakan --non-interactive.
Onboarding CLI mencakup langkah pencarian web tempat Anda dapat memilih penyedia seperti Brave, DuckDuckGo, Exa, Firecrawl, Gemini, Grok, Kimi, MiniMax Search, Ollama Web Search, Perplexity, SearXNG, atau Tavily. Beberapa penyedia memerlukan kunci API, sedangkan yang lain tidak memerlukan kunci. Anda juga dapat mengonfigurasinya nanti dengan openclaw configure --section web. Dokumen: Alat web.

​
QuickStart vs Lanjutan

Onboarding dimulai dengan QuickStart (default) vs Lanjutan (kontrol penuh).
  • Gateway lokal (local loopback)
  • Default ruang kerja (atau ruang kerja yang sudah ada)
  • Port Gateway 18789
  • Autentikasi Gateway Token (dibuat otomatis, bahkan pada loopback)
  • Default kebijakan alat untuk penyiapan lokal baru: tools.profile: "coding" (profil eksplisit yang sudah ada dipertahankan)
  • Default isolasi DM: onboarding lokal menulis session.dmScope: "per-channel-peer" saat belum diatur. Detail: Referensi Penyiapan CLI
  • Eksposur Tailscale Mati
  • DM Telegram + WhatsApp default ke allowlist (Anda akan diminta memasukkan nomor telepon)

​
Apa yang dikonfigurasi onboarding

Mode lokal (default) memandu Anda melalui langkah-langkah ini:
  1. Model/Auth — pilih penyedia/alur autentikasi apa pun yang didukung (kunci API, OAuth, atau autentikasi manual khusus penyedia), termasuk Custom Provider (kompatibel dengan OpenAI, kompatibel dengan Anthropic, atau deteksi otomatis Unknown). Pilih model default. Catatan keamanan: jika agen ini akan menjalankan alat atau memproses konten Webhook/hook, pilih model generasi terbaru terkuat yang tersedia dan pertahankan kebijakan alat tetap ketat. Tingkat yang lebih lemah/lama lebih mudah terkena prompt injection. Untuk eksekusi non-interaktif, --secret-input-mode ref menyimpan ref berbasis env di profil auth alih-alih nilai kunci API teks biasa. Dalam mode non-interaktif ref, env var penyedia harus diatur; meneruskan flag kunci inline tanpa env var tersebut akan gagal cepat. Dalam eksekusi interaktif, memilih mode referensi rahasia memungkinkan Anda menunjuk ke variabel lingkungan atau ref penyedia yang dikonfigurasi (file atau exec), dengan validasi preflight cepat sebelum menyimpan. Untuk Anthropic, onboarding/konfigurasi interaktif menawarkan Anthropic Claude CLI sebagai jalur lokal yang disukai dan Anthropic API key sebagai jalur produksi yang direkomendasikan. Anthropic setup-token juga tetap tersedia sebagai jalur token-auth yang didukung.
  2. Ruang kerja — Lokasi untuk file agen (default ~/.openclaw/workspace). Mengisi file bootstrap awal.
  3. Gateway — Port, alamat bind, mode autentikasi, eksposur Tailscale. Dalam mode token interaktif, pilih penyimpanan token teks biasa default atau ikut menggunakan SecretRef. Jalur SecretRef token non-interaktif: --gateway-token-ref-env <ENV_VAR>.
  4. Saluran — saluran obrolan bawaan dan Plugin resmi seperti iMessage, Discord, Feishu, Google Chat, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp, dan lainnya.
  5. Daemon — Memasang LaunchAgent (macOS), unit pengguna systemd (Linux/WSL2), atau Windows Scheduled Task native dengan fallback folder Startup per pengguna. Jika autentikasi token memerlukan token dan gateway.auth.token dikelola SecretRef, pemasangan daemon memvalidasinya tetapi tidak menyimpan token yang di-resolve ke metadata lingkungan layanan supervisor. Jika autentikasi token memerlukan token dan SecretRef token yang dikonfigurasi belum ter-resolve, pemasangan daemon diblokir dengan panduan yang dapat ditindaklanjuti. Jika gateway.auth.token dan gateway.auth.password sama-sama dikonfigurasi dan gateway.auth.mode belum diatur, pemasangan daemon diblokir sampai mode diatur secara eksplisit.
  6. Pemeriksaan kesehatan — Memulai Gateway dan memverifikasi bahwa Gateway berjalan.
  7. Skills — Memasang Skills yang direkomendasikan dan dependensi opsional.
Menjalankan ulang onboarding tidak menghapus apa pun kecuali Anda secara eksplisit memilih Reset (atau meneruskan --reset). CLI --reset default ke konfigurasi, kredensial, dan sesi; gunakan --reset-scope full untuk menyertakan ruang kerja. Jika konfigurasi tidak valid atau berisi kunci lama, onboarding meminta Anda menjalankan openclaw doctor terlebih dahulu.
Mode jarak jauh hanya mengonfigurasi klien lokal untuk terhubung ke Gateway di tempat lain. Mode ini tidak memasang atau mengubah apa pun di host jarak jauh.

​
Tambahkan agen lain

Gunakan openclaw agents add <name> untuk membuat agen terpisah dengan ruang kerja, sesi, dan profil auth miliknya sendiri. Menjalankan tanpa --workspace akan membuka onboarding. Yang diaturnya:
  • agents.list[].name
  • agents.list[].workspace
  • agents.list[].agentDir
Catatan:
  • Ruang kerja default mengikuti ~/.openclaw/workspace-<agentId>.
  • Tambahkan bindings untuk merutekan pesan masuk (onboarding dapat melakukannya).
  • Flag non-interaktif: --model, --agent-dir, --bind, --non-interactive.

​
Referensi lengkap

Untuk uraian langkah demi langkah terperinci dan output konfigurasi, lihat Referensi Penyiapan CLI. Untuk contoh non-interaktif, lihat Otomasi CLI. Untuk referensi teknis yang lebih mendalam, termasuk detail RPC, lihat Referensi Onboarding.

​
Dokumen terkait