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

First steps

İlk Kurulum (CLI)

CLI ile ilk kurulum, OpenClaw'ı macOS, Linux veya Windows üzerinde (WSL2 aracılığıyla; kesinlikle önerilir) kurmanın önerilen yoludur. Tek bir rehberli akışta yerel bir Gateway veya uzak bir Gateway bağlantısının yanı sıra kanalları, Skills'i ve çalışma alanı varsayılanlarını yapılandırır.

bash
openclaw onboard

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

bash
openclaw configureopenclaw agents add <name>

Hızlı Başlangıç ve Gelişmiş

İlk kurulum Hızlı Başlangıç (varsayılanlar) ile Gelişmiş (tam denetim) seçenekleriyle başlar.

Hızlı Başlangıç (varsayılanlar)

  • Yerel gateway (loopback)
  • Çalışma alanı varsayılanı (veya mevcut çalışma alanı)
  • Gateway bağlantı noktası 18789
  • Gateway kimlik doğrulaması Token (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 Referansı
  • Tailscale yayını Kapalı
  • Telegram + WhatsApp DM'leri varsayılan olarak izin listesi kullanır (telefon numaranız istenir)

Gelişmiş (tam denetim)

  • 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 özgü manuel kimlik doğrulama) seçin (OpenAI uyumlu, Anthropic uyumlu veya Unknown otomatik algılama). Varsayılan model seçin. Güvenlik notu: Bu agent araçları çalıştıracaksa veya webhook/hooks içeriğini işleyecekse mevcut en güçlü en yeni nesil modeli tercih edin ve araç ilkesini katı tutun. Daha zayıf/eski kademelere prompt enjeksiyonu yapmak daha kolaydır. Etkileşimsiz çalıştırmalarda --secret-input-mode ref, auth profillerinde düz metin API anahtarı değerleri yerine 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ğrulama ile bir ortam değişkenini veya yapılandırılmış bir sağlayıcı referansını (file veya 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 key sunar. Anthropic setup-token da desteklenen token kimlik doğrulama yolu olarak kullanılabilir kalır.
  2. Çalışma Alanı — Agent dosyalarının konumu (varsayılan ~/.openclaw/workspace). Önyükleme dosyalarını hazırlar.
  3. Gateway — Bağlantı noktası, bağlama adresi, kimlik doğrulama modu, Tailscale yayını. 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 — iMessage, Discord, Feishu, Google Chat, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp ve daha fazlası gibi yerleşik ve paketlenmiş sohbet kanalları.
  5. Daemon — Bir LaunchAgent (macOS), systemd kullanıcı birimi (Linux/WSL2) veya kullanıcı başına Başlangıç klasörü yedeğiyle yerel Windows Scheduled Task kurar. Token kimlik doğrulaması token gerektiriyorsa ve gateway.auth.token SecretRef ile yönetiliyorsa daemon kurulumu bunu doğrular ancak çözümlenen token'ı supervisor servis ortamı meta verilerine kalıcı olarak yazmaz. Token kimlik doğrulaması token gerektiriyorsa ve yapılandırılmış token SecretRef çözümlenemiyorsa daemon kurulumu uygulanabilir rehberlikle engellenir. Hem gateway.auth.token hem de gateway.auth.password yapılandırılmışsa ve gateway.auth.mode ayarlanmamışsa daemon kurulumu, mod açıkça ayarlanana kadar 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ı yükler.

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

Başka bir agent ekleyin

Kendi çalışma alanı, oturumları ve auth profilleri olan ayrı bir agent 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> düzenini izler.
  • Gelen mesajları yönlendirmek için bindings ekleyin (ilk kurulum bunu yapabilir).
  • Etkileşimsiz bayraklar: --model, --agent-dir, --bind, --non-interactive.

Tam referans

Ayrıntılı adım adım dökümler ve yapılandırma çıktıları için CLI Kurulum Referansı bölümüne bakın. Etkileşimsiz örnekler için CLI Otomasyonu bölümüne bakın. RPC ayrıntıları dahil daha derin teknik referans için İlk Kurulum Referansı bölümüne bakın.

İlgili belgeler

Was this useful?