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

Platforms overview

Aplikasi Linux

Gateway didukung sepenuhnya di Linux. Node adalah runtime yang direkomendasikan; Bun tidak direkomendasikan (terdapat masalah WhatsApp/Telegram yang diketahui).

Belum ada aplikasi pendamping Linux native. Kontribusi dipersilakan.

Jalur cepat (VPS)

  1. Instal Node 24 (direkomendasikan) atau Node 22.19+ (LTS, masih didukung).
  2. npm i -g openclaw@latest
  3. openclaw onboard --install-daemon
  4. Dari laptop Anda: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
  5. Buka http://127.0.0.1:18789/ dan lakukan autentikasi dengan rahasia bersama yang telah dikonfigurasi (secara default berupa token; kata sandi jika gateway.auth.mode adalah "password").

Panduan server lengkap: Server Linux. Contoh VPS langkah demi langkah: exe.dev.

Instalasi

Layanan Gateway (systemd)

Instal dengan salah satu perintah berikut:

bash
openclaw onboard --install-daemonopenclaw gateway installopenclaw configure   # pilih "Layanan Gateway" saat diminta

Perbaiki atau migrasikan instalasi yang sudah ada:

bash
openclaw doctor

openclaw gateway install secara default menghasilkan unit pengguna systemd. Panduan layanan lengkap, termasuk varian unit tingkat sistem untuk host bersama atau yang selalu aktif, tersedia di panduan operasional Gateway.

Tulis unit secara manual hanya untuk penyiapan khusus. Contoh unit pengguna minimal (~/.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

Aktifkan unit tersebut:

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

Tekanan memori dan penghentian OOM

Di Linux, kernel memilih proses korban OOM ketika cgroup host, VM, atau kontainer kehabisan memori. Gateway bukan korban yang tepat karena mengelola sesi berumur panjang dan koneksi saluran, sehingga OpenClaw mengupayakan agar proses anak sementara dihentikan terlebih dahulu jika memungkinkan.

Untuk proses anak Linux yang memenuhi syarat, OpenClaw membungkus perintah dengan shim /bin/sh singkat yang menaikkan oom_score_adj milik proses anak tersebut menjadi 1000, lalu menjalankan perintah sebenarnya dengan exec. Tindakan ini tidak memerlukan hak istimewa: sebuah proses selalu dapat menaikkan skor OOM miliknya sendiri.

Cakupan proses anak:

  • Proses anak perintah yang dikelola supervisor
  • Proses anak shell PTY
  • Proses anak server stdio MCP
  • Proses peramban/Chrome yang diluncurkan OpenClaw (melalui runtime proses SDK plugin)

Pembungkus ini hanya digunakan di Linux dan dilewati ketika /bin/sh tidak tersedia, atau ketika lingkungan proses anak menetapkan OPENCLAW_CHILD_OOM_SCORE_ADJ ke 0, false, no, atau off.

Verifikasi proses anak:

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

Nilai yang diharapkan untuk proses anak yang tercakup adalah 1000; proses Gateway itu sendiri mempertahankan skor normalnya (biasanya 0).

OOMPolicy=continue pada unit systemd menjaga layanan Gateway tetap berjalan ketika proses anak sementara dipilih oleh penghenti OOM, alih-alih menandai seluruh unit sebagai gagal dan memulai ulang semua saluran; proses anak/sesi yang gagal melaporkan kesalahannya sendiri.

Hal ini tidak menggantikan penyesuaian memori yang semestinya. Jika VPS atau kontainer berulang kali menghentikan proses anak, naikkan batas memori, kurangi konkurensi, atau tambahkan kontrol sumber daya yang lebih ketat (MemoryMax= systemd, batas memori kontainer).

Terkait

Was this useful?
On this page

On this page