Ilk adimlar
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
Hızlı kurulum
OpenClaw'u yükleyin
macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bashWindows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iexİlk kurulumu çalıştırın
openclaw onboard --install-daemonSihirbaz; 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 statusGateway'in 18789 numaralı portu dinlediğini görmelisiniz.
Panoyu açın
openclaw dashboardBu 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 restartopenclaw dashboardSonraki adımlar
Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo ve daha fazlası.
Agent'ınıza kimlerin mesaj gönderebileceğini denetleyin.
Modeller, araçlar, korumalı alan ve ileri düzey ayarlar.
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 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.