English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

First steps

Orientasi Awal (CLI)

CLI onboarding adalah cara yang direkomendasikan untuk menyiapkan OpenClaw di macOS, Linux, atau Windows (melalui WSL2; sangat direkomendasikan). Ini mengonfigurasi Gateway lokal atau koneksi Gateway jarak jauh, serta saluran, Skills, dan default ruang kerja dalam satu alur terpandu.

openclaw onboard

Untuk mengonfigurasi ulang nanti:

openclaw configure
openclaw agents add <name>

Mulai Cepat vs Lanjutan

Onboarding dimulai dengan Mulai Cepat (default) vs Lanjutan (kontrol penuh).

Mulai Cepat (default)

  • Gateway lokal (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 ditetapkan. Detail: Referensi Penyiapan CLI
  • Eksposur Tailscale Mati
  • DM Telegram + WhatsApp default ke allowlist (Anda akan diminta memasukkan nomor telepon)

Lanjutan (kontrol penuh)

  • Menampilkan setiap langkah (mode, ruang kerja, Gateway, saluran, daemon, Skills).

Yang dikonfigurasi onboarding

Mode lokal (default) memandu Anda melalui langkah-langkah ini:

  1. Model/Autentikasi — pilih penyedia/alur autentikasi apa pun yang didukung (kunci API, OAuth, atau autentikasi manual khusus penyedia), termasuk Penyedia Kustom (kompatibel OpenAI, kompatibel Anthropic, atau deteksi otomatis Tidak Diketahui). Pilih model default. Catatan keamanan: jika agen ini akan menjalankan alat atau memproses konten webhook/hooks, pilih model generasi terbaru terkuat yang tersedia dan jaga 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 dalam profil autentikasi, bukan nilai kunci API plaintext. Dalam mode ref non-interaktif, variabel env penyedia harus ditetapkan; meneruskan flag kunci inline tanpa variabel env 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/configure interaktif menawarkan Anthropic Claude CLI sebagai jalur lokal yang disarankan dan kunci API Anthropic sebagai jalur produksi yang direkomendasikan. setup-token Anthropic juga tetap tersedia sebagai jalur autentikasi token 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 plaintext default atau ikut menggunakan SecretRef. Jalur SecretRef token non-interaktif: --gateway-token-ref-env &lt;ENV_VAR&gt;.
  4. Saluran — saluran chat bawaan dan bundled seperti BlueBubbles, Discord, Feishu, Google Chat, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp, dan lainnya.
  5. Daemon — Menginstal 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, instalasi daemon memvalidasinya tetapi tidak mempertahankan token yang di-resolve ke dalam metadata lingkungan layanan supervisor. Jika autentikasi token memerlukan token dan SecretRef token yang dikonfigurasi belum ter-resolve, instalasi daemon diblokir dengan panduan yang dapat ditindaklanjuti. Jika gateway.auth.token dan gateway.auth.password sama-sama dikonfigurasi dan gateway.auth.mode belum ditetapkan, instalasi daemon diblokir sampai mode ditetapkan secara eksplisit.
  6. Pemeriksaan kesehatan — Memulai Gateway dan memverifikasi bahwa Gateway berjalan.
  7. Skills — Menginstal Skills yang direkomendasikan dan dependensi opsional.

Mode jarak jauh hanya mengonfigurasi klien lokal untuk terhubung ke Gateway di tempat lain. Mode ini tidak menginstal atau mengubah apa pun pada host jarak jauh.

Tambahkan agen lain

Gunakan openclaw agents add <name> untuk membuat agen terpisah dengan ruang kerja, sesi, dan profil autentikasinya sendiri. Menjalankan tanpa --workspace meluncurkan onboarding.

Yang ditetapkan:

  • 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 melakukan ini).
  • 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.

Dokumentasi terkait