Blog

OpenClaw, mesajlaşma platformları üzerinden çalışan yapay zeka ajanlarını yönetmek için kullanılan açık kaynaklı bir araçtır. Bu aracı kendi sunucunuzda barındırarak verileriniz üzerinde tam kontrol sahibi olabilir, üçüncü taraf hizmetlere bağımlılığı ortadan kaldırabilirsiniz. OpenClaw’ı bir VPS üzerinde çalıştırmak için Linux tabanlı bir sunucu (Ubuntu 22.04 veya 24.04 LTS önerilir), SSH erişimi, bir yapay zeka modeli API anahtarı veya yerel çıkarım için Ollama kurulumu ve en az bir mesajlaşma platformu için kimlik bilgileri gerekir. Bu rehberde, OpenClaw’ı VPS üzerine kurmanın tüm adımlarını, gerekli yapılandırmaları ve karşılaşabileceğiniz sorunların çözümlerini ayrıntılı olarak ele alıyoruz.

OpenClaw, özellikle otomasyon ve iş akışlarınızı yapay zeka ajanlarıyla yönetmek istediğinizde güçlü bir çözüm sunar. Eğer bu aracı iş süreçlerinize entegre etmeyi planlıyorsanız, OpenClaw ile İş Otomasyonu rehberimiz de size yardımcı olabilir. Şimdi adım adım kurulum sürecine geçelim.

OpenClaw Kurulumu İçin Gereksinimler

OpenClawı bir VPS üzerinde çalıştırmak için aşağıdaki bileşenlere ihtiyacınız olacak:

• Linux VPS: Ubuntu 22.04 veya 24.04 LTS önerilir. En az 2 GB RAM ve 20 GB disk alanı iyi bir başlangıç noktasıdır. Daha yoğun kullanım için 4 GB RAM ve üzerini tercih edebilirsiniz.
• SSH erişimi: Sunucuya komut satırından bağlanmak için SSH istemcisi (Windows için PuTTY, macOS/Linux için terminal) gereklidir.
• AI modeli erişimi: Bir API anahtarı (örneğin OpenAI, Anthropic veya diğer sağlayıcıların) veya yerel olarak çalışan Ollama kurulumu. Ollama, açık kaynaklı modelleri kendi sunucunuzda çalıştırmanızı sağlar.
• Mesajlaşma platformu kimlik bilgileri: OpenClaw, Slack, Discord, Telegram gibi platformlarla entegre çalışır. Bu platformlardan birinde bot oluşturup API token almanız gerekir.

Bu gereksinimleri eksiksiz hazırladıktan sonra kuruluma başlayabilirsiniz.

Adım 1: VPS Hazırlığı ve SSH Bağlantısı

Öncelikle bir VPS satın almanız ve sunucuya root veya sudo yetkisine sahip bir kullanıcı ile SSH üzerinden bağlanmanız gerekir. VPS hizmeti seçerken, sınırsız bant genişliği ve iyi bir teknik destek sunan sağlayıcıları tercih etmelisiniz. VPS hosting hizmeti seçeneklerini değerlendirebilirsiniz.

Sunucuya bağlandıktan sonra aşağıdaki komutlarla sistem paketlerini güncelleyin:

sudo apt update && sudo apt upgrade -y

Ardından, kurulum için gerekli temel paketleri (git, curl, build-essential) yükleyin:

sudo apt install git curl build-essential -y

Adım 2: Node.js ve Gerekli Bağımlılıkların Kurulumu

OpenClaw, Node.js üzerinde çalışır. Node.js 18 veya 20 sürümlerini kurmanız önerilir. NodeSource deposunu ekleyerek güncel bir sürümü kurabilirsiniz:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

Kurulumu doğrulamak için node -v ve npm -v komutlarını çalıştırın. Ayrıca, git depo kopyalamak için git zaten kurulmuş olmalı.

Adım 3: OpenClaw Deposunu Klonlama ve Yapılandırma

OpenClaw projesini GitHub’dan klonlayın:

git clone https://github.com/openclaw/openclaw.git
cd openclaw

Proje klasöründe npm install komutu ile tüm bağımlılıkları yükleyin:

npm install

Ardından, yapılandırma dosyasını oluşturun. config.example.json dosyasını config.json olarak kopyalayın:

cp config.example.json config.json

Şimdi, config.json dosyasını bir metin editörüyle açın (örneğin nano):

nano config.json

Burada aşağıdaki alanları doldurmanız gerekecek:

• aiProvider: Kullanacağınız AI modeli sağlayıcısını belirtin (örneğin, “openai”, “ollama”, “anthropic”).
• apiKey: İlgili sağlayıcının API anahtarını girin. Ollama kullanıyorsanız bu alanı boş bırakabilirsiniz.
• platforms: Hangi mesajlaşma platformlarını kullanacağınızı ve ilgili token bilgilerini ekleyin. Örneğin, Discord için bot token, Telegram için bot token vb.

Örnek bir yapılandırma:

{
  "ai": {
    "provider": "ollama",
    "model": "llama3"
  },
  "platforms": {
    "discord": {
      "token": "YOUR_DISCORD_BOT_TOKEN"
    },
    "telegram": {
      "token": "YOUR_TELEGRAM_BOT_TOKEN"
    }
  }
}

Adım 4: Ollama ile Yerel AI Modeli Kurulumu (Opsiyonel)

Eğer harici bir API kullanmak istemiyorsanız, kendi sunucunuzda Ollama kurarak açık kaynaklı modelleri çalıştırabilirsiniz. Ollama, Llama 3, Mistral gibi popüler modelleri destekler ve OpenClaw ile entegrasyonu oldukça kolaydır.

Ollama’yı kurmak için:

curl -fsSL https://ollama.com/install.sh | sh

Kurulum tamamlandıktan sonra, bir modeli indirin:

ollama pull llama3

Ardından config.json dosyasında provider alanını ollama yapın ve model alanına llama3 yazın. Bu sayede tüm AI işlemleri sunucunuzda gerçekleşir, verileriniz dışarı çıkmaz.

Adım 5: OpenClaw’ı Başlatma ve Test Etme

Yapılandırma dosyanızı kaydedip kapattıktan sonra, OpenClaw’ı başlatmak için şu komutu çalıştırın:

npm start

Terminalde log çıktıları göreceksiniz. Mesajlaşma platformunuzda botunuzu test edin; örneğin Discord’da botunuza bir mesaj göndererek yanıt alıp almadığınızı kontrol edin.

Eğer bot yanıt vermiyorsa, config.json dosyasındaki token bilgilerinizi ve model bağlantısını gözden geçirin. Ayrıca, sunucunuzda gerekli portların açık olduğundan emin olun (genellikle 443 veya 80 gibi).

Process Manager ile Arka Planda Çalıştırma

OpenClaw’ı sürekli çalışır durumda tutmak için PM2 gibi bir process manager kullanabilirsiniz. PM2, uygulamanın çökmesi durumunda otomatik yeniden başlatır ve günlükleri yönetir.

sudo npm install -g pm2
pm2 start npm --name openclaw -- run start
pm2 save
pm2 startup

Bu komutlar, sunucu yeniden başlatıldığında OpenClaw’ın otomatik olarak başlamasını sağlar.

Güvenlik Önlemleri

OpenClaw’ı bir VPS üzerinde çalıştırırken güvenlik kritik önem taşır. İşte almanız gereken temel önlemler:

• Güçlü SSH kimlik doğrulaması: SSH için parola yerine yalnızca anahtar tabanlı kimlik doğrulama kullanın ve root girişini devre dışı bırakın.
• Firewall yapılandırması: VPS sağlayıcınızın bulut güvenlik duvarı veya UFW (Uncomplicated Firewall) ile yalnızca gerekli portlara izin verin. Örneğin, SSH (22) ve mesajlaşma platformu webhook’ları için gerekli portları açın.
• API anahtarlarını koruma: config.json dosyasının izinlerini yalnızca ilgili kullanıcıya verin (chmod 600 config.json).
• Güncellemeler: OpenClaw ve sunucu paketlerini düzenli olarak güncelleyin. Web Application Firewall konusunda bilgi almak, ek bir güvenlik katmanı eklemenize yardımcı olabilir.

Karşılaşılan Yaygın Sorunlar ve Çözümleri

1. OpenClaw Başlamıyor

Eğer npm start komutu hata veriyorsa, bağımlılıkların tam kurulduğundan emin olun. npm install komutunu tekrar çalıştırın. Ayrıca node -v ile Node sürümünüzü kontrol edin; OpenClaw 18.0.0 veya daha yüksek bir sürüm gerektirir.

2. Mesaj Platformu Bağlantı Hatası

Token bilgilerinizin doğru olduğundan ve platformun bot entegrasyonunu doğru yapılandırdığınızdan emin olun. Örneğin, Discord botu için sunucuya davet etmeniz ve gerekli izinleri vermeniz gerekir. Telegram için botunuzu özel sohbetlerde kullanmak üzere başlatmanız yeterlidir.

3. Ollama ile Yavaş Yanıt

Yerel modeller, özellikle yoğun işlemci kullanımı gerektirir. VPS’nizin CPU kaynakları yetersizse yanıtlar gecikebilir. Bu durumda daha güçlü bir VPS planına yükseltmeyi düşünün veya daha küçük bir model (örneğin tinyllama) kullanın.

VPS Seçerken Dikkat Edilmesi Gerekenler

OpenClaw için uygun bir VPS seçerken şu kriterlere dikkat edin:

• RAM: 2 GB minimum, 4 GB önerilir. Ollama ile çalışacaksanız 4 GB RAM daha güvenlidir.
• CPU: Yerel model çalıştıracaksanız, yüksek CPU frekansı olan bir plan tercih edin.
• Disk: SSD diskler daha hızlı veri okuma/yazma sağlar; en az 20 GB alan yeterlidir.
• Bant genişliği: Mesajlaşma platformlarına sürekli bağlantı olduğu için tahsisli bant genişliği önemlidir. Sınırsız hosting paketleri bu konuda size esneklik sağlayabilir.

VPS ihtiyaçlarınızı belirledikten sonra, uygun fiyatlı hosting seçeneklerini inceleyerek bütçenize uygun bir plan bulabilirsiniz. OpenClaw’ın yoğun kaynak tüketmediğini unutmayın; temel bir VPS çoğu senaryo için yeterli olacaktır.

Sonuç

OpenClaw’ı bir VPS üzerinde kurmak, yapay zeka ajanlarınızı tam kontrol altında çalıştırmanın en esnek ve güvenli yoludur. Bu rehberdeki adımları izleyerek, kendi sunucunuzda OpenClaw’ı çalıştırabilir, mesajlaşma platformlarına entegre edebilir ve iş süreçlerinizi otomatikleştirebilirsiniz. Kurulum sonrasında, sunucunuzun güvenliğini ve güncelliğini korumayı unutmayın. Eğer daha fazla iş otomasyonu fikri için Yapay Zeka Ajanlarıyla Pazarlama İş Akışı rehberimize göz atabilirsiniz.

SSS (Sık Sorulan Sorular)

OpenClaw için hangi VPS özellikleri yeterli?

Temel bir kurulum için 2 GB RAM, 2 vCPU ve 20 GB SSD disk yeterlidir. Ollama gibi yerel modelleri çalıştıracaksanız 4 GB RAM ve 4 vCPU önerilir.

OpenClaw’ı ücretsiz olarak kullanabilir miyim?

Evet, OpenClaw açık kaynaklı bir yazılımdır ve ücretsiz olarak kullanabilirsiniz. Ancak VPS maliyeti ve kullandığınız AI API hizmetinin ücreti sizden sorumludur.

OpenClaw ile hangi mesajlaşma platformları çalışır?

OpenClaw; Discord, Telegram, Slack, WhatsApp Business API gibi popüler platformları destekler. Yapılandırma dosyasında ilgili token bilgilerini eklemeniz yeterlidir.

OpenClaw’ı bir süre sonra durdurmak istersem ne yapmalıyım?

PM2 kullandıysanız pm2 stop openclaw komutu ile durdurabilirsiniz. Manuel çalıştırıyorsanız Ctrl+C kombinasyonu ile durdurabilirsiniz.

Bu rehberin, OpenClaw’ı VPS üzerinde kurmanız ve etkin bir şekilde kullanmanız için size yol gösterdiğini umuyoruz. Başka sorularınız için yorum bölümüne yazabilirsiniz.