openclaw onboard

Orientasi awal terpandu penuh untuk penyiapan Gateway lokal atau jarak jauh. Gunakan ini saat Anda ingin OpenClaw memandu autentikasi model, ruang kerja, gateway, channel, skills, dan kesehatan dalam satu alur.

Panduan terkait

Contoh

openclaw onboardopenclaw onboard --modernopenclaw onboard --flow quickstartopenclaw onboard --flow manualopenclaw onboard --flow importopenclaw onboard --import-from hermes --import-source ~/.hermesopenclaw onboard --skip-bootstrapopenclaw onboard --mode remote --remote-url wss://gateway-host:18789

--flow import menggunakan penyedia migrasi milik plugin seperti Hermes. Ini hanya berjalan pada penyiapan OpenClaw yang baru; jika konfigurasi, kredensial, sesi, atau file memori/identitas ruang kerja sudah ada, reset atau pilih penyiapan baru sebelum mengimpor.

--modern memulai pratinjau orientasi awal percakapan Crestodian. Tanpa --modern, openclaw onboard mempertahankan alur orientasi awal klasik.

Untuk target ws:// jaringan privat plaintext (hanya jaringan tepercaya), setel OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 di lingkungan proses orientasi awal. Tidak ada padanan openclaw.json untuk break-glass transport sisi klien ini.

Penyedia kustom non-interaktif:

openclaw onboard --non-interactive \  --auth-choice custom-api-key \  --custom-base-url "https://llm.example.com/v1" \  --custom-model-id "foo-large" \  --custom-api-key "$CUSTOM_API_KEY" \  --secret-input-mode plaintext \  --custom-compatibility openai \  --custom-image-input

--custom-api-key bersifat opsional dalam mode non-interaktif. Jika dihilangkan, orientasi awal memeriksa CUSTOM_API_KEY. OpenClaw secara otomatis menandai ID model vision umum sebagai mampu menerima gambar. Berikan --custom-image-input untuk ID vision kustom yang tidak dikenal, atau --custom-text-input untuk memaksa metadata hanya teks.

LM Studio juga mendukung flag kunci khusus penyedia dalam mode non-interaktif:

openclaw onboard --non-interactive \  --auth-choice lmstudio \  --custom-base-url "http://localhost:1234/v1" \  --custom-model-id "qwen/qwen3.5-9b" \  --lmstudio-api-key "$LM_API_TOKEN" \  --accept-risk

Ollama non-interaktif:

openclaw onboard --non-interactive \  --auth-choice ollama \  --custom-base-url "http://ollama-host:11434" \  --custom-model-id "qwen3.5:27b" \  --accept-risk

--custom-base-url default ke http://127.0.0.1:11434. --custom-model-id bersifat opsional; jika dihilangkan, orientasi awal menggunakan default yang disarankan Ollama. ID model cloud seperti kimi-k2.5:cloud juga berfungsi di sini.

Simpan kunci penyedia sebagai ref, bukan plaintext:

openclaw onboard --non-interactive \  --auth-choice openai-api-key \  --secret-input-mode ref \  --accept-risk

Dengan --secret-input-mode ref, orientasi awal menulis ref berbasis env, bukan nilai kunci plaintext. Untuk penyedia berbasis profil autentikasi, ini menulis entri keyRef; untuk penyedia kustom, ini menulis models.providers.<id>.apiKey sebagai ref env (misalnya { source: "env", provider: "default", id: "CUSTOM_API_KEY" }).

Kontrak mode ref non-interaktif:

• Setel variabel env penyedia di lingkungan proses orientasi awal (misalnya OPENAI_API_KEY).
• Jangan berikan flag kunci inline (misalnya --openai-api-key) kecuali variabel env tersebut juga disetel.
• Jika flag kunci inline diberikan tanpa variabel env yang diwajibkan, orientasi awal gagal cepat dengan panduan.

Opsi token Gateway dalam mode non-interaktif:

• --gateway-auth token --gateway-token <token> menyimpan token plaintext.
• --gateway-auth token --gateway-token-ref-env <name> menyimpan gateway.auth.token sebagai SecretRef env.
• --gateway-token dan --gateway-token-ref-env saling eksklusif.
• --gateway-token-ref-env memerlukan variabel env yang tidak kosong di lingkungan proses orientasi awal.
• Dengan --install-daemon, saat autentikasi token memerlukan token, token gateway yang dikelola SecretRef divalidasi tetapi tidak dipersistensikan sebagai plaintext yang sudah di-resolve dalam metadata lingkungan layanan supervisor.
• Dengan --install-daemon, jika mode token memerlukan token dan SecretRef token yang dikonfigurasi tidak dapat di-resolve, orientasi awal gagal tertutup dengan panduan remediasi.
• Dengan --install-daemon, jika gateway.auth.token dan gateway.auth.password sama-sama dikonfigurasi dan gateway.auth.mode belum disetel, orientasi awal memblokir instalasi sampai mode disetel secara eksplisit.
• Orientasi awal lokal menulis gateway.mode="local" ke dalam konfigurasi. Jika file konfigurasi berikutnya tidak memiliki gateway.mode, perlakukan itu sebagai kerusakan konfigurasi atau edit manual yang belum lengkap, bukan sebagai pintasan mode lokal yang valid.
• Orientasi awal lokal menginstal plugin unduhan yang dipilih saat jalur penyiapan yang dipilih memerlukannya.
• Orientasi awal jarak jauh hanya menulis info koneksi untuk Gateway jarak jauh dan tidak menginstal paket plugin lokal.
• --allow-unconfigured adalah escape hatch runtime gateway yang terpisah. Itu tidak berarti orientasi awal boleh menghilangkan gateway.mode.

Contoh:

export OPENCLAW_GATEWAY_TOKEN="your-token"openclaw onboard --non-interactive \  --mode local \  --auth-choice skip \  --gateway-auth token \  --gateway-token-ref-env OPENCLAW_GATEWAY_TOKEN \  --accept-risk

Kesehatan gateway lokal non-interaktif:

• Kecuali Anda memberikan --skip-health, orientasi awal menunggu gateway lokal yang dapat dijangkau sebelum berhasil keluar.
• --install-daemon memulai jalur instalasi gateway terkelola terlebih dahulu. Tanpanya, Anda harus sudah menjalankan gateway lokal, misalnya openclaw gateway run.
• Jika Anda hanya menginginkan penulisan konfigurasi/ruang kerja/bootstrap dalam otomasi, gunakan --skip-health.
• Jika Anda mengelola file ruang kerja sendiri, berikan --skip-bootstrap untuk menyetel agents.defaults.skipBootstrap: true dan melewati pembuatan AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md, dan BOOTSTRAP.md.
• Di Windows native, --install-daemon mencoba Scheduled Tasks terlebih dahulu dan fallback ke item login folder Startup per pengguna jika pembuatan tugas ditolak.

Perilaku orientasi awal interaktif dengan mode referensi:

• Pilih Gunakan referensi rahasia saat diminta.
• Lalu pilih salah satu:
  • Variabel lingkungan
  • Penyedia rahasia yang dikonfigurasi (file atau exec)
• Orientasi awal melakukan validasi preflight cepat sebelum menyimpan ref.
  • Jika validasi gagal, orientasi awal menampilkan error dan memungkinkan Anda mencoba lagi.

Pilihan endpoint Z.AI non-interaktif

# Pemilihan endpoint tanpa promptopenclaw onboard --non-interactive \  --auth-choice zai-coding-global \  --zai-api-key "$ZAI_API_KEY" # Pilihan endpoint Z.AI lainnya:# --auth-choice zai-coding-cn# --auth-choice zai-global# --auth-choice zai-cn

Contoh Mistral non-interaktif:

openclaw onboard --non-interactive \  --auth-choice mistral-api-key \  --mistral-api-key "$MISTRAL_API_KEY"

Catatan alur

Perintah tindak lanjut umum

openclaw channels addopenclaw configureopenclaw agents add <name>

Gunakan openclaw setup sebagai gantinya saat Anda hanya memerlukan konfigurasi/ruang kerja baseline. Gunakan openclaw configure nanti untuk perubahan tertarget dan openclaw channels add untuk penyiapan khusus channel.