First steps
Başlarken
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.
İhtiyacınız olanlar
- Node.js — Node 24 önerilir (Node 22.14+ da desteklenir)
- Bir model sağlayıcısından API key (Anthropic, OpenAI, Google vb.) — onboarding sizden isteyecektir
Hızlı kurulum
OpenClaw'ı kurun
macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash
Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex
Onboarding'i çalıştırın
openclaw onboard --install-daemon
Sihirbaz; model sağlayıcı seçme, API key ayarlama ve Gateway yapılandırma adımlarında size rehberlik eder. Yaklaşık 2 dakika sürer.
Tam başvuru için bkz. Onboarding (CLI).
Gateway'in çalıştığını doğrulayın
openclaw gateway status
Gateway'in 18789 portunda dinlediğini görmelisiniz.
Panoyu açın
openclaw dashboard
Bu, tarayıcınızda Control UI'yı açar. Yüklenirse her şey çalışıyordur.
İlk mesajınızı gönderin
Control UI sohbetine bir mesaj yazın; AI yanıtı almalısınız.
Bunun yerine telefonunuzdan mı sohbet etmek istiyorsunuz? Kurulumu en hızlı kanal Telegram olur (yalnızca bir bot token gerekir). Tüm seçenekler için Channels bölümüne bakın.
Gelişmiş: özel bir Control UI derlemesi bağlayın
Yerelleştirilmiş veya özelleştirilmiş bir pano derlemesi 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.
Sonra şunu ayarlayın:
{
"gateway": {
"controlUi": {
"enabled": true,
"root": "$HOME/.openclaw/control-ui-custom"
}
}
}
Gateway'i yeniden başlatın ve panoyu yeniden açın:
openclaw gateway restart
openclaw dashboard
Sonraki adımda ne yapılmalı
Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo ve daha fazlası.
Ajanınıza kimlerin mesaj gönderebileceğini denetleyin.
Modeller, araçlar, sandbox ve gelişmiş ayarlar.
Tarayıcı, exec, web araması, Skills ve Plugin'ler.
Gelişmiş: ortam değişkenleri
OpenClaw'ı bir hizmet hesabı olarak çalıştırıyorsanız veya özel yollar istiyorsanız:
OPENCLAW_HOME— iç yol çözümlemesi için ana dizinOPENCLAW_STATE_DIR— durum dizinini geçersiz kılarOPENCLAW_CONFIG_PATH— yapılandırma dosyası yolunu geçersiz kılar
Tam başvuru: Ortam değişkenleri.