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 Gatewayinstall: pasang layanan (launchd/systemd/schtasks)uninstall: hapus layananstart: mulai layananstop: hentikan layananrestart: mulai ulang layanan
Opsi umum
status:--url,--token,--password,--timeout,--no-probe,--require-rpc,--deep,--jsoninstall:--port,--runtime <node|bun>,--token,--force,--jsonrestart:--safe,--force,--wait <duration>,--json- siklus hidup (
uninstall|start|stop):--json
Catatan:
statusmenyelesaikan SecretRefs autentikasi yang dikonfigurasi untuk autentikasi pemeriksaan jika memungkinkan.- Jika SecretRef autentikasi yang diperlukan tidak terselesaikan di jalur perintah ini,
daemon status --jsonmelaporkanrpc.authWarningsaat konektivitas/autentikasi pemeriksaan gagal; berikan--token/--passwordsecara eksplisit atau selesaikan sumber rahasia terlebih dahulu. - Jika pemeriksaan berhasil, peringatan auth-ref yang tidak terselesaikan ditekan untuk menghindari positif palsu.
status --deepmenambahkan 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
statusmencakup sumber unitEnvironment=danEnvironmentFile=. - Pemeriksaan drift menyelesaikan SecretRefs
gateway.auth.tokenmenggunakan env runtime gabungan (env perintah layanan terlebih dahulu, lalu fallback env proses). - Jika autentikasi token tidak aktif secara efektif (
gateway.auth.modeeksplisit berupapassword/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.tokendikelola SecretRef,installmemvalidasi 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.tokendangateway.auth.passwordsama-sama dikonfigurasi dangateway.auth.modetidak disetel, pemasangan diblokir sampai mode disetel secara eksplisit. - Pada macOS,
installmenjaga 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 dalamEnvironmentVariables. - Jika Anda sengaja menjalankan beberapa Gateway pada satu host, isolasi port, config/status, dan workspace; lihat /gateway#multiple-gateways-same-host.
restart --safememinta Gateway yang sedang berjalan untuk melakukan preflight pekerjaan aktif dan menjadwalkan satu mulai ulang tergabung setelah pekerjaan aktif selesai.restartbiasa mempertahankan perilaku pengelola layanan yang ada;--forcetetap menjadi jalur override langsung.
Disarankan
Gunakan openclaw gateway untuk dokumentasi dan contoh saat ini.