English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Platforms overview

Aplikasi Linux

Gateway didukung sepenuhnya di Linux. Node adalah runtime yang direkomendasikan. Bun tidak direkomendasikan untuk Gateway (bug WhatsApp/Telegram).

Aplikasi pendamping Linux native direncanakan. Kontribusi dipersilakan jika Anda ingin membantu membuatnya.

Jalur cepat pemula (VPS)

  1. Instal Node 24 (direkomendasikan; Node 22 LTS, saat ini 22.16+, masih berfungsi untuk kompatibilitas)
  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 autentikasi dengan rahasia bersama yang dikonfigurasi (token secara default; kata sandi jika Anda menetapkan gateway.auth.mode: "password")

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

Instalasi

Gateway

Instalasi layanan Gateway (CLI)

Gunakan salah satu dari ini:

openclaw onboard --install-daemon

Atau:

openclaw gateway install

Atau:

openclaw configure

Pilih Layanan Gateway saat diminta.

Perbaiki/migrasikan:

openclaw doctor

Kontrol sistem (unit pengguna systemd)

OpenClaw menginstal layanan pengguna systemd secara default. Gunakan layanan sistem untuk server bersama atau yang selalu aktif. openclaw gateway install dan openclaw onboard --install-daemon sudah merender unit kanonis saat ini untuk Anda; tulis secara manual hanya saat Anda membutuhkan pengaturan sistem/manajer-layanan khusus. Panduan layanan lengkap tersedia di runbook Gateway.

Pengaturan minimal:

Buat ~/.config/systemd/user/openclaw-gateway[-<profile>].service:

[Unit]
Description=OpenClaw Gateway (profile: <profile>, v<version>)
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/usr/local/bin/openclaw gateway --port 18789
Restart=always
RestartSec=5
TimeoutStopSec=30
TimeoutStartSec=30
SuccessExitStatus=0 143
KillMode=control-group

[Install]
WantedBy=default.target

Aktifkan:

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

Tekanan memori dan penghentian OOM

Di Linux, kernel memilih korban OOM saat cgroup host, VM, atau kontainer kehabisan memori. Gateway bisa menjadi korban yang buruk karena memiliki sesi berumur panjang dan koneksi kanal. Karena itu OpenClaw mengarahkan proses anak sementara agar dihentikan sebelum Gateway jika memungkinkan.

Untuk spawn proses anak Linux yang memenuhi syarat, OpenClaw memulai anak melalui wrapper /bin/sh singkat yang menaikkan oom_score_adj milik anak menjadi 1000, lalu menjalankan perintah sebenarnya dengan exec. Ini adalah operasi tanpa hak istimewa karena anak hanya meningkatkan kemungkinan penghentian OOM untuk dirinya sendiri.

Permukaan proses anak yang tercakup meliputi:

  • proses anak perintah yang dikelola supervisor,
  • proses anak shell PTY,
  • proses anak server stdio MCP,
  • proses browser/Chrome yang diluncurkan OpenClaw.

Wrapper hanya untuk Linux dan dilewati saat /bin/sh tidak tersedia. Ini juga dilewati jika env anak menetapkan OPENCLAW_CHILD_OOM_SCORE_ADJ=0, false, no, atau off.

Untuk memverifikasi proses anak:

cat /proc/<child-pid>/oom_score_adj

Nilai yang diharapkan untuk anak yang tercakup adalah 1000. Proses Gateway harus mempertahankan skor normalnya, biasanya 0.

Ini tidak menggantikan penyesuaian memori normal. Jika VPS atau kontainer berulang kali menghentikan anak, tingkatkan batas memori, kurangi konkurensi, atau tambahkan kontrol sumber daya yang lebih kuat seperti MemoryMax= systemd atau batas memori tingkat kontainer.

Terkait