Blog

OpenClaw Hataları Nasıl Düzeltilir: 15 Yaygın Sorun ve Çözümü

Ashley Innocent

Ashley Innocent

5 March 2026

OpenClaw Hataları Nasıl Düzeltilir: 15 Yaygın Sorun ve Çözümü

Kurumsal Apidog

Şirket İçi Dağıtım

SSO & RBAC

SOC 2 Uyumlu

Apidog Enterprise'ı Keşfet

Kısaca

OpenClaw sorun giderme, bağlantı kopmalarını, kimlik doğrulama hatalarını, yönlendirme hatalarını ve performans sorunlarını kapsar. Çoğu sorun ağ istikrarsızlığından, yanlış API anahtarlarından veya yanlış yapılandırılmış kanallardan kaynaklanır. Bu kılavuz, en yaygın 15 OpenClaw hatası için adım adım düzeltmeler sunar.

Kurulum ve Kurulum Sorunları

Node.js sürüm uyumsuzluğu

Sorun: openclaw komutu bulunamadı veya "desteklenmeyen Node sürümü" hatası veriyor.

Neden: OpenClaw, Node.js 22 veya sonraki bir sürümünü gerektirir. Eski sürümler gerekli özelliklerden yoksundur.

Çözüm:

Node sürümünüzü kontrol edin:

node --version

Eğer 22'nin altındaysa, Node'u güncelleyin:

# nvm kullanarak (önerilen)
nvm install 22
nvm use 22

# Veya nodejs.org adresinden indirin

OpenClaw'ı yeniden yükleyin:

npm install -g openclaw@latest

Kurulumu doğrulayın:

openclaw --version

Kurulum sırasında izin reddedildi

Sorun: npm install -g openclaw EACCES veya izin hatalarıyla başarısız oluyor.

Neden: npm, uygun izinler olmadan sistem dizinlerine yazmaya çalışıyor.

Çözüm:

sudo kullanmayın. Bunun yerine, npm'i bir kullanıcı dizini kullanacak şekilde yapılandırın:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'

Kabuk profilinize ekleyin (~/.zshrc veya ~/.bashrc):

export PATH=~/.npm-global/bin:$PATH

Kabuğunuzu yeniden yükleyin:

source ~/.zshrc

OpenClaw'ı yükleyin:

npm install -g openclaw@latest

Yapılandırma dosyası bulunamadı

Sorun: OpenClaw kurulumdan sonra ~/.openclaw/config.json dosyasını bulamıyor.

Neden: İlk kurulum sihirbazı çalışmadı veya sessizce başarısız oldu.

Çözüm:

İlk kurulumu manuel olarak çalıştırın:

openclaw onboard

Eğer bu başarısız olursa, yapılandırma dizinini oluşturun:

mkdir -p ~/.openclaw

Minimal bir yapılandırma dosyası oluşturun:

cat > ~/.openclaw/config.json << 'EOF'
{
  "version": "1.0.0",
  "providers": {},
  "agents": {},
  "channels": {},
  "routing": []
}
EOF

İlk kurulumu tekrar çalıştırın:

openclaw onboard

Kanal Bağlantı Sorunları

WhatsApp QR kodu taranmıyor

Sorun: QR kodu görünüyor ancak WhatsApp uygulaması "Geçersiz QR kodu" diyor veya yanıt vermiyor.

Neden: QR kodunun süresi dolmuş veya telefonunuz ile OpenClaw arasında ağ sorunları var.

Çözüm:

  1. Telefonunuzun ve bilgisayarınızın aynı ağda olduğundan emin olun
  2. QR kodunu yeniden oluşturun:
openclaw channels logout whatsapp
openclaw channels login whatsapp
  1. 30 saniye içinde tarayın (QR kodlarının süresi hızlı dolar)
  2. Eğer hala başarısız olursa, güvenlik duvarı ayarlarını kontrol edin:
# macOS
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --add /usr/local/bin/node

# Linux (ufw)
sudo ufw allow 18789/tcp

WhatsApp birkaç saat sonra bağlantıyı kesiyor

Sorun: WhatsApp başlangıçta çalışıyor ancak 2-4 saat sonra bağlantıyı kesiyor.

Neden: WhatsApp'ın protokolü periyodik "kalp atışları" gerektirir. Ağ değişiklikleri veya uyku modu bağlantıyı keser.

Çözüm:

Otomatik yeniden bağlanmayı etkinleştirin:

openclaw channels config whatsapp --auto-reconnect true --reconnect-interval 300

Bu, bağlantıyı her 5 dakikada bir kontrol eder ve gerekirse yeniden bağlanır.

Eğer bir dizüstü bilgisayardaysanız, OpenClaw çalışırken uyku moduna geçmesini engelleyin:

# macOS
caffeinate -i openclaw gateway

# Linux
systemd-inhibit --what=sleep openclaw gateway

Üretim ortamı için, OpenClaw'ı bir dizüstü bilgisayar yerine bir sunucuda çalıştırın.

Telegram botu mesaj almıyor

Sorun: Bot çevrimiçi ancak mesajlara yanıt vermiyor.

Neden: Bot gerekli izinlere sahip değil veya token geçersiz.

Çözüm:

Bot tokenını test edin:

curl https://api.telegram.org/bot<YOUR_TOKEN>/getMe

Eğer bu bir hata döndürürse, tokenı yeniden oluşturun:

  1. Telegram'ı açın ve @BotFather'a mesaj gönderin
  2. /mybots gönderin
  3. Botunuzu seçin
  4. "API Token" → "Tokenı Yeniden Oluştur" seçeneğini seçin
  5. OpenClaw'ı güncelleyin:
openclaw channels update telegram --token NEW_TOKEN

Grup sohbetleri için, botu "Mesajları Oku" izniyle yönetici olarak ekleyin.

Discord botu çevrimdışı görünüyor

Sorun: Bot Discord sunucu listesinde çevrimdışı görünüyor.

Neden: "Mesaj İçeriği Amacı (Message Content Intent)" eksik veya token geçersiz.

Çözüm:

  1. Discord Geliştirici Portalı'na gidin
  2. Uygulamanızı seçin
  3. "Bot" sekmesine gidin
  4. Ayrıcalıklı Ağ Geçidi Amaçları (Privileged Gateway Intents) altında "Mesaj İçeriği Amacı (Message Content Intent)" seçeneğini etkinleştirin
  5. Değişiklikleri kaydedin
  6. OpenClaw'ı yeniden başlatın:
openclaw gateway restart

Eğer bot hala çevrimdışıysa, tokenı kontrol edin:

openclaw channels test discord

Eğer başarısız olursa, Geliştirici Portalı'nda tokenı yeniden oluşturun ve OpenClaw'ı güncelleyin.

iMessage köprüsü çalışmıyor (macOS)

Sorun: iMessage kanalı "bağlantı kesildi" gösteriyor veya mesaj almıyor.

Neden: Erişilebilirlik izinleri eksik veya Mesajlar uygulaması çalışmıyor.

Çözüm:

  1. Sistem Ayarları → Gizlilik ve Güvenlik → Erişilebilirlik'i açın
  2. Terminal'i (veya terminal uygulamanızı) izin verilenler listesine ekleyin
  3. OpenClaw'ı yeniden başlatın:
openclaw gateway restart
  1. Mesajlar uygulamasının çalıştığından ve oturum açtığından emin olun
  2. Kendinize bir mesaj göndererek test edin

Eğer hala çalışmıyorsa, köprü sürecini kontrol edin:

ps aux | grep openclaw-imessage-bridge

Eğer çalışmıyorsa, manuel olarak başlatın:

openclaw channels restart imessage

Kimlik Doğrulama ve API Hataları

Geçersiz API anahtarı

Sorun: Günlüklerde "Kimlik doğrulama başarısız" veya "Geçersiz API anahtarı" hataları.

Neden: Yanlış API anahtarı, süresi dolmuş anahtar veya uygun izinlere sahip olmayan anahtar.

Çözüm:

API anahtarınızı doğrulayın:

# Anthropic için
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-6","max_tokens":10,"messages":[{"role":"user","content":"Hi"}]}'

# OpenAI için
curl https://api.openai.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4","messages":[{"role":"user","content":"Hi"}],"max_tokens":10}'

Eğer curl komutu başarısız olursa, anahtarınız geçersizdir. Sağlayıcınızın kontrol panelinden yeni bir anahtar alın.

OpenClaw'ı güncelleyin:

openclaw config set --provider anthropic --api-key NEW_KEY

Ağ Geçidi'ni yeniden başlatın:

openclaw gateway restart

Hız sınırı aşıldı

Sorun: "Hız sınırı aşıldı" veya "Çok fazla istek" hataları.

Neden: AI sağlayıcınıza çok fazla istek gönderiyorsunuz.

Çözüm:

Kullanımınızı kontrol edin:

openclaw stats --period 1h

Hız sınırlamayı etkinleştirin:

openclaw limits set --max-requests 50 --window 3600

Bu sizi saatte 50 istekle sınırlar. Sağlayıcınızın sınırlarına göre ayarlayın.

Yoğun trafik için, kuyruğa almayı etkinleştirin:

openclaw config set --enable-queue true --queue-max-size 100

Hız sınırına ulaştığınızda mesajlar kuyruğa alınır ve kapasite mevcut olduğunda işlenir.

Model bulunamadı

Sorun: "Model bulunamadı" veya "Geçersiz model" hataları.

Neden: Mevcut olmayan veya hesabınız için kullanılamayan bir model belirttiniz.

Çözüm:

Mevcut modelleri listeleyin:

# Anthropic
curl https://api.anthropic.com/v1/models \
  -H "x-api-key: YOUR_KEY"

# OpenAI
curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

Aracı yapılandırmanızı güncelleyin:

openclaw agents update default --model claude-sonnet-4-6

Ağ Geçidi'ni yeniden başlatın:

openclaw gateway restart

Yetersiz kredi

Sorun: "Yetersiz kredi" veya "Ödeme gerekli" hataları.

Neden: AI sağlayıcı hesabınızda kredi bitti veya faturalandırma limitlerine ulaşıldı.

Çözüm:

Sağlayıcınızın kontrol panelinden hesap bakiyenizi kontrol edin:

Kredi ekleyin veya ödeme yönteminizi güncelleyin.

Beklerken, ücretsiz veya yerel bir modele yönlendirin:

openclaw agents add fallback --provider ollama --model llama2
openclaw routing add --fallback fallback

Mesaj Yönlendirme Hataları

Mesajlar yanlış aracıya gidiyor

Sorun: Mesajlar, yönlendirme kurallarına rağmen yanlış AI aracısına yönlendiriliyor.

Neden: Yönlendirme kuralları çakışıyor veya yanlış önceliklere sahip.

Çözüm:

Tüm yönlendirme kurallarını listeleyin:

openclaw routing list

Çakışmaları kontrol edin. Daha yüksek önceliğe sahip kurallar önce eşleşir. Eğer şunlar varsa:

Öncelik 5: kanal=whatsapp → aracı=varsayılan
Öncelik 10: gönderen=+1234567890 → aracı=vip

WhatsApp'taki +1234567890 adresinden gelen mesajlar vip'e gider (öncelik 10 kazanır).

Çakışan kuralları kaldırın:

openclaw routing remove <rule-id>

Doğru önceliklere sahip kurallar ekleyin:

openclaw routing add --channel whatsapp --agent default --priority 1
openclaw routing add --sender +1234567890 --agent vip --priority 10

Yönlendirmeyi test edin:

openclaw routing test --channel whatsapp --sender +1234567890 --message "test"

Bu, mesajı göndermeden hangi aracının işleyeceğini gösterir.

Anahtar kelime yönlendirme çalışmıyor

Sorun: Belirli anahtar kelimeleri içeren mesajlar yapılandırılan aracıya yönlendirilmiyor.

Neden: Anahtar kelimeler büyük/küçük harfe duyarlıdır veya mesaj tam anahtar kelimeyi içermiyor.

Çözüm:

Anahtar kelimeleri büyük/küçük harf duyarsız yapın:

openclaw routing add --keyword "debug" --agent debugging --case-insensitive

Esnek eşleştirme için regex kullanın:

openclaw routing add --pattern "debug|error|bug" --agent debugging

Bu, mesajın herhangi bir yerinde "debug", "error" veya "bug" kelimelerini eşleştirir.

Anahtar kelime eşleştirmeyi test edin:

openclaw routing test --message "I found a debug issue"

Özel yönlendirme fonksiyonu hataları

Sorun: Özel yönlendirme fonksiyonu hata veriyor veya yürütülmüyor.

Neden: Sözdizimi hataları, eksik bağımlılıklar veya yanlış dönüş değerleri.

Çözüm:

Yönlendirme fonksiyonunuzu test edin:

openclaw routing test-custom ~/.openclaw/routing.js --message "test"

Bu, fonksiyonunuzu çalıştırır ve sonucu veya hatayı gösterir.

Yaygın sorunlar:

  1. Sözdizimi hataları: JavaScript sözdiziminizi kontrol edin
  2. Dönüş eksikliği: Her zaman bir aracı adı döndürün
  3. Asenkron fonksiyonlar: Yönlendirme fonksiyonlarında async/await kullanmayın (senkron olmaları gerekir)

Doğru fonksiyon örneği:

module.exports = function route(message) {
  // Her zaman bir string (aracı adı) döndürün
  if (message.channel === 'whatsapp') {
    return 'whatsapp-agent';
  }
  return 'default';
};

Yanlış fonksiyon örneği:

// BUNU YAPMAYIN
module.exports = async function route(message) {
  const result = await someAsyncOperation();
  return result; // Asenkron fonksiyonlar desteklenmez
};

Yedek aracı tetiklenmiyor

Sorun: Birincil aracı başarısız olduğunda, mesajlar yedek aracıya yönlendirilmiyor.

Neden: Yedek yapılandırılmamış veya birincil aracı hataları doğru bildirmiyor.

Çözüm:

Yedek yapılandırın:

openclaw routing set-fallback backup-agent

Yedeği test edin:

# Birincil aracıyı geçici olarak devre dışı bırakın
openclaw agents disable default

# Bir test mesajı gönderin
openclaw routing test --message "test"

# Yedek aracıyı göstermeli

Birincil aracıyı yeniden etkinleştirin:

openclaw agents enable default

Performans ve Bellek Sorunları

Yüksek bellek kullanımı

Sorun: OpenClaw 2GB+ RAM kullanıyor ve artmaya devam ediyor.

Neden: Oturum verileri zamanla temizlenmeden birikir.

Çözüm:

Bellek kullanımını kontrol edin:

openclaw stats --memory

Eski oturumları temizleyin:

openclaw sessions clear --older-than 7d

Oturum zaman aşımını azaltın:

openclaw config set --session-timeout 1800

Oturumlar artık varsayılan 1 saat yerine 30 dakika hareketsizlikten sonra sona erer.

Otomatik temizlemeyi etkinleştirin:

openclaw config set --auto-cleanup true --cleanup-interval 3600

Bu, her saat başı temizlik yapar.

Yavaş yanıt süreleri

Sorun: AI yanıtları 30 saniyeden fazla sürüyor veya zaman aşımına uğruyor.

Neden: Ağ gecikmesi, yavaş AI sağlayıcısı veya kuyruk birikimi.

Çözüm:

Kuyruk durumunu kontrol edin:

openclaw queue status

Eğer kuyrukta 50'den fazla mesaj varsa, eşzamanlılığı artırın:

openclaw config set --max-concurrent-requests 10

Bu, varsayılan 3 mesaj yerine 10 mesajı aynı anda işler.

AI sağlayıcınızla ağ gecikmesini kontrol edin:

# Anthropic
ping api.anthropic.com

# OpenAI
ping api.openai.com

Eğer gecikme yüksekse (>200ms), farklı bir sağlayıcı veya yerel bir model kullanmayı düşünün.

İstek zaman aşımını etkinleştirin:

openclaw config set --request-timeout 30000

30 saniyeden uzun süren istekler başarısız olur ve yeniden denenir.

Ağ Geçidi yanıt vermiyor

Sorun: Ağ Geçidi mesajlara veya API çağrılarına yanıt vermeyi durduruyor.

Neden: Kilitlenme, sonsuz döngü veya kaynak tükenmesi.

Çözüm:

Ağ Geçidi durumunu kontrol edin:

openclaw gateway status

Eğer donmuşsa, bir iş parçacığı dökümü alın:

kill -SIGUSR1 $(pgrep -f "openclaw gateway")

Bu, ~/.openclaw/gateway.log dosyasına bir iş parçacığı dökümü yazar. Takılı kalan işlemleri arayın.

Ağ Geçidi'ni yeniden başlatın:

openclaw gateway restart

Sağlık kontrollerini etkinleştirin:

openclaw config set --health-check-interval 60

Ağ Geçidi artık kendi sağlığını her 60 saniyede bir kontrol eder ve yanıt vermezse yeniden başlar.

CPU kullanımı yükseliyor

Sorun: OpenClaw sürekli %100 CPU kullanıyor.

Neden: Sonsuz döngü, aşırı günlükleme veya mesaj seli.

Çözüm:

CPU'yu neyin tükettiğini kontrol edin:

top -p $(pgrep -f "openclaw gateway")

Günlük seviyesini azaltın:

openclaw config set --log-level warn

Bu, hata ayıklama ve bilgi günlüklerini devre dışı bırakarak G/Ç'yi azaltır.

Mesaj sellerini kontrol edin:

openclaw stats --messages --period 1h

Eğer saatte 1000'den fazla mesaj alıyorsanız, kanal başına hız sınırlamasını etkinleştirin:

openclaw channels config whatsapp --rate-limit 100 --rate-window 3600

Ağ Geçidi Çökmeleri ve Yeniden Başlatmaları

Ağ Geçidi başlangıçta çöküyor

Sorun: openclaw gateway hemen, hata mesajı vermeden çöküyor.

Neden: Bozuk yapılandırma dosyası veya eksik bağımlılıklar.

Çözüm:

Hata ayıklama modunda çalıştırın:

openclaw gateway --debug

Bu, ayrıntılı hata mesajlarını gösterir.

Yaygın nedenler:

  1. Bozuk yapılandırma: Yapılandırmayı yedekleyin ve sıfırlayın
cp ~/.openclaw/config.json ~/.openclaw/config.json.backup
openclaw config reset
openclaw onboard
  1. Eksik bağımlılıklar: OpenClaw'ı yeniden yükleyin
npm uninstall -g openclaw
npm install -g openclaw@latest
  1. Bağlantı noktası zaten kullanımda: Bağlantı noktasını değiştirin
openclaw gateway --port 18790

Ağ Geçidi çalışma sırasında çöküyor

Sorun: Ağ Geçidi bir süre çalışıyor, sonra beklenmedik bir şekilde çöküyor.

Neden: İşlenmemiş bir istisna, bellek sızıntısı veya harici bir sürecin onu sonlandırması.

Çözüm:

Çökme günlüklerini kontrol edin:

tail -100 ~/.openclaw/gateway.log

Çökmeden önceki yığın izlemelerini veya hata mesajlarını arayın.

Çökme dökümlerini etkinleştirin:

openclaw config set --enable-crash-dumps true

Bir sonraki çökme, ~/.openclaw/crashes/ dizinine bir döküm yazar. Hata ayıklama için bunu OpenClaw ekibiyle paylaşın.

Ağ Geçidi'ni otomatik yeniden başlatma ile çalıştırın:

openclaw gateway --auto-restart

Ağ Geçidi çökmelerden sonra otomatik olarak yeniden başlar.

Üretim ortamı için, bir süreç yöneticisi kullanın:

# pm2 kullanarak
npm install -g pm2
pm2 start openclaw -- gateway
pm2 save
pm2 startup

Yeniden başlattıktan sonra oturum verileri kayboldu

Sorun: Ağ Geçidi yeniden başlatıldıktan sonra konuşmalar sıfırlanıyor.

Neden: Oturumlar diske kaydedilmemiş veya oturum dosyası bozuk.

Çözüm:

Oturum kalıcılığını etkinleştirin:

openclaw config set --persist-sessions true --session-file ~/.openclaw/sessions.db

Oturumlar artık her 30 saniyede bir diske kaydedilir.

Oturum dosyasını kontrol edin:

ls -lh ~/.openclaw/sessions.db

Eğer 0 bayt veya eksikse, oturumlar kaydedilmiyordur. Disk alanını kontrol edin:

df -h ~

Eğer disk doluysa, yer açın ve Ağ Geçidi'ni yeniden başlatın.

Yedekten geri yükleyin:

cp ~/.openclaw/sessions.db.backup ~/.openclaw/sessions.db
openclaw gateway restart

Platforma Özgü Sorunlar

macOS: "openclaw" açılamıyor

Sorun: macOS, OpenClaw'ı "tanımlanamayan geliştirici" uyarısıyla engelliyor.

Neden: macOS Gatekeeper güvenlik özelliği.

Çözüm:

OpenClaw'a izin verin:

xattr -d com.apple.quarantine $(which openclaw)

Veya Sistem Ayarları → Gizlilik ve Güvenlik'e gidin ve OpenClaw uyarısının yanındaki "Yine de İzin Ver" seçeneğine tıklayın.

Linux: inotify için izin reddedildi

Sorun: "ENOSPC: Dosya izleyicisi sayısı için sistem limiti aşıldı."

Neden: Linux, bir sürecin izleyebileceği dosya sayısını sınırlar.

Çözüm:

Limiti artırın:

echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

OpenClaw'ı yeniden başlatın:

openclaw gateway restart

Windows: Komut bulunamadı

Sorun: openclaw komutu Windows'ta tanınmıyor.

Neden: npm global bin dizini PATH'te değil.

Çözüm:

npm global dizinini bulun:

npm config get prefix

PATH'e ekleyin:

  1. Sistem Özellikleri → Ortam Değişkenleri'ni açın
  2. Kullanıcı değişkenleri altındaki "Path"i düzenleyin
  3. C:\Users\YourName\AppData\Roaming\npm (veya yukarıdaki yolu) ekleyin
  4. Tamam'a tıklayın ve terminalinizi yeniden başlatın

Doğrulayın:

openclaw --version

Docker: Ağ sorunları

Sorun: Docker'daki OpenClaw, mesajlaşma platformlarına bağlanamıyor.

Neden: Docker ağ izolasyonu.

Çözüm:

Ana bilgisayar ağıyla çalıştırın:

docker run --network host openclaw/openclaw gateway

Veya Ağ Geçidi bağlantı noktasını dışa açın:

docker run -p 18789:18789 openclaw/openclaw gateway

WhatsApp için, QR kodu taraması için ek bağlantı noktalarını dışa açmanız gerekir:

docker run -p 18789:18789 -p 3000:3000 openclaw/openclaw gateway

Hata Ayıklama Araçları ve Günlükler

Hata ayıklama günlük kaydını etkinleştirin

Ayrıntılı günlükler alın:

openclaw config set --log-level debug
openclaw gateway restart

Günlükler varsayılan olarak ~/.openclaw/gateway.log adresine gider.

Günlükleri gerçek zamanlı izleyin:

tail -f ~/.openclaw/gateway.log

Bireysel bileşenleri test edin

Kanalları test edin:

openclaw channels test whatsapp
openclaw channels test telegram
openclaw channels test discord

Aracıları test edin:

openclaw agents test default --message "Hello"

Yönlendirmeyi test edin:

openclaw routing test --channel whatsapp --sender +1234567890 --message "debug issue"

Ağ Geçidi durumunu inceleyin

Mevcut durumu alın:

openclaw gateway inspect

Bu şunları gösterir:

Tanılamayı dışa aktar

Bir tanılama raporu oluşturun:

openclaw diagnostics export > openclaw-diagnostics.json

Bu şunları içerir:

Sorunları bildirirken bunu destek ekibiyle paylaşın.

Ağ hata ayıklaması

AI sağlayıcılarına bağlantıyı test edin:

openclaw network test anthropic
openclaw network test openai

Bu şunları kontrol eder:

Herhangi bir kontrol başarısız olursa, bir ağ sorununuz var demektir.

Sıkça Sorulan Sorular

OpenClaw neden bu kadar çok bellek kullanıyor?

OpenClaw, hızlı erişim için oturum geçmişini bellekte tutar. Her oturum, tüm konuşma bağlamını depolar. Eğer her biri 50 mesaj içeren 100 aktif oturumunuz varsa, bu bellekte 5000 mesaj demektir.

Bellek kullanımını azaltın:

  1. Oturum zaman aşımını düşürün
  2. Otomatik temizlemeyi etkinleştirin
  3. Oturum başına bağlam uzunluğunu sınırlayın
openclaw config set --session-timeout 1800 --auto-cleanup true --max-context-length 50

OpenClaw'ı internet olmadan çalıştırabilir miyim?

Evet, eğer yerel bir AI modeli kullanıyorsanız. Ollama'yı kurun ve OpenClaw'ı onu kullanacak şekilde yapılandırın:

# Ollama'yı kurun
curl https://ollama.ai/install.sh | sh

# Bir model çekin
ollama pull llama2

# OpenClaw'ı yapılandırın
openclaw agents add local --provider ollama --model llama2 --endpoint http://localhost:11434

Mesajlaşma platformları hala internete ihtiyaç duyar, ancak AI çıkarımı yerel olarak çalışır.

Yeni bir makineye nasıl geçiş yaparım?

Yapılandırmanızı dışa aktarın:

openclaw config export > openclaw-backup.json

openclaw-backup.json dosyasını yeni makineye kopyalayın.

OpenClaw'ı yükleyin:

npm install -g openclaw@latest

Yapılandırmayı içe aktarın:

openclaw config import openclaw-backup.json

Kanalları yeniden bağlayın (QR kodları ve tokenlar aktarılmaz):

openclaw channels login whatsapp
openclaw channels update telegram --token YOUR_TOKEN

Mesajlar neden sırasız geliyor?

OpenClaw mesajları eşzamanlı olarak işler. Eğer hızlıca 3 mesaj gönderirseniz, ağ zamanlamasına bağlı olarak AI sağlayıcısına farklı sıralarda ulaşabilirler.

Sıralı işlemeyi etkinleştirin:

openclaw config set --max-concurrent-requests 1

Bu, bir seferde bir mesajı işleyerek sırayı korur. Daha yavaştır ancak sırayı garanti eder.

OpenClaw'ı üretim için kullanabilir miyim?

Evet, ancak bu yönergeleri takip edin:

  1. Bir sunucuda çalıştırın, dizüstü bilgisayarda değil
  2. Bir süreç yöneticisi kullanın (pm2, systemd)
  3. Oturum kalıcılığını etkinleştirin
  4. İzleme ve uyarılar kurun
  5. Hız limitlerini yapılandırın
  6. Kontrol Kullanıcı Arayüzü için bir ters proxy (nginx) kullanın
  7. HTTPS'yi etkinleştirin
  8. Yapılandırmayı düzenli olarak yedekleyin

Örnek systemd hizmeti:

[Unit]
Description=OpenClaw Gateway
After=network.target

[Service]
Type=simple
User=openclaw
WorkingDirectory=/home/openclaw
ExecStart=/usr/bin/openclaw gateway --port 18789
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Hata nasıl bildirilir?

  1. Tanılamaları oluşturun:
openclaw diagnostics export > diagnostics.json
  1. GitHub'da bir sorun açın
  2. Şunları dahil edin:

Sonuç

Çoğu OpenClaw sorunu ağ problemlerinden, yanlış yapılandırmadan veya platforma özgü tuhaflıklardan kaynaklanır. Bu kılavuz, en yaygın 15 hatayı ve çözümlerini kapsar.

Temel sorun giderme adımları:

  1. Önce günlükleri kontrol edin (~/.openclaw/gateway.log)
  2. Bileşenleri ayrı ayrı test edin (kanallar, aracılar, yönlendirme)
  3. Ayrıntılı hatalar için hata ayıklama modunu etkinleştirin
  4. Durumu dışa aktarmak için tanılama araçlarını kullanın
  5. Yardım için topluluğa katılın

OpenClaw ile birlikte API iş akışları oluşturuyorsanız, API tasarımı, test ve dokümantasyon için Apidog'a göz atın. OpenClaw'ın sohbet arayüzünü yapılandırılmış API yönetimiyle tamamlar.

button

Sonraki adımlar:

API Tasarım-Öncelikli Yaklaşımı Apidog'da Uygulayın

API'leri oluşturmanın ve kullanmanın daha kolay yolunu keşfedin

Ücretsiz Kaydolİndir