Skip to main content
Sebagian besar penyiapan memerlukan satu Gateway - satu Gateway menangani beberapa koneksi perpesanan dan agen. Jalankan Gateway terpisah dengan profil/port terisolasi hanya jika Anda memerlukan isolasi yang lebih kuat atau redundansi (misalnya, bot penyelamat).

​
Mulai cepat bot penyelamat

Penyiapan bot penyelamat paling sederhana:
  • Pertahankan bot utama pada profil default.
  • Jalankan bot penyelamat pada --profile rescue, dengan token bot Telegram tersendiri.
  • Tempatkan bot penyelamat pada port dasar yang berbeda, misalnya 19789.
Dengan demikian, bot penyelamat tetap dapat men-debug atau menerapkan perubahan konfigurasi jika bot utama tidak aktif. Sisakan setidaknya 20 port di antara port dasar agar port browser/CDP turunan tidak pernah bertabrakan.
Jika bot utama sudah berjalan, biasanya hanya itu yang Anda perlukan. Jika orientasi awal sudah memasang layanan penyelamat, lewati gateway install terakhir. Selama openclaw --profile rescue onboard:
  • Gunakan token bot Telegram terpisah yang dikhususkan untuk akun penyelamat (mudah dibatasi hanya untuk operator, independen dari pemasangan saluran/aplikasi bot utama, dan menyediakan jalur pemulihan sederhana berbasis pesan langsung).
  • Pertahankan nama profil rescue.
  • Gunakan port dasar yang setidaknya 20 lebih tinggi daripada bot utama.
  • Terima ruang kerja penyelamat default, kecuali Anda sudah mengelolanya sendiri.

​
Perubahan yang dilakukan --profile rescue onboard

--profile rescue onboard menjalankan alur orientasi awal normal, tetapi menulis semuanya ke profil terpisah, sehingga bot penyelamat memiliki:
  • File profil/konfigurasi
  • Direktori status
  • Ruang kerja (default: ~/.openclaw/workspace-rescue)
  • Nama layanan terkelola
  • Port dasar (beserta port turunan)
  • Token bot Telegram
Prompt lainnya identik dengan orientasi awal normal.

​
Penyiapan multi-Gateway umum

Pola isolasi yang sama dapat digunakan untuk pasangan atau kelompok Gateway apa pun pada satu host - berikan profil bernama dan port dasar tersendiri kepada setiap Gateway tambahan:
Profil bernama pada kedua sisi juga dapat digunakan:
Layanan mengikuti pola yang sama:
Gunakan mulai cepat bot penyelamat untuk jalur operator cadangan; gunakan pola profil umum untuk beberapa Gateway berumur panjang di berbagai saluran, tenant, ruang kerja, atau peran operasional.

​
Daftar periksa isolasi

Pastikan pengaturan berikut unik untuk setiap instans Gateway: Berbagi salah satu dari pengaturan ini menyebabkan konflik konfigurasi, status, atau port. Saat dimulai, Gateway memberlakukan kepemilikan direktori status yang unik meskipun OPENCLAW_ALLOW_MULTI_GATEWAY=1 melewati instans tunggal per konfigurasi.

​
Pemetaan port (turunan)

Port dasar = gateway.port (atau OPENCLAW_GATEWAY_PORT / --port).
  • Port layanan kontrol browser = port dasar + 2 (khusus loopback).
  • Host Canvas disajikan pada server HTTP Gateway itu sendiri (port yang sama dengan gateway.port).
  • Port CDP profil browser dialokasikan secara otomatis dari browser control port + 9 hingga + 108.
Jika Anda mengganti salah satunya dalam konfigurasi atau variabel lingkungan, Anda harus memastikan nilainya unik untuk setiap instans.

​
Catatan browser/CDP (kesalahan umum)

  • Jangan tetapkan browser.cdpUrl ke nilai yang sama pada beberapa instans.
  • Setiap instans memerlukan port kontrol browser dan rentang CDP tersendiri (diturunkan dari port gateway-nya).
  • Untuk port CDP eksplisit, atur browser.profiles.<name>.cdpPort untuk setiap instans.
  • Untuk Chrome jarak jauh, gunakan browser.profiles.<name>.cdpUrl (per profil, per instans).

​
Contoh variabel lingkungan manual

​
Pemeriksaan cepat

  • gateway status --deep mendeteksi layanan launchd/systemd/schtasks usang dari pemasangan lama.
  • Teks peringatan gateway probe seperti multiple reachable gateway identities detected hanya diharapkan ketika Anda sengaja menjalankan lebih dari satu gateway terisolasi, atau ketika OpenClaw tidak dapat membuktikan bahwa target pemeriksaan yang dapat dijangkau merupakan gateway yang sama. Terowongan SSH, URL proksi, atau URL jarak jauh yang dikonfigurasi menuju gateway yang sama tetap merupakan satu gateway dengan beberapa transpor, meskipun port transpor berbeda.

​
Terkait