CLI kurulum referansı

Bu sayfa, adım adım ilk katılım davranışını, çıktılarını ve iç işleyişini kapsar. Adım adım açıklama için İlk Katılım (CLI) sayfasına bakın. Tam CLI bayrak referansı (tüm --flag, etkileşimsiz örnekler, sağlayıcıya özgü komutlar) için openclaw onboard sayfasına bakın.

Sihirbaz ne yapar?

Yerel mod (varsayılan) aşağıdaki adımlarda size yol gösterir:

• Model ve kimlik doğrulama kurulumu (Anthropic, OpenAI Code aboneliği OAuth, xAI, OpenCode, özel uç noktalar ve sağlayıcıların yönettiği diğer kimlik doğrulama akışları)
• Ç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 (Discord, Feishu, Google Chat, iMessage, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp ve diğer paketlenmiş kanallar veya plugin kanalları)
• Web araması sağlayıcısı (isteğe bağlı)
• Arka plan hizmeti kurulumu (LaunchAgent, systemd kullanıcı birimi veya Başlangıç klasörü geri dönüşüne sahip yerel Windows Zamanlanmış Görevi)
• Sistem durumu denetimi
• Skills kurulumu

Uzak mod, bu makineyi başka bir yerdeki Gateway'e bağlanacak şekilde yapılandırır. Uzak ana bilgisayara hiçbir şey yüklemez veya orada hiçbir şeyi değiştirmez.

Yerel akış ayrıntıları

Uzak mod ayrıntıları

Uzak mod, bu makineyi başka bir yerdeki Gateway'e bağlanacak şekilde yapılandırır. Uzak ana bilgisayara hiçbir şey yüklemez veya orada hiçbir şeyi değiştirmez.

Ayarladıklarınız:

• Uzak Gateway URL'si (ws://... veya wss://...)
• Uzak Gateway yapılandırmasıyla eşleşen belirteç, parola veya kimlik doğrulamasız erişim

Kimlik doğrulama ve model seçenekleri

Etkileşimli ilk katılım sırasında bir sağlayıcı kurulum adımı başarısız olursa (örneğin yerel oturum açma olmadan CLI yeniden kullanım seçeneği), sihirbaz çıkmak yerine hatayı gösterir ve sağlayıcı seçicisine döner. Açık --auth-choice çalıştırmaları otomasyon için yine hızlıca başarısız olur.

Model davranışı:

• Algılanan seçeneklerden varsayılan modeli seçin veya sağlayıcıyı ve modeli elle girin.
• İlk katılım bir sağlayıcı kimlik doğrulama seçimiyle başladığında model seçici, söz konusu sağlayıcıyı otomatik olarak tercih eder. Volcengine ve BytePlus için aynı tercih, kodlama planı çeşitleriyle de eşleşir (volcengine-plan/*, byteplus-plan/*).
• Tercih edilen sağlayıcı filtresi boş sonuç verecekse 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ılan 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 aktarımı: ~/.openclaw/credentials/oauth.json

Kimlik bilgisi saklama modu:

• Varsayılan ilk katılım davranışı, API anahtarlarını kimlik doğrulama profillerinde düz metin değerleri olarak kalıcı hâle getirir.
• --secret-input-mode ref, düz metin anahtar saklama yerine başvuru modunu 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ı + kimliğiyle yapılandırılmış sağlayıcı başvurusu (file veya exec)
• Etkileşimli başvuru modu, kaydetmeden önce hızlı bir ön kontrol doğrulaması çalıştırır.
  • Ortam değişkeni başvuruları: geçerli ilk katılım ortamında değişken adını ve değerin boş olmadığını doğrular.
  • Sağlayıcı başvuruları: sağlayıcı yapılandırmasını doğrular ve istenen kimliği çözümler.
  • Ön kontrol başarısız olursa ilk katılım hatayı gösterir ve yeniden denemenize olanak tanır.
• Etkileşimsiz modda --secret-input-mode ref yalnızca ortam değişkeni desteklidir.
  • Sağlayıcı ortam değişkenini ilk katılım işleminin ortamında ayarlayın.
  • Satır içi anahtar bayrakları (örneğin --openai-api-key), bu ortam değişkeninin ayarlanmasını gerektirir; aksi takdirde ilk katılım hemen başarısız olur.
  • Özel sağlayıcılarda etkileşimsiz ref modu, models.providers.<id>.apiKey değerini { source: "env", provider: "default", id: "CUSTOM_API_KEY" } olarak saklar.
  • Bu özel sağlayıcı durumunda --custom-api-key, CUSTOM_API_KEY değerinin ayarlanmasını gerektirir; aksi takdirde ilk katılım hemen başarısız olur.
• Gateway kimlik doğrulama bilgileri, etkileşimli kurulumda düz metin ve SecretRef seçeneklerini destekler:
  • Token modu: Düz metin token oluştur/sakla (varsayılan) veya SecretRef kullan.
  • Parola modu: düz metin veya SecretRef.
• Etkileşimsiz 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ç işleyiş

~/.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çildiyse)
• tools.profile (ayarlanmamışsa yerel ilk katılım varsayılan olarak "coding" kullanır; mevcut açık değerler korunur)
• gateway.* (mod, bağlama, kimlik doğrulama, Tailscale)
• session.dmScope (ilk katılım açık değerleri korur; aksi durumda ayarlanmamış bırakır. Böylece main varsayılanı, tüm kanallardaki doğrudan mesajları ajanın devamlı ana oturumunda tutar; bu, kişisel ajan varsayılanıdır. Paylaşılan veya çok kullanıcılı gelen kutuları için per-channel-peer kullanın; openclaw security audit, çok kullanıcılı DM trafiği algıladığında yalıtım önerir)
• channels.telegram.botToken, channels.discord.token, channels.matrix.*, channels.signal.*, channels.imessage.*
• İstemler sırasında etkinleştirdiğinizde kanal izin listeleri (Discord, iMessage, Signal, Slack, Telegram, WhatsApp); Discord ve Slack ayrıca girilen adları kimliklere çözümler
• skills.install.nodeManager
  • setup --node-manager bayrağı npm, pnpm veya bun kabul eder.
  • Elle yapılandırma daha sonra yine skills.install.nodeManager: "yarn" değerini ayarlayabilir.
• wizard.lastRunAt
• wizard.lastRunVersion
• wizard.lastRunCommit
• wizard.lastRunCommand
• wizard.lastRunMode
• wizard.securityAcknowledgedAt

openclaw agents add, agents.entries.* ve isteğe bağlı bindings dosyasını yazar.

WhatsApp kimlik bilgileri ~/.openclaw/credentials/whatsapp/<accountId>/ altında bulunur. Etkin oturumlar ve transkriptler ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite içinde saklanır. ~/.openclaw/agents/<agentId>/sessions/ dizini, eski geçiş girdileri ve arşiv/destek yapıtları için kullanılır.

Yüklü uygulama önerileri

Model erişim denetimi başarılı olduktan sonra macOS'taki klasik etkileşimli ilk katılım, macOS gizlilik izinlerini istemeden uygulama adlarını ve paket kimliklerini tarar. Resmî Plugin kataloglarında ve ClawHub'da arama yapar, ardından yapılandırılan modelden hatalı ad eşleşmelerini reddetmesini ve ilgili Plugin'leri veya Skills'i önermesini ister. Önerilen eşleşmeler varsayılan olarak seçilir; isteğe bağlı eşleşmeler açıkça seçilmelidir.

Sonuç ekranı algılanan uygulamaları listeler ve şunu gösterir: "Uygulama adları, yapılandırdığınız model ve ClawHub araması kullanılarak eşleştirildi." Hem bu ilk katılım adımını hem de Gateway'in Node uygulama envanterlerine erişimini devre dışı bırakmak için wizard.appRecommendations değerini false olarak ayarlayın. Tarama, hızlı başlangıçta veya macOS dışındaki ilk katılımda kullanılmaz.

Etkileşimsiz kurulum

--non-interactive, --accept-risk gerektirir (ajanların güçlü olduğunu ve tam sistem erişiminin riskli olduğunu kabul eder):

openclaw onboard --non-interactive --accept-risk \  --auth-choice apiKey \  --anthropic-api-key "$ANTHROPIC_API_KEY"

Tam bayrak başvurusu ve sağlayıcıya özgü örnekler: openclaw onboard, CLI otomasyonu.

Gateway sihirbazı RPC'si

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

İstemciler (macOS uygulaması ve Control UI), ilk katılım mantığını yeniden uygulamadan adımları işleyebilir.

Signal kurulum davranışı

• Uygun sürüm varlığını resmî signal-cli GitHub sürümlerinden indirir (yerel derleme, yalnızca Linux x86-64)
• Diğer platformlarda (macOS, x64 olmayan Linux) bunun yerine Homebrew aracılığıyla kurar
• Sürüm varlığı kurulumunu ~/.openclaw/tools/signal-cli/<version>/ altında saklar
• Yapılandırmaya kind: "managed-native" ile birlikte channels.signal.transport.cliPath yazar
• Yerel Windows henüz desteklenmemektedir; Linux kurulum yolunu edinmek için ilk katılımı WSL2 içinde çalıştırın

İlgili belgeler

• İlk katılım merkezi: İlk katılım (CLI)
• Otomasyon ve betikler: CLI Otomasyonu
• Komut başvurusu: openclaw onboard