OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Platforms overview

Linux uygulaması

Gateway, Linux'ta tam olarak desteklenir. Önerilen çalışma zamanı Node'dur; Bun önerilmez (bilinen WhatsApp/Telegram sorunları nedeniyle).

Henüz yerel bir Linux yardımcı uygulaması yoktur. Katkılar memnuniyetle karşılanır.

Hızlı yol (VPS)

  1. Node 24'ü (önerilen) veya Node 22.19+ sürümünü (LTS, hâlâ destekleniyor) yükleyin.
  2. npm i -g openclaw@latest
  3. openclaw onboard --install-daemon
  4. Dizüstü bilgisayarınızdan: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
  5. http://127.0.0.1:18789/ adresini açın ve yapılandırılmış paylaşılan gizli bilgiyle kimlik doğrulayın (varsayılan olarak token; gateway.auth.mode değeri "password" ise parola).

Tam sunucu kılavuzu: Linux Sunucusu. Adım adım VPS örneği: exe.dev.

Kurulum

Gateway hizmeti (systemd)

Aşağıdakilerden biriyle yükleyin:

bash
openclaw onboard --install-daemonopenclaw gateway installopenclaw configure   # istendiğinde "Gateway service" seçeneğini belirleyin

Mevcut bir kurulumu onarın veya taşıyın:

bash
openclaw doctor

openclaw gateway install, varsayılan olarak bir systemd kullanıcı birimi oluşturur. Paylaşılan veya sürekli açık ana makineler için sistem düzeyindeki birim çeşidi dâhil olmak üzere tüm hizmet yönergeleri Gateway işletim kılavuzunda bulunur.

Yalnızca özel bir kurulum için birimi elle yazın. Asgari kullanıcı birimi örneği (~/.config/systemd/user/openclaw-gateway[-<profile>].service):

ini
[Unit]Description=OpenClaw Gateway (profile: <profile>, v<version>)After=network-online.targetWants=network-online.targetStartLimitBurst=5StartLimitIntervalSec=60 [Service]ExecStart=/usr/local/bin/openclaw gateway --port 18789Restart=alwaysRestartSec=5RestartPreventExitStatus=78TimeoutStopSec=30TimeoutStartSec=30SuccessExitStatus=0 143OOMPolicy=continueKillMode=control-group [Install]WantedBy=default.target

Etkinleştirin:

bash
systemctl --user enable --now openclaw-gateway[-<profile>].service

Bellek baskısı ve OOM sonlandırmaları

Linux'ta bir ana makinenin, sanal makinenin veya kapsayıcı cgroup'unun belleği tükendiğinde çekirdek bir OOM kurbanı seçer. Gateway, uzun ömürlü oturumları ve kanal bağlantılarını yönettiği için uygun bir kurban değildir; bu nedenle OpenClaw, mümkün olduğunda geçici alt süreçlerin önce sonlandırılmasını sağlayacak şekilde önceliklendirme yapar.

Uygun Linux alt süreçleri başlatılırken OpenClaw, komutu alt sürecin kendi oom_score_adj değerini 1000 olarak yükselten ve ardından gerçek komutu exec ile çalıştıran kısa bir /bin/sh sarmalayıcısına alır. Bu işlem ayrıcalık gerektirmez: bir süreç kendi OOM puanını her zaman yükseltebilir.

Kapsanan alt süreç yüzeyleri:

  • Gözetmen tarafından yönetilen komut alt süreçleri
  • PTY kabuk alt süreçleri
  • MCP stdio sunucusu alt süreçleri
  • OpenClaw tarafından başlatılan tarayıcı/Chrome süreçleri (Plugin SDK süreç çalışma zamanı aracılığıyla)

Sarmalayıcı yalnızca Linux içindir ve /bin/sh kullanılamadığında ya da alt süreç ortamı OPENCLAW_CHILD_OOM_SCORE_ADJ değerini 0, false, no veya off olarak ayarladığında atlanır.

Bir alt süreci doğrulayın:

bash
cat /proc/<child-pid>/oom_score_adj

Kapsanan alt süreçler için beklenen değer 1000'dir; Gateway sürecinin kendisi normal puanını (genellikle 0) korur.

systemd birimindeki OOMPolicy=continue, geçici bir alt süreç OOM sonlandırıcısı tarafından seçildiğinde tüm birimi başarısız olarak işaretleyip bütün kanalları yeniden başlatmak yerine Gateway hizmetini çalışır durumda tutar; başarısız olan alt süreç/oturum kendi hatasını bildirir.

Bu, normal bellek ayarlarının yerini tutmaz. Bir VPS veya kapsayıcı alt süreçleri tekrar tekrar sonlandırıyorsa bellek sınırını yükseltin, eşzamanlılığı azaltın veya daha güçlü kaynak denetimleri ekleyin (systemd MemoryMax=, kapsayıcı bellek sınırları).

İlgili

Was this useful?
On this page

On this page