CLI kurulum başvurusu

Bu sayfa openclaw onboard için tam referanstır. Kısa kılavuz için bkz. İlk Katılım (CLI).

Sihirbaz ne yapar

Yerel mod (varsayılan) sizi şunlardan geçirir:

• Model ve kimlik doğrulama kurulumu (OpenAI Code aboneliği OAuth, Anthropic Claude CLI veya API anahtarı, ayrıca MiniMax, GLM, Ollama, Moonshot, StepFun ve AI Gateway seçenekleri)
• Çalışma alanı konumu ve başlangıç dosyaları
• Gateway ayarları (bağlantı noktası, bağlama, kimlik doğrulama, tailscale)
• Kanallar ve sağlayıcılar (Telegram, WhatsApp, Discord, Google Chat, Mattermost, Signal, iMessage ve diğer paketlenmiş kanal pluginleri)
• Daemon kurulumu (LaunchAgent, systemd kullanıcı birimi veya Startup klasörü yedeğiyle yerel Windows Scheduled Task)
• Sağlık kontrolü
• Skills kurulumu

Uzak mod, bu makineyi başka bir yerdeki bir gateway'e bağlanacak şekilde yapılandırır. Uzak ana makinede hiçbir şey kurmaz veya değiştirmez.

Yerel akış ayrıntıları

Uzak mod ayrıntıları

Uzak mod, bu makineyi başka bir yerdeki bir gateway'e bağlanacak şekilde yapılandırır.

Ayarladıklarınız:

• Uzak gateway URL'si (ws://...)
• Uzak gateway kimlik doğrulaması gerekiyorsa token (ö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.
• Özel sağlayıcı ilk katılımı, yaygın model kimlikleri için görsel desteğini çıkarır ve yalnızca model adı bilinmediğinde sorar.
• İlk katılım bir sağlayıcı kimlik doğrulama seçiminden başladığında, model seçici o sağlayıcıyı otomatik olarak tercih eder. Volcengine ve BytePlus için aynı tercih onların coding-plan varyantlarıyla da eşleşir (volcengine-plan/*, byteplus-plan/*).
• Bu tercih edilen sağlayıcı filtresi boş olacaksa, seçici hiç model göstermemek yerine tam kataloğa geri döner.
• Sihirbaz bir model kontrolü ç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: ~/.openclaw/credentials/oauth.json

Kimlik bilgisi depolama modu:

• Varsayılan ilk kurulum davranışı, API anahtarlarını kimlik doğrulama profillerinde düz metin değerler olarak kalıcılaştırır.
• --secret-input-mode ref, düz metin anahtar depolama yerine referans modunu etkinleştirir. Etkileşimli kurulumda şunlardan birini seçebilirsiniz:
  • ortam değişkeni referansı (örneğin keyRef: { source: "env", provider: "default", id: "OPENAI_API_KEY" })
  • sağlayıcı takma adı + id ile yapılandırılmış sağlayıcı referansı (file veya exec)
• Etkileşimli referans modu, kaydetmeden önce hızlı bir ön kontrol doğrulaması çalıştırır.
  • Env referansları: geçerli ilk kurulum ortamında değişken adını + boş olmayan değeri doğrular.
  • Sağlayıcı referansları: sağlayıcı yapılandırmasını doğrular ve istenen id'yi çözümler.
  • Ön kontrol başarısız olursa, ilk kurulum hatayı gösterir ve yeniden denemenize izin verir.
• Etkileşimli olmayan modda, --secret-input-mode ref yalnızca env desteklidir.
  • Sağlayıcı env değişkenini ilk kurulum işlemi ortamında ayarlayın.
  • Satır içi anahtar bayrakları (örneğin --openai-api-key), o env değişkeninin ayarlanmış olmasını gerektirir; aksi halde ilk kurulum hızlıca başarısız olur.
  • Özel sağlayıcılar için, etkileşimli olmayan ref modu 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 için CUSTOM_API_KEY ayarlanmış olmalıdır; aksi halde ilk kurulum 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:
  • Token modu: Düz metin token oluştur/depolama (varsayılan) veya SecretRef kullan.
  • Parola modu: düz metin veya SecretRef.
• Etkileşimli olmayan token 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
• --skip-bootstrap geçirildiğinde agents.defaults.skipBootstrap
• agents.defaults.model / models.providers (Minimax seçilirse)
• tools.profile (yerel ilk kurulum, ayarlanmamışsa varsayılan olarak "coding" kullanır; mevcut açık değerler korunur)
• gateway.* (mod, bağlama, kimlik doğrulama, tailscale)
• session.dmScope (yerel ilk kurulum, 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 kabul ettiğinizde kanal izin listeleri (Slack, Discord, Matrix, Microsoft Teams) (mümkün olduğunda adlar ID'lere çözümlenir)
• skills.install.nodeManager
  • setup --node-manager bayrağı npm, pnpm veya bun kabul eder.
  • Elle yapılandırma daha sonra hâlâ skills.install.nodeManager: "yarn" ayarlayabilir.
• wizard.lastRunAt
• wizard.lastRunVersion
• wizard.lastRunCommit
• wizard.lastRunCommand
• wizard.lastRunMode
• wizard.securityAcknowledgedAt

openclaw agents add, agents.list[] ve isteğe bağlı bindings yazar.

WhatsApp kimlik bilgileri ~/.openclaw/credentials/whatsapp/<accountId>/ altına gider. 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), ilk kurulum 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ında 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 WSL içinde Linux signal-cli akışını izler

İlgili belgeler

• İlk kurulum merkezi: İlk Kurulum (CLI)
• Otomasyon ve betikler: CLI Otomasyonu
• Komut başvurusu: openclaw onboard