docs/docs/id/vps.md
2026-04-23 09:31:08 +00:00

5.3 KiB

read_when sidebarTitle summary title x-i18n
Anda ingin menjalankan Gateway di server Linux atau cloud VPS
Anda memerlukan peta cepat panduan hosting
Anda ingin penyesuaian server Linux generik untuk OpenClaw
Linux Server Jalankan OpenClaw di server Linux atau cloud VPS — pemilih provider, arsitektur, dan penyesuaian performa Server Linux
generated_at model provider source_hash source_path workflow
2026-04-23T09:30:10Z gpt-5.4 openai 759428cf20204207a5505a73c880aa776ddd0eabf969fc0dcf444fc8ce6991b2 vps.md 15

Server Linux

Jalankan Gateway OpenClaw di server Linux atau cloud VPS mana pun. Halaman ini membantu Anda memilih provider, menjelaskan cara kerja deployment cloud, dan membahas penyesuaian Linux generik yang berlaku di mana saja.

Pilih provider

Penyiapan sekali klik, di browser Penyiapan sekali klik, di browser VPS berbayar yang sederhana Tier ARM Always Free Fly Machines Docker di VPS Hetzner VPS dengan penyiapan sekali klik Compute Engine Linux VM VM dengan proxy HTTPS ARM self-hosted

AWS (EC2 / Lightsail / free tier) juga bekerja dengan baik. Panduan video komunitas tersedia di x.com/techfrenAJ/status/2014934471095812547 (sumber komunitas -- mungkin menjadi tidak tersedia).

Cara kerja penyiapan cloud

  • Gateway berjalan di VPS dan memiliki status + workspace.
  • Anda terhubung dari laptop atau ponsel melalui Control UI atau Tailscale/SSH.
  • Perlakukan VPS sebagai sumber kebenaran dan cadangkan status + workspace secara teratur.
  • Default aman: pertahankan Gateway di loopback dan akses melalui tunnel SSH atau Tailscale Serve. Jika Anda melakukan bind ke lan atau tailnet, wajibkan gateway.auth.token atau gateway.auth.password.

Halaman terkait: Akses remote Gateway, hub Platform.

Agen perusahaan bersama di VPS

Menjalankan satu agen untuk tim adalah penyiapan yang valid ketika setiap pengguna berada dalam batas kepercayaan yang sama dan agen hanya untuk bisnis.

  • Simpan di runtime khusus (VPS/VM/container + pengguna/akun OS khusus).
  • Jangan masuk ke runtime tersebut dengan akun Apple/Google pribadi atau profil browser/password-manager pribadi.
  • Jika pengguna bersifat adversarial satu sama lain, pisahkan berdasarkan gateway/host/pengguna OS.

Detail model keamanan: Keamanan.

Menggunakan node dengan VPS

Anda dapat menyimpan Gateway di cloud dan memasangkan node di perangkat lokal Anda (Mac/iOS/Android/headless). Node menyediakan layar/kamera/canvas lokal dan kapabilitas system.run sementara Gateway tetap berada di cloud.

Dokumentasi: Nodes, CLI Nodes.

Penyesuaian startup untuk VM kecil dan host ARM

Jika perintah CLI terasa lambat pada VM berdaya rendah (atau host ARM), aktifkan module compile cache milik Node:

grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF'
export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
mkdir -p /var/tmp/openclaw-compile-cache
export OPENCLAW_NO_RESPAWN=1
EOF
source ~/.bashrc
  • NODE_COMPILE_CACHE meningkatkan waktu startup perintah berulang.
  • OPENCLAW_NO_RESPAWN=1 menghindari overhead startup tambahan dari jalur self-respawn.
  • Eksekusi perintah pertama memanaskan cache; eksekusi berikutnya lebih cepat.
  • Untuk detail khusus Raspberry Pi, lihat Raspberry Pi.

Daftar periksa penyesuaian systemd (opsional)

Untuk host VM yang menggunakan systemd, pertimbangkan:

  • Tambahkan env layanan untuk jalur startup yang stabil:
    • OPENCLAW_NO_RESPAWN=1
    • NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
  • Pertahankan perilaku restart secara eksplisit:
    • Restart=always
    • RestartSec=2
    • TimeoutStartSec=90
  • Gunakan disk berbasis SSD untuk path status/cache guna mengurangi penalti cold-start random-I/O.

Untuk jalur standar openclaw onboard --install-daemon, edit unit pengguna:

systemctl --user edit openclaw-gateway.service
[Service]
Environment=OPENCLAW_NO_RESPAWN=1
Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
Restart=always
RestartSec=2
TimeoutStartSec=90

Jika Anda sengaja memasang unit sistem, edit openclaw-gateway.service melalui sudo systemctl edit openclaw-gateway.service.

Cara kebijakan Restart= membantu pemulihan otomatis: systemd can automate service recovery.

Untuk perilaku OOM Linux, pemilihan korban proses anak, dan diagnostik exit 137, lihat Tekanan memori Linux dan OOM kill.