English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

First steps

İlk Kurulum (CLI)

CLI ilk kurulum, OpenClaw’u macOS, Linux veya Windows üzerinde (WSL2 ile; kesinlikle önerilir) kurmanın önerilen yoludur. Tek bir yönlendirmeli akışta yerel bir Gateway veya uzak Gateway bağlantısını, ayrıca kanalları, Skills’i ve çalışma alanı varsayılanlarını yapılandırır.

openclaw onboard

Daha sonra yeniden yapılandırmak için:

openclaw configure
openclaw agents add <name>

QuickStart ve Advanced

İlk kurulum QuickStart (varsayılanlar) ile Advanced (tam kontrol) arasında seçimle başlar.

QuickStart (defaults)

  • Yerel Gateway (local loopback)
  • Çalışma alanı varsayılanı (veya mevcut çalışma alanı)
  • Gateway bağlantı noktası 18789
  • Gateway kimlik doğrulaması Token (local loopback üzerinde bile otomatik oluşturulur)
  • Yeni yerel kurulumlar için araç ilkesi varsayılanı: tools.profile: "coding" (mevcut açık profil korunur)
  • DM yalıtımı varsayılanı: yerel ilk kurulum, ayarlanmamışsa session.dmScope: "per-channel-peer" yazar. Ayrıntılar: CLI Kurulum Başvurusu
  • Tailscale dışa açma Kapalı
  • Telegram + WhatsApp DM’leri varsayılan olarak izin listesi kullanır (telefon numaranız istenir)

Advanced (full control)

  • Her adımı gösterir (mod, çalışma alanı, Gateway, kanallar, daemon, Skills).

İlk kurulumun yapılandırdıkları

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

  1. Model/Kimlik Doğrulama — Custom Provider dahil olmak üzere desteklenen herhangi bir sağlayıcıyı/kimlik doğrulama akışını (API anahtarı, OAuth veya sağlayıcıya özel manuel kimlik doğrulama) seçin (OpenAI uyumlu, Anthropic uyumlu veya Unknown otomatik algılama). Varsayılan bir model seçin. Güvenlik notu: Bu aracı araç çalıştıracak veya webhook/hooks içeriğini işleyecekse, mevcut en güçlü en yeni nesil modeli tercih edin ve araç ilkesini sıkı tutun. Daha zayıf/eski katmanlar prompt injection’a daha açıktır. Etkileşimsiz çalıştırmalarda --secret-input-mode ref, düz metin API anahtarı değerleri yerine kimlik doğrulama profillerinde ortam destekli referanslar saklar. Etkileşimsiz ref modunda sağlayıcı ortam değişkeni ayarlanmış olmalıdır; bu ortam değişkeni olmadan satır içi anahtar bayrakları geçirmek hızlıca başarısız olur. Etkileşimli çalıştırmalarda gizli referans modunu seçmek, kaydetmeden önce hızlı bir ön doğrulamayla bir ortam değişkenini veya yapılandırılmış bir sağlayıcı referansını (file ya da exec) göstermenizi sağlar. Anthropic için etkileşimli ilk kurulum/yapılandırma, tercih edilen yerel yol olarak Anthropic Claude CLI’ı ve önerilen üretim yolu olarak Anthropic API anahtarını sunar. Anthropic setup-token da desteklenen bir token kimlik doğrulama yolu olarak kullanılabilir kalır.
  2. Çalışma Alanı — Aracı dosyalarının konumu (varsayılan ~/.openclaw/workspace). Başlangıç dosyalarını ekler.
  3. Gateway — Bağlantı noktası, bağlama adresi, kimlik doğrulama modu, Tailscale dışa açma. Etkileşimli token modunda, varsayılan düz metin token depolamayı seçin veya SecretRef’e geçin. Etkileşimsiz token SecretRef yolu: --gateway-token-ref-env &lt;ENV_VAR&gt;.
  4. Kanallar — BlueBubbles, Discord, Feishu, Google Chat, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp ve daha fazlası gibi yerleşik ve paketli sohbet kanalları.
  5. Daemon — Bir LaunchAgent (macOS), systemd kullanıcı birimi (Linux/WSL2) veya kullanıcı başına Startup klasörü yedeğiyle yerel Windows Scheduled Task kurar. Token kimlik doğrulaması bir token gerektiriyorsa ve gateway.auth.token SecretRef tarafından yönetiliyorsa, daemon kurulumu bunu doğrular ancak çözümlenen token’ı denetleyici servis ortamı meta verilerine kalıcı olarak yazmaz. Token kimlik doğrulaması bir token gerektiriyorsa ve yapılandırılmış token SecretRef çözümlenemiyorsa, daemon kurulumu uygulanabilir yönlendirmeyle engellenir. Hem gateway.auth.token hem de gateway.auth.password yapılandırılmışsa ve gateway.auth.mode ayarlanmamışsa, mod açıkça ayarlanana kadar daemon kurulumu engellenir.
  6. Sağlık kontrolü — Gateway’i başlatır ve çalıştığını doğrular.
  7. Skills — Önerilen Skills’i ve isteğe bağlı bağımlılıkları kurar.

Uzak mod, yalnızca yerel istemciyi başka bir yerdeki Gateway’e bağlanacak şekilde yapılandırır. Uzak makinede hiçbir şey kurmaz veya değiştirmez.

Başka bir aracı ekleme

Kendi çalışma alanı, oturumları ve kimlik doğrulama profilleri olan ayrı bir aracı oluşturmak için openclaw agents add <name> kullanın. --workspace olmadan çalıştırmak ilk kurulumu başlatır.

Ayarladıkları:

  • agents.list[].name
  • agents.list[].workspace
  • agents.list[].agentDir

Notlar:

  • Varsayılan çalışma alanları ~/.openclaw/workspace-<agentId> biçimini izler.
  • Gelen iletileri yönlendirmek için bindings ekleyin (ilk kurulum bunu yapabilir).
  • Etkileşimsiz bayraklar: --model, --agent-dir, --bind, --non-interactive.

Tam başvuru

Ayrıntılı adım adım dökümler ve yapılandırma çıktıları için bkz. CLI Kurulum Başvurusu. Etkileşimsiz örnekler için bkz. CLI Otomasyonu. RPC ayrıntıları dahil daha derin teknik başvuru için bkz. İlk Kurulum Başvurusu.

İlgili belgeler