Ana içeriğe atla

​
Başlangıç

OpenClaw’ı kurun, onboarding’i çalıştırın ve AI asistanınızla sohbet edin — hepsi yaklaşık 5 dakika içinde. Sonunda çalışan bir Gateway, yapılandırılmış kimlik doğrulama ve çalışan bir sohbet oturumunuz olacak.

​
Gerekenler

  • Node.js — Node 24 önerilir (Node 22.14+ da desteklenir)
  • Bir model sağlayıcısından API anahtarı (Anthropic, OpenAI, Google vb.) — onboarding sizden bunu isteyecektir
Node sürümünüzü node --version ile kontrol edin. Windows kullanıcıları: hem yerel Windows hem de WSL2 desteklenir. WSL2 daha kararlıdır ve tam deneyim için önerilir. Bkz. Windows. Node kurmanız mı gerekiyor? Bkz. Node kurulumu.

​
Hızlı kurulum

1

OpenClaw'ı kurun

curl -fsSL https://openclaw.ai/install.sh | bash
Kurulum Betiği Süreci
Diğer kurulum yöntemleri (Docker, Nix, npm): Kurulum.
2

Onboarding'i çalıştırın

openclaw onboard --install-daemon
Sihirbaz; model sağlayıcısı seçme, API anahtarı ayarlama ve Gateway yapılandırma adımlarında size yol gösterir. Yaklaşık 2 dakika sürer.Tam başvuru için bkz. Onboarding (CLI).
3

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

openclaw gateway status
Gateway’in 18789 portunda dinlediğini görmelisiniz.
4

Kontrol panelini açın

openclaw dashboard
Bu, tarayıcınızda Control UI’ı açar. Yükleniyorsa her şey çalışıyor demektir.
5

İlk mesajınızı gönderin

Control UI sohbetinde bir mesaj yazın; bir AI yanıtı almalısınız.Bunun yerine telefonunuzdan mı sohbet etmek istiyorsunuz? Kurulumu en hızlı olan kanal Telegram’dır (yalnızca bir bot token gerekir). Tüm seçenekler için bkz. Kanallar.
Yerelleştirilmiş veya özelleştirilmiş bir gösterge paneli yapısını yönetiyorsanız, gateway.controlUi.root değerini derlenmiş statik varlıklarınızı ve index.html dosyanızı 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 kontrol panelini tekrar açın:
openclaw gateway restart
openclaw dashboard

​
Sırada ne var

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

Ajanınıza kimin mesaj gönderebileceğini denetleyin.

Gateway'i yapılandırın

Modeller, araçlar, sandbox ve gelişmiş ayarlar.

Araçlara göz atın

Tarayıcı, exec, web araması, skills ve plugin’ler.
OpenClaw’ı bir hizmet hesabı olarak çalıştırıyorsanız veya özel yollar istiyorsanız:
  • OPENCLAW_HOME — dahili yol çözümleme için ana dizin
  • OPENCLAW_STATE_DIR — durum dizinini geçersiz kılar
  • OPENCLAW_CONFIG_PATH — config dosyası yolunu geçersiz kılar
Tam başvuru: Ortam değişkenleri.