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

Technical reference

Referensi orientasi

Ini adalah referensi lengkap untuk openclaw onboard. Untuk ringkasan tingkat tinggi, lihat Onboarding (CLI).

Detail alur (mode lokal)

  • Deteksi konfigurasi yang ada

    • Jika ~/.openclaw/openclaw.json ada, pilih Pertahankan / Ubah / Reset.
    • Menjalankan ulang onboarding tidak menghapus apa pun kecuali Anda secara eksplisit memilih Reset (atau meneruskan --reset).
    • CLI --reset default ke config+creds+sessions; gunakan --reset-scope full untuk juga menghapus workspace.
    • Jika konfigurasi tidak valid atau berisi kunci lama, wizard berhenti dan meminta Anda menjalankan openclaw doctor sebelum melanjutkan.
    • Reset menggunakan trash (tidak pernah rm) dan menawarkan cakupan:
      • Konfigurasi saja
      • Konfigurasi + kredensial + sesi
      • Reset penuh (juga menghapus workspace)

  • Model/Auth

    • Kunci API Anthropic: menggunakan ANTHROPIC_API_KEY jika ada atau meminta kunci, lalu menyimpannya untuk penggunaan daemon.
    • Kunci API Anthropic: pilihan asisten Anthropic yang disarankan dalam onboarding/konfigurasi.
    • setup-token Anthropic: masih tersedia dalam onboarding/konfigurasi, meskipun OpenClaw sekarang lebih mengutamakan penggunaan ulang Claude CLI saat tersedia.
    • Langganan OpenAI Code (Codex) (OAuth): alur browser; tempelkan code#state.
      • Mengatur agents.defaults.model ke openai-codex/gpt-5.5 saat model belum diatur atau sudah dalam keluarga OpenAI.
    • Langganan OpenAI Code (Codex) (pemasangan perangkat): alur pemasangan browser dengan kode perangkat berumur pendek.
      • Mengatur agents.defaults.model ke openai-codex/gpt-5.5 saat model belum diatur atau sudah dalam keluarga OpenAI.
    • Kunci API OpenAI: menggunakan OPENAI_API_KEY jika ada atau meminta kunci, lalu menyimpannya dalam profil Auth.
      • Mengatur agents.defaults.model ke openai/gpt-5.5 saat model belum diatur, openai/*, atau openai-codex/*.
    • Kunci API xAI (Grok): meminta XAI_API_KEY dan mengonfigurasi xAI sebagai penyedia model.
    • OpenCode: meminta OPENCODE_API_KEY (atau OPENCODE_ZEN_API_KEY, dapatkan di https://opencode.ai/auth) dan memungkinkan Anda memilih katalog Zen atau Go.
    • Ollama: menawarkan Cloud + Lokal, Hanya Cloud, atau Hanya lokal terlebih dahulu. Cloud only meminta OLLAMA_API_KEY dan menggunakan https://ollama.com; mode berbasis host meminta URL dasar Ollama, menemukan model yang tersedia, dan menarik otomatis model lokal yang dipilih saat diperlukan; Cloud + Local juga memeriksa apakah host Ollama tersebut sudah masuk untuk akses cloud.
    • Detail selengkapnya: Ollama
    • Kunci API: menyimpan kunci untuk Anda.
    • Vercel AI Gateway (proxy multi-model): meminta AI_GATEWAY_API_KEY.
    • Detail selengkapnya: Vercel AI Gateway
    • Cloudflare AI Gateway: meminta Account ID, Gateway ID, dan CLOUDFLARE_AI_GATEWAY_API_KEY.
    • Detail selengkapnya: Cloudflare AI Gateway
    • MiniMax: konfigurasi ditulis otomatis; default hosted adalah MiniMax-M2.7. Penyiapan kunci API menggunakan minimax/..., dan penyiapan OAuth menggunakan minimax-portal/....
    • Detail selengkapnya: MiniMax
    • StepFun: konfigurasi ditulis otomatis untuk StepFun standar atau Step Plan pada endpoint China atau global.
    • Standar saat ini mencakup step-3.5-flash, dan Step Plan juga mencakup step-3.5-flash-2603.
    • Detail selengkapnya: StepFun
    • Synthetic (kompatibel Anthropic): meminta SYNTHETIC_API_KEY.
    • Detail selengkapnya: Synthetic
    • Moonshot (Kimi K2): konfigurasi ditulis otomatis.
    • Kimi Coding: konfigurasi ditulis otomatis.
    • Detail selengkapnya: Moonshot AI (Kimi + Kimi Coding)
    • Lewati: belum ada Auth yang dikonfigurasi.
    • Pilih model default dari opsi yang terdeteksi (atau masukkan penyedia/model secara manual). Untuk kualitas terbaik dan risiko prompt-injection yang lebih rendah, pilih model generasi terbaru terkuat yang tersedia di tumpukan penyedia Anda.
    • Onboarding menjalankan pemeriksaan model dan memperingatkan jika model yang dikonfigurasi tidak dikenal atau Auth tidak ada.
    • Mode penyimpanan kunci API default ke nilai profil Auth plaintext. Gunakan --secret-input-mode ref untuk menyimpan referensi berbasis env sebagai gantinya (misalnya keyRef: { source: "env", provider: "default", id: "OPENAI_API_KEY" }).
    • Profil Auth berada di ~/.openclaw/agents/<agentId>/agent/auth-profiles.json (kunci API + OAuth). ~/.openclaw/credentials/oauth.json adalah sumber impor lama saja.
    • Detail selengkapnya: /concepts/oauth

  • Workspace

    • Default ~/.openclaw/workspace (dapat dikonfigurasi).
    • Mengisi file workspace yang diperlukan untuk ritual bootstrap agen.
    • Tata letak workspace lengkap + panduan cadangan: Workspace agen

  • Gateway

    • Port, bind, mode Auth, eksposur tailscale.
    • Rekomendasi Auth: pertahankan Token bahkan untuk loopback agar klien WS lokal harus melakukan autentikasi.
    • Dalam mode token, penyiapan interaktif menawarkan:
      • Buat/simpan token plaintext (default)
      • Gunakan SecretRef (opt-in)
      • Quickstart menggunakan ulang SecretRef gateway.auth.token yang sudah ada di seluruh penyedia env, file, dan exec untuk probe onboarding/bootstrap dashboard.
      • Jika SecretRef tersebut dikonfigurasi tetapi tidak dapat di-resolve, onboarding gagal lebih awal dengan pesan perbaikan yang jelas alih-alih menurunkan Auth runtime secara diam-diam.
    • Dalam mode kata sandi, penyiapan interaktif juga mendukung penyimpanan plaintext atau SecretRef.
    • Jalur SecretRef token noninteraktif: --gateway-token-ref-env &lt;ENV_VAR&gt;.
      • Memerlukan env var yang tidak kosong di lingkungan proses onboarding.
      • Tidak dapat digabungkan dengan --gateway-token.
    • Nonaktifkan Auth hanya jika Anda sepenuhnya memercayai setiap proses lokal.
    • Bind non-loopback tetap memerlukan Auth.

  • Channel

    • WhatsApp: login QR opsional.
    • Telegram: token bot.
    • Discord: token bot.
    • Google Chat: JSON akun layanan + audiens webhook.
    • Mattermost (Plugin): token bot + URL dasar.
    • Signal: instalasi signal-cli opsional + konfigurasi akun.
    • BlueBubbles: direkomendasikan untuk iMessage; URL server + kata sandi + Webhook.
    • iMessage: jalur CLI imsg lama + akses DB.
    • Keamanan DM: defaultnya adalah pairing. DM pertama mengirim kode; setujui melalui openclaw pairing approve <channel> <code> atau gunakan allowlist.

  • Pencarian web

    • Pilih penyedia yang didukung seperti Brave, DuckDuckGo, Exa, Firecrawl, Gemini, Grok, Kimi, MiniMax Search, Ollama Web Search, Perplexity, SearXNG, atau Tavily (atau lewati).
    • Penyedia berbasis API dapat menggunakan env var atau konfigurasi yang sudah ada untuk penyiapan cepat; penyedia tanpa kunci menggunakan prasyarat khusus penyedia masing-masing.
    • Lewati dengan --skip-search.
    • Konfigurasikan nanti: openclaw configure --section web.

  • Instalasi daemon

    • macOS: LaunchAgent
      • Memerlukan sesi pengguna yang sudah login; untuk headless, gunakan LaunchDaemon kustom (tidak disertakan).
    • Linux (dan Windows melalui WSL2): unit pengguna systemd
      • Onboarding mencoba mengaktifkan lingering melalui loginctl enable-linger <user> agar Gateway tetap berjalan setelah logout.
      • Dapat meminta sudo (menulis /var/lib/systemd/linger); mencoba tanpa sudo terlebih dahulu.
    • Pemilihan runtime: Node (direkomendasikan; diperlukan untuk WhatsApp/Telegram). Bun tidak direkomendasikan.
    • Jika Auth token memerlukan token dan gateway.auth.token dikelola SecretRef, instalasi daemon memvalidasinya tetapi tidak menyimpan nilai token plaintext yang sudah di-resolve ke metadata lingkungan layanan supervisor.
    • Jika Auth token memerlukan token dan SecretRef token yang dikonfigurasi tidak 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 diatur, instalasi daemon diblokir hingga mode diatur secara eksplisit.

  • Pemeriksaan kesehatan

    • Memulai Gateway (jika diperlukan) dan menjalankan openclaw health.
    • Kiat: openclaw status --deep menambahkan probe kesehatan gateway langsung ke output status, termasuk probe channel jika didukung (memerlukan gateway yang dapat dijangkau).

  • Skills (direkomendasikan)

    • Membaca skills yang tersedia dan memeriksa persyaratan.
    • Memungkinkan Anda memilih manajer node: npm / pnpm (bun tidak direkomendasikan).
    • Menginstal dependensi opsional (sebagian menggunakan Homebrew di macOS).

  • Selesai

    • Ringkasan + langkah berikutnya, termasuk aplikasi iOS/Android/macOS untuk fitur tambahan.

    • Mode noninteraktif

    Gunakan --non-interactive untuk mengotomatiskan atau membuat skrip onboarding:

    openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback \
  --install-daemon \
  --daemon-runtime node \
  --skip-skills

    Tambahkan --json untuk ringkasan yang dapat dibaca mesin.

    SecretRef token Gateway dalam mode non-interaktif:

    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

    --gateway-token dan --gateway-token-ref-env saling eksklusif.

    Contoh perintah khusus penyedia tersedia di Automasi CLI. Gunakan halaman referensi ini untuk semantik flag dan urutan langkah.

    Tambah agen (non-interaktif)

    openclaw agents add work \
  --workspace ~/.openclaw/workspace-work \
  --model openai/gpt-5.5 \
  --bind whatsapp:biz \
  --non-interactive \
  --json

    RPC wizard Gateway

    Gateway mengekspos alur onboarding melalui RPC (wizard.start, wizard.next, wizard.cancel, wizard.status). Klien (aplikasi macOS, Control UI) dapat merender langkah tanpa mengimplementasikan ulang logika onboarding.

    Penyiapan Signal (signal-cli)

    Onboarding dapat menginstal signal-cli dari rilis GitHub:

    • Mengunduh aset rilis yang sesuai.
    • Menyimpannya di bawah ~/.openclaw/tools/signal-cli/<version>/.
    • Menulis channels.signal.cliPath ke konfigurasi Anda.

    Catatan:

    • Build JVM memerlukan Java 21.
    • Build native digunakan jika tersedia.
    • Windows menggunakan WSL2; instalasi signal-cli mengikuti alur Linux di dalam WSL.

    Yang ditulis wizard

    Field umum di ~/.openclaw/openclaw.json:

    • agents.defaults.workspace
    • agents.defaults.model / models.providers (jika Minimax dipilih)
    • tools.profile (onboarding lokal menggunakan default "coding" saat belum diatur; nilai eksplisit yang sudah ada dipertahankan)
    • gateway.* (mode, bind, auth, tailscale)
    • session.dmScope (detail perilaku: Referensi Penyiapan CLI)
    • channels.telegram.botToken, channels.discord.token, channels.matrix.*, channels.signal.*, channels.imessage.*
    • Daftar izin saluran (Slack/Discord/Matrix/Microsoft Teams) saat Anda ikut serta selama prompt (nama diubah menjadi ID jika memungkinkan).
    • skills.install.nodeManager
      • setup --node-manager menerima npm, pnpm, atau bun.
      • Konfigurasi manual masih dapat menggunakan yarn dengan mengatur skills.install.nodeManager secara langsung.
    • wizard.lastRunAt
    • wizard.lastRunVersion
    • wizard.lastRunCommit
    • wizard.lastRunCommand
    • wizard.lastRunMode

    openclaw agents add menulis agents.list[] dan bindings opsional.

    Kredensial WhatsApp berada di bawah ~/.openclaw/credentials/whatsapp/<accountId>/. Sesi disimpan di bawah ~/.openclaw/agents/<agentId>/sessions/.

    Beberapa saluran disediakan sebagai Plugin. Saat Anda memilih salah satunya selama penyiapan, onboarding akan meminta untuk menginstalnya (npm atau path lokal) sebelum dapat dikonfigurasi.

    Dokumen terkait