Başlarken

OpenClaw’u yükleyin, ilk kurulumu çalıştırın ve yaklaşık 5 dakika içinde yapay zekâ asistanınızla sohbet edin. İşlem tamamlandığında çalışan bir Gateway’e, yapılandırılmış kimlik doğrulamaya ve çalışan bir sohbet oturumuna sahip olacaksınız.

Gereksinimler

Node.js 22.22.3+, 24.15+ veya 25.9+ (önerilen varsayılan sürüm 24’tür)
Bir model sağlayıcısından (Anthropic, OpenAI, Google vb.) API anahtarı — ilk kurulum sırasında istenir

Node sürümünüzü node --version ile kontrol edin. Windows kullanıcıları: Yerel Windows Hub uygulaması, masaüstünde kullanmaya başlamanın en kolay yoludur. PowerShell yükleyicisi ve WSL2 Gateway yolları da desteklenir. Bkz. Windows. Node’u yüklemeniz mi gerekiyor? Bkz. Node kurulumu.

Hızlı kurulum

OpenClaw'u yükleyin

macOS / Linux
Windows (PowerShell)

curl -fsSL https://openclaw.ai/install.sh | bash

iwr -useb https://openclaw.ai/install.ps1 | iex

Diğer yükleme yöntemleri (Docker, Nix, npm): Yükleme.

İlk kurulumu çalıştırın

openclaw onboard --install-daemon

Sihirbaz; model sağlayıcısı seçme, API anahtarı ayarlama ve Gateway’i yapılandırma adımlarında size yol gösterir. QuickStart genellikle yalnızca birkaç dakika sürer ancak sağlayıcıda oturum açma, kanal eşleştirme, arka plan hizmeti kurulumu, ağ indirmeleri, Skills veya isteğe bağlı pluginler tam ilk kurulumun daha uzun sürmesine neden olabilir. İsteğe bağlı adımları atlayıp daha sonra openclaw configure ile geri dönebilirsiniz.Tam başvuru için İlk Kurulum (CLI) bölümüne bakın.

Gateway'in çalıştığını doğrulayın

openclaw gateway status

Gateway’in 18789 numaralı portu dinlediğini görmelisiniz.

Panoyu açın

openclaw dashboard

Bu komut, Control UI’ı tarayıcınızda açar. Yüklenirse her şey çalışıyor demektir.

İlk mesajınızı gönderin

Control UI sohbetine bir mesaj yazdığınızda yapay zekâdan yanıt almanız gerekir.Bunun yerine telefonunuzdan mı sohbet etmek istiyorsunuz? Kurulumu en hızlı kanal Telegram’dir (yalnızca bir bot token’ı gerekir). Tüm seçenekler için Kanallar bölümüne bakın.

İleri düzey: özel bir Control UI derlemesi bağlayın

Yerelleştirilmiş veya özelleştirilmiş bir pano derlemesinin bakımını yapıyorsanız gateway.controlUi.root değerini, derlenmiş statik varlıklarınızı ve index.html öğesini içeren bir dizine yönlendirin.

mkdir -p "$HOME/.openclaw/control-ui-custom"
# Derlenmiş statik dosyalarınızı bu dizine kopyalayın.

Ardından şunu ayarlayın:

{
  "gateway": {
    "controlUi": {
      "enabled": true,
      "root": "$HOME/.openclaw/control-ui-custom"
    }
  }
}

Gateway’i yeniden başlatın ve panoyu tekrar açın:

openclaw gateway restart
openclaw dashboard

Sonraki adımlar

Bir kanal bağlayın

Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo ve daha fazlası.

Eşleştirme ve güvenlik

Agent’ınıza kimlerin mesaj gönderebileceğini denetleyin.

Gateway'i yapılandırın

Modeller, araçlar, korumalı alan ve ileri düzey ayarlar.

Araçlara göz atın

Tarayıcı, yürütme, web araması, Skills ve pluginler.

İleri düzey: ortam değişkenleri

OpenClaw’u bir hizmet hesabıyla çalıştırıyorsanız veya özel yollar kullanmak istiyorsanız:

OPENCLAW_HOME — dahili yol çözümlemesi için ana dizin
OPENCLAW_STATE_DIR — durum dizinini geçersiz kılar
OPENCLAW_CONFIG_PATH — yapılandırma dosyası yolunu geçersiz kılar

Tam başvuru: Ortam değişkenleri.

Genel bakis

Ilk adimlar

Guides

Gereksinimler

Hızlı kurulum

Sonraki adımlar

Bir kanal bağlayın

Eşleştirme ve güvenlik

Gateway'i yapılandırın

Araçlara göz atın

İlgili

​Gereksinimler

​Hızlı kurulum

​Sonraki adımlar

Bir kanal bağlayın

Eşleştirme ve güvenlik

Gateway'i yapılandırın

Araçlara göz atın

​İlgili

Gereksinimler

Hızlı kurulum

Sonraki adımlar

İlgili