OpenClaw'ı kendi sunucunuzda çalıştırma
OpenClaw, MIT lisanslı açık kaynaklı bir kişisel ajan ağ geçididir: sohbet uygulamalarınızı seçtiğiniz model sağlayıcılarına bağlayan ve sizin için araçları çalıştıran tek bir süreçtir. Bu bölümde OpenClaw'ı dizüstü bilgisayara, VPS'ye, Docker'a veya Raspberry Pi'ye kurmayı, modelleri ve Telegram'ı bağlamayı, uzaktan erişmeyi ve güvenli hâle getirmeyi öğrenin.
- En son sürüm
2026.9.7· 30 Eylül 2026- Uzun süre desteklenen kararlı sürüm
2026.8.33- Lisans
- MIT · openclaw/openclaw · 391.000 GitHub yıldızı
- Çalışma zamanı
- Node.js 24.16+ / 26.1+
- Minimum ana makine gereksinimleri
- 1 vCPU, 1 GB RAM, 500 MB disk alanı
- Varsayılan port
127.0.0.1:18789- Yapılandırma dosyası
~/.openclaw/openclaw.json
Hızlı kurulum
Yükleyici betiği Node'u ve openclaw CLI'yi kurar, ardından ilk yapılandırmayı başlatır. macOS'ta Node 26'yı, Linux'ta Node 24 LTS'yi kurar; yerel Windows kurulumunda PowerShell yükleyicisini kullanın.
curl -fsSL https://openclaw.ai/install.sh | bashiwr -useb https://openclaw.ai/install.ps1 | iexGateway portunu asla internete açmayın: OpenClaw varsayılan olarak loopback adresine bağlanır ve token gerektirir; her iki ayarı da olduğu gibi bırakın. 2026'da yapılan internet taramalarında, internete açık on binlerce OpenClaw gateway'i tespit edildi.
Adım adım kılavuzlar
OpenClaw'ı yükleyin
openclaw CLI'ı resmî script, PowerShell yükleyicisi veya npm ile yükleyin. Ardından ilk kurulumun yapılandırmayı, gateway token'ını ve arka plan hizmetini oluşturmasını sağlayın.
OpenClaw'ı VPS'te çalıştırın
Agent'ın dizüstü bilgisayarınız kapalıyken de çevrimiçi kalması için OpenClaw'ı küçük bir Linux sunucusuna kurun; gateway'i internete açmanız gerekmez.
OpenClaw'u Docker'da çalıştırın
Gateway'i ve CLI'ı Docker Compose servisleri olarak çalıştırın. Bunları kaynak koddan derleyebilir veya önceden derlenmiş ghcr.io/openclaw/openclaw image'ını indirebilirsiniz.
OpenClaw'u Raspberry Pi'da çalıştırın
Modeller başka bir yerde çalıştığı sürece Raspberry Pi, sessiz ve sürekli açık bir OpenClaw sunucusu olarak kullanılabilir.
Modelleri OpenClaw'a bağlayın
OpenClaw'a bir bulut sağlayıcısının API anahtarını verip varsayılan modeli seçin ya da LM Studio veya vLLM gibi yerel bir sunucuya yönlendirin.
OpenClaw'ı Telegram'a bağlayın
Telegram, OpenClaw'ın çekirdek bileşenlerine dahildir. Bir bot oluşturun, token'ını gateway'e verin ve hesabınızı eşleştirme koduyla onaylayın.
OpenClaw gateway'inizi güvenli hâle getirin
OpenClaw belgelerindeki güvenli temel yapılandırmayı uygulayın: loopback ve token kimlik doğrulaması, sandbox, katı exec onayları ve agent'a kimlerin mesaj gönderebileceği üzerinde sıkı denetim.
OpenClaw'a uzaktan erişim
Loopback bind ayarını değiştirmeden, başka bir makinedeki gateway'in kontrol paneline SSH tüneli veya Tailscale üzerinden erişin.
Güvenliği sıkılaştırılmış temel yapılandırma
Bu değerler, OpenClaw belgelerindeki güvenliği sıkılaştırılmış temel yapılandırmadan alınmıştır. Bunlarla başlayın, bir ayarı yalnızca iş akışınız gerektiriyorsa gevşetin ve her değişiklikten sonra güvenlik denetimini yeniden çalıştırın.
| Ayar | Değer | Önemi |
|---|---|---|
gateway.bind | loopback | Gateway'e yalnızca aynı makinedeki süreçler erişebilir. Uzaktan erişim için SSH tüneli veya Tailscale kullanın. |
gateway auth | token | Her istemci token sunmalıdır. En az 24 karakter kullanın; daha kısa token'lar denetimde uyarıya neden olur. |
session.dmScope | per-channel-peer | Her kanaldaki her gönderici için ayrı bir oturum açılır; böylece kimse başka birinin bağlamını göremez. |
tools.profile | messaging | Ajanı, mevcut tüm araçlar yerine dar kapsamlı ve mesajlaşmaya odaklı bir araç kümesiyle başlatır. |
fs.workspaceOnly | true | Dosya araçlarını ajan çalışma alanıyla sınırlar; SSH anahtarlarına, kimlik bilgilerine ve diskin geri kalanına erişmelerini önler. |
exec.security | deny | Kabuk komutlarını tamamen engeller. Gateway sunucularında varsayılan değer full'dür ve tüm komutlara izin verir. |
exec.ask | always | exec.security ayarını daha sonra gevşetirseniz her komut onay bekler; kimse yanıt vermezse askFallback komutu reddeder. |
elevated.enabled | false | /elevated sohbet komutunu devre dışı bırakır; böylece hiçbir gönderici ajanı yükseltilmiş moda geçiremez. |
dmPolicy | pairing | Yeni göndericilere sizin onaylamanız gereken bir kod verilir. Kodların süresi bir saat sonra dolar; aynı anda en fazla üç kod beklemede olabilir. |
groups.requireMention | true | Grup sohbetlerinde ajan, gönderilen her mesaja değil, yalnızca kendisinden bahsedildiğinde yanıt verir. |
Sohbet kanalları
Telegram, WebChat, A2A ve Reef çekirdek pakete dahildir; diğerleri resmî eklentilerdir. Telegram varsayılan olarak long polling kullanır, bu nedenle herkese açık bir webhook URL'si gerekmez.
İsim geçmişi
Peter Steinberger projeyi Kasım 2025'te Clawdbot adıyla başlattı. Anthropic'in marka başvurusunun ardından proje 27 Ocak 2026'da Moltbot, iki gün sonra, 29 Ocak 2026'da ise OpenClaw adını aldı. ABD'de 501(c)(3) statüsündeki kâr amacı gütmeyen OpenClaw Foundation, 8 Temmuz 2026'da duyuruldu.
OpenClaw hakkında sorular
OpenClaw'ı kendi sunucunuzda çalıştırmak ücretsiz mi?
Evet. OpenClaw MIT lisanslıdır ve kaynak kodu GitHub'da openclaw/openclaw deposunda bulunur. Modelleri yerel olarak çalıştırmadığınız sürece yalnızca OpenClaw'ın çalıştığı makine ve model API çağrıları için ödeme yaparsınız.
OpenClaw için minimum gereksinimler nelerdir?
Belgelerde 1 vCPU, 1 GB RAM ve yaklaşık 500 MB disk alanı ile Node.js 24.16+ veya 26.1+ listeleniyor. Önerilen değerler 1–2 vCPU ve en az 2 GB RAM. Bu değerler bulut model API'lerinin kullanıldığını varsayar; modelleri yerel olarak çalıştırmak çok daha fazla bellek gerektirir.
OpenClaw gateway hangi portu kullanır?
Varsayılan olarak 127.0.0.1 adresine bağlanan 18789 portunu kullanır. Tek bir süreç bu port üzerinden WebSocket, HTTP ve kontrol paneli hizmeti sunar. Portu gateway.port, --port flag'i veya OPENCLAW_GATEWAY_PORT ile değiştirebilirsiniz; ancak internet erişimine açmayın.
OpenClaw Windows'ta çalışır mı?
Evet. Yükleme sayfasında yerel Windows Hub uygulaması, PowerShell yükleyicisi ve WSL2 seçenekleri listeleniyor. Windows'ta arka plan hizmeti bir Zamanlanmış Görev olarak çalışır. SSS'nin bazı bölümlerinde hâlâ yalnızca WSL2'den söz ediliyor.
OpenClaw'ı makinemde çalıştırmak güvenli mi?
OpenClaw, ana makinede komut çalıştırabilir ve dosyalara erişebilir; bu nedenle ayarlar önemlidir. Gateway kimlik doğrulaması zorunludur ve varsayılan olarak loopback adresine bağlanır. Ancak sandbox varsayılan olarak kapalıdır ve gateway ana makinelerinde exec.security tam erişimlidir. Güvenliği sıkılaştırılmış temel yapılandırmayı uygulayın ve openclaw security audit --deep komutunu çalıştırın.
OpenClaw yapılandırmasını nerede saklar?
Yapılandırma dosyası ~/.openclaw/openclaw.json, agent çalışma alanı ise ~/.openclaw/workspace konumundadır. Her ikisini de yedeklerinize ekleyin ve yeni bir ana makineye geçerken kopyalayın.