​

CLI Kurulum Başvurusu

Bu sayfa, openclaw onboard için tam başvurudur. Kısa kılavuz için bkz. Onboarding (CLI).

​

Sihirbaz ne yapar

Yerel kip (varsayılan) sizi şu adımlardan geçirir:

• Model ve kimlik doğrulama kurulumu (OpenAI Code abonelik OAuth, Anthropic Claude CLI veya API anahtarı, ayrıca MiniMax, GLM, Ollama, Moonshot, StepFun ve AI Gateway seçenekleri)
• Çalışma alanı konumu ve bootstrap dosyaları
• Gateway ayarları (port, bind, auth, tailscale)
• Kanallar ve sağlayıcılar (Telegram, WhatsApp, Discord, Google Chat, Mattermost, Signal, BlueBubbles ve diğer paketlenmiş kanal plugin’leri)
• Daemon kurulumu (LaunchAgent, systemd kullanıcı birimi veya Startup-folder geri dönüşü olan yerel Windows Scheduled Task)
• Sağlık denetimi
• Skills kurulumu

Uzak kip, bu makineyi başka bir yerdeki gateway’e bağlanacak şekilde yapılandırır. Uzak host üzerinde hiçbir şeyi kurmaz veya değiştirmez.

​

Yerel akış ayrıntıları

​

Uzak kip ayrıntıları

Uzak kip, bu makineyi başka bir yerdeki gateway’e bağlanacak şekilde yapılandırır. Ayarladığınız şeyler:

• Uzak gateway URL’si (ws://...)
• Uzak gateway auth gerekiyorsa belirteç (önerilir)

​

Kimlik doğrulama ve model seçenekleri

Model davranışı:

• Algılanan seçeneklerden varsayılan modeli seçin veya sağlayıcı ve modeli elle girin.
• Onboarding bir sağlayıcı kimlik doğrulama seçeneğinden başladığında model seçici o sağlayıcıyı otomatik olarak tercih eder. Volcengine ve BytePlus için aynı tercih kodlama planı varyantlarıyla da eşleşir (volcengine-plan/*, byteplus-plan/*).
• Tercih edilen sağlayıcı filtresi boş kalacaksa, seçici hiç model göstermemek yerine tam kataloğa geri döner.
• Sihirbaz bir model denetimi çalıştırır ve yapılandırılmış model bilinmiyorsa veya kimlik doğrulaması eksikse uyarır.

Kimlik bilgisi ve profil yolları:

• Kimlik doğrulama profilleri (API anahtarları + OAuth): ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
• Eski OAuth içe aktarma kaynağı: ~/.openclaw/credentials/oauth.json

Kimlik bilgisi depolama kipi:

• Varsayılan onboarding davranışı, API anahtarlarını auth profillerinde düz metin değerler olarak kalıcı yazar.
• --secret-input-mode ref, düz metin anahtar depolama yerine başvuru kipini etkinleştirir. Etkileşimli kurulumda şunlardan birini seçebilirsiniz:
  • ortam değişkeni başvurusu (örneğin keyRef: { source: "env", provider: "default", id: "OPENAI_API_KEY" })
  • sağlayıcı takma adı + kimlik ile yapılandırılmış sağlayıcı başvurusu (file veya exec)
• Etkileşimli başvuru kipi kaydetmeden önce hızlı bir ön denetim doğrulaması çalıştırır.
  • Ortam başvuruları: mevcut onboarding ortamında değişken adını + boş olmayan değeri doğrular.
  • Sağlayıcı başvuruları: sağlayıcı yapılandırmasını doğrular ve istenen kimliği çözümler.
  • Ön denetim başarısız olursa onboarding hatayı gösterir ve yeniden denemenize izin verir.
• Etkileşimsiz kipte --secret-input-mode ref yalnızca ortam desteklidir.
  • Sağlayıcı ortam değişkenini onboarding süreci ortamında ayarlayın.
  • Satır içi anahtar bayrakları (örneğin --openai-api-key) bu ortam değişkeninin ayarlanmış olmasını gerektirir; aksi halde onboarding hızlıca başarısız olur.
  • Özel sağlayıcılar için etkileşimsiz ref kipi, models.providers.<id>.apiKey değerini { source: "env", provider: "default", id: "CUSTOM_API_KEY" } olarak depolar.
  • Bu özel sağlayıcı durumunda --custom-api-key, CUSTOM_API_KEY ayarlanmış olmasını gerektirir; aksi halde onboarding hızlıca başarısız olur.
• Gateway kimlik doğrulama kimlik bilgileri, etkileşimli kurulumda düz metin ve SecretRef seçeneklerini destekler:
  • Belirteç kipi: Düz metin belirteç oluştur/depola (varsayılan) veya SecretRef kullan.
  • Parola kipi: düz metin veya SecretRef.
• Etkileşimsiz belirteç SecretRef yolu: --gateway-token-ref-env <ENV_VAR>.
• Mevcut düz metin kurulumları değişmeden çalışmaya devam eder.

​

Çıktılar ve iç yapılar

~/.openclaw/openclaw.json içindeki tipik alanlar:

• agents.defaults.workspace
• agents.defaults.model / models.providers (MiniMax seçildiyse)
• tools.profile (yerel onboarding, ayarlanmamışsa bunu varsayılan olarak "coding" yapar; mevcut açık değerler korunur)
• gateway.* (mode, bind, auth, tailscale)
• session.dmScope (yerel onboarding, ayarlanmamışsa bunu varsayılan olarak per-channel-peer yapar; mevcut açık değerler korunur)
• channels.telegram.botToken, channels.discord.token, channels.matrix.*, channels.signal.*, channels.imessage.*
• İstemler sırasında buna katıldığınızda kanal allowlist’leri (Slack, Discord, Matrix, Microsoft Teams) mümkün olduğunda adlar kimliklere çözümlenir
• skills.install.nodeManager
  • setup --node-manager bayrağı npm, pnpm veya bun kabul eder.
  • El ile yapılandırma daha sonra yine de skills.install.nodeManager: "yarn" ayarlayabilir.
• wizard.lastRunAt
• wizard.lastRunVersion
• wizard.lastRunCommit
• wizard.lastRunCommand
• wizard.lastRunMode

openclaw agents add, agents.list[] ve isteğe bağlı bindings yazar. WhatsApp kimlik bilgileri ~/.openclaw/credentials/whatsapp/<accountId>/ altında bulunur. Oturumlar ~/.openclaw/agents/<agentId>/sessions/ altında depolanır. Gateway sihirbazı RPC:

• wizard.start
• wizard.next
• wizard.cancel
• wizard.status

İstemciler (macOS uygulaması ve Control UI), onboarding mantığını yeniden uygulamadan adımları işleyebilir. Signal kurulum davranışı:

• Uygun sürüm varlığını indirir
• Bunu ~/.openclaw/tools/signal-cli/<version>/ altına depolar
• Yapılandırmaya channels.signal.cliPath yazar
• JVM derlemeleri Java 21 gerektirir
• Mevcut olduğunda yerel derlemeler kullanılır
• Windows, WSL2 kullanır ve Linux signal-cli akışını WSL içinde izler

​

İlgili belgeler

• Onboarding merkezi: Onboarding (CLI)
• Otomasyon ve betikler: CLI Automation
• Komut başvurusu: openclaw onboard