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ı (her --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) şu adımlarda size rehberlik eder:

• 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 önyükleme 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 arama sağlayıcısı (isteğe bağlı)
• Arka plan hizmeti kurulumu (LaunchAgent, systemd kullanıcı birimi veya Başlangıç klasörü yedek seçeneğine 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 bilgisayarda 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 Gateway'e bağlanacak şekilde yapılandırır. Uzak ana bilgisayarda hiçbir şey kurmaz veya 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 kullanım

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 bir 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ızla 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çeneğinden başlatıldığında model seçici, bu 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 aktarma kaynağı: ~/.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ğerler olarak kalıcılaştırır.
• --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ı + kimlik içeren 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ının 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ılar için 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çilmişse)
• 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 (ayarlanmamışsa yerel ilk katılım bunu varsayılan olarak per-channel-peer değerine ayarlar; 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 (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" 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ı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.

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"

Tüm 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ı oluşturabilir.

Signal kurulum davranışı

• Resmî signal-cli GitHub sürümlerinden uygun sürüm varlığını indirir (yerel derleme, yalnızca Linux x86-64)
• Diğer platformlarda (macOS, x64 olmayan Linux) bunun yerine Homebrew aracılığıyla yükler
• Sürüm varlığı kurulumunu ~/.openclaw/tools/signal-cli/<version>/ altında saklar
• Yapılandırmaya channels.signal.cliPath yazar
• Yerel Windows henüz desteklenmiyor; 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