​

openclaw onboard

​

İlgili kılavuzlar

• CLI ilk kurulum merkezi: İlk Kurulum (CLI)
• İlk kurulum genel bakışı: İlk Kurulum Genel Bakışı
• CLI ilk kurulum başvurusu: CLI Kurulum Başvurusu
• CLI otomasyonu: CLI Otomasyonu
• macOS ilk kurulumu: İlk Kurulum (macOS Uygulaması)

​

Örnekler

openclaw onboard
openclaw onboard --flow quickstart
openclaw onboard --flow manual
openclaw onboard --mode remote --remote-url wss://gateway-host:18789

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

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

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

• Sağlayıcı env değişkenini ilk kurulum işlem ortamında ayarlayın (örneğin OPENAI_API_KEY).
• Bu env değişkeni de ayarlı değilse satır içi anahtar bayrakları geçmeyin (örneğin --openai-api-key).
• Gerekli env değişkeni olmadan satır içi anahtar bayrağı geçirilirse, ilk kurulum yönlendirme ile hızlıca başarısız olur.

• --gateway-auth token --gateway-token <token> düz metin bir belirteç saklar.
• --gateway-auth token --gateway-token-ref-env <name> gateway.auth.token değerini env SecretRef olarak saklar.
• --gateway-token ve --gateway-token-ref-env birlikte kullanılamaz.
• --gateway-token-ref-env, ilk kurulum işlem ortamında boş olmayan bir env değişkeni gerektirir.
• --install-daemon ile, belirteç kimlik doğrulaması belirteç gerektirdiğinde, SecretRef ile yönetilen Gateway belirteçleri doğrulanır ancak supervisor hizmet ortamı meta verilerinde çözümlenmiş düz metin olarak kalıcı hale getirilmez.
• --install-daemon ile, belirteç modu bir belirteç gerektiriyor ve yapılandırılmış belirteç SecretRef’i çözümlenmemişse, ilk kurulum düzeltme yönlendirmesiyle kapalı şekilde başarısız olur.
• --install-daemon ile, hem gateway.auth.token hem de gateway.auth.password yapılandırılmış ve gateway.auth.mode ayarlanmamışsa, mod açıkça ayarlanana kadar ilk kurulum kurulumu engeller.
• Yerel ilk kurulum config içine gateway.mode="local" yazar. Daha sonra bir config dosyasında gateway.mode yoksa, bunu geçerli bir yerel mod kısayolu olarak değil, config bozulması veya eksik bir manuel düzenleme olarak değerlendirin.
• --allow-unconfigured, ayrı bir Gateway çalışma zamanı kaçış kapağıdır. Bu, ilk kurulumun gateway.mode alanını atlayabileceği anlamına gelmez.

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

• --skip-health geçmediğiniz sürece, ilk kurulum başarıyla çıkmadan önce erişilebilir bir yerel Gateway bekler.
• --install-daemon, önce yönetilen Gateway kurulum yolunu başlatır. Bu olmadan, örneğin openclaw gateway run ile yerel bir Gateway’in zaten çalışıyor olması gerekir.
• Otomasyonda yalnızca config/çalışma alanı/bootstrap yazımları istiyorsanız, --skip-health kullanın.
• Yerel Windows’ta --install-daemon, önce Scheduled Tasks kullanmayı dener ve görev oluşturma reddedilirse kullanıcı başına Startup klasörü oturum açma öğesine geri döner.

• İstendiğinde Gizli referans kullan seçeneğini seçin.
• Ardından şunlardan birini seçin:
  • Ortam değişkeni
  • Yapılandırılmış gizli sağlayıcı (file veya exec)
• İlk kurulum, referansı kaydetmeden önce hızlı bir ön doğrulama gerçekleştirir.
  • Doğrulama başarısız olursa, ilk kurulum hatayı gösterir ve yeniden denemenize izin verir.

# İstemsiz uç nokta seçimi
openclaw onboard --non-interactive \
  --auth-choice zai-coding-global \
  --zai-api-key "$ZAI_API_KEY"

# Diğer Z.AI uç nokta seçenekleri:
# --auth-choice zai-coding-cn
# --auth-choice zai-global
# --auth-choice zai-cn

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

• quickstart: en az istem, otomatik olarak bir Gateway belirteci üretir.
• manual: port/bind/auth için tüm istemler (advanced takma adı).
• Bir auth seçimi tercih edilen bir sağlayıcıyı ima ediyorsa, ilk kurulum varsayılan model ve izin listesi seçicilerini o sağlayıcıya göre ön filtreler. Volcengine ve BytePlus için bu, coding-plan varyantlarıyla da eşleşir (volcengine-plan/*, byteplus-plan/*).
• Tercih edilen sağlayıcı filtresi henüz yüklenmiş model döndürmezse, ilk kurulum seçiciyi boş bırakmak yerine filtresiz kataloğa geri döner.
• Web arama adımında, bazı sağlayıcılar sağlayıcıya özgü ek istemleri tetikleyebilir:
  • Grok, aynı XAI_API_KEY ile isteğe bağlı x_search kurulumu ve bir x_search model seçimi sunabilir.
  • Kimi, Moonshot API bölgesini (api.moonshot.ai ile api.moonshot.cn) ve varsayılan Kimi web arama modelini sorabilir.
• Yerel ilk kurulum DM kapsamı davranışı: CLI Kurulum Başvurusu.
• En hızlı ilk sohbet: openclaw dashboard (Kontrol UI, kanal kurulumu yok).
• Özel Sağlayıcı: listede olmayan barındırılan sağlayıcılar dahil olmak üzere, OpenAI veya Anthropic uyumlu herhangi bir uç noktaya bağlanın. Otomatik algılama için Unknown kullanın.

​

Yaygın devam komutları

openclaw configure
openclaw agents add <name>