CLI commands

Proses latar belakang

openclaw daemon

Alias lama untuk perintah pengelolaan layanan Gateway.

openclaw daemon ... dipetakan ke permukaan kontrol layanan yang sama dengan perintah layanan openclaw gateway ....

Penggunaan

openclaw daemon status
openclaw daemon install
openclaw daemon start
openclaw daemon stop
openclaw daemon restart
openclaw daemon uninstall

Subperintah

  • status: tampilkan status pemasangan layanan dan periksa kesehatan Gateway
  • install: pasang layanan (launchd/systemd/schtasks)
  • uninstall: hapus layanan
  • start: mulai layanan
  • stop: hentikan layanan
  • restart: mulai ulang layanan

Opsi umum

  • status: --url, --token, --password, --timeout, --no-probe, --require-rpc, --deep, --json
  • install: --port, --runtime <node|bun>, --token, --force, --json
  • restart: --safe, --force, --wait <duration>, --json
  • siklus hidup (uninstall|start|stop): --json

Catatan:

  • status menyelesaikan SecretRefs autentikasi yang dikonfigurasi untuk autentikasi pemeriksaan jika memungkinkan.
  • Jika SecretRef autentikasi yang diperlukan tidak terselesaikan di jalur perintah ini, daemon status --json melaporkan rpc.authWarning saat konektivitas/autentikasi pemeriksaan gagal; berikan --token/--password secara eksplisit atau selesaikan sumber rahasia terlebih dahulu.
  • Jika pemeriksaan berhasil, peringatan auth-ref yang tidak terselesaikan ditekan untuk menghindari positif palsu.
  • status --deep menambahkan pemindaian layanan tingkat sistem dengan upaya terbaik. Saat menemukan layanan lain yang mirip Gateway, keluaran untuk manusia menampilkan petunjuk pembersihan dan memperingatkan bahwa satu Gateway per mesin tetap menjadi rekomendasi normal.
  • Pada pemasangan systemd Linux, pemeriksaan drift token status mencakup sumber unit Environment= dan EnvironmentFile=.
  • Pemeriksaan drift menyelesaikan SecretRefs gateway.auth.token menggunakan env runtime gabungan (env perintah layanan terlebih dahulu, lalu fallback env proses).
  • Jika autentikasi token tidak aktif secara efektif (gateway.auth.mode eksplisit berupa password/none/trusted-proxy, atau mode tidak disetel saat kata sandi dapat menang dan tidak ada kandidat token yang dapat menang), pemeriksaan drift token melewati penyelesaian token config.
  • Saat autentikasi token memerlukan token dan gateway.auth.token dikelola SecretRef, install memvalidasi bahwa SecretRef dapat diselesaikan tetapi tidak mempertahankan token yang terselesaikan ke metadata lingkungan layanan.
  • Jika autentikasi token memerlukan token dan SecretRef token yang dikonfigurasi tidak terselesaikan, pemasangan gagal tertutup.
  • Jika gateway.auth.token dan gateway.auth.password sama-sama dikonfigurasi dan gateway.auth.mode tidak disetel, pemasangan diblokir sampai mode disetel secara eksplisit.
  • Pada macOS, install menjaga plist LaunchAgent hanya dimiliki pemilik dan memuat nilai lingkungan layanan terkelola melalui file dan wrapper khusus pemilik, bukan menyerialkan kunci API atau ref env auth-profile ke dalam EnvironmentVariables.
  • Jika Anda sengaja menjalankan beberapa Gateway pada satu host, isolasi port, config/status, dan workspace; lihat /gateway#multiple-gateways-same-host.
  • restart --safe meminta Gateway yang sedang berjalan untuk melakukan preflight pekerjaan aktif dan menjadwalkan satu mulai ulang tergabung setelah pekerjaan aktif selesai. restart biasa mempertahankan perilaku pengelola layanan yang ada; --force tetap menjadi jalur override langsung.

Disarankan

Gunakan openclaw gateway untuk dokumentasi dan contoh saat ini.

Terkait