CLI commands
เดมอน
openclaw daemon
นามแฝงเดิมสำหรับคำสั่งจัดการบริการ Gateway
openclaw daemon ... แมปไปยังพื้นผิวควบคุมบริการเดียวกับคำสั่งบริการ openclaw gateway ...
การใช้งาน
openclaw daemon status
openclaw daemon install
openclaw daemon start
openclaw daemon stop
openclaw daemon restart
openclaw daemon uninstall
คำสั่งย่อย
status: แสดงสถานะการติดตั้งบริการและตรวจสอบสุขภาพ Gatewayinstall: ติดตั้งบริการ (launchd/systemd/schtasks)uninstall: ลบบริการstart: เริ่มบริการstop: หยุดบริการrestart: รีสตาร์ตบริการ
ตัวเลือกทั่วไป
status:--url,--token,--password,--timeout,--no-probe,--require-rpc,--deep,--jsoninstall:--port,--runtime <node|bun>,--token,--force,--jsonrestart:--safe,--force,--wait <duration>,--json- วงจรชีวิต (
uninstall|start|stop):--json
หมายเหตุ:
statusแปลงค่า SecretRefs ของการยืนยันตัวตนที่กำหนดค่าไว้สำหรับการยืนยันตัวตนของการตรวจสอบเมื่อทำได้- หาก SecretRef ของการยืนยันตัวตนที่จำเป็นไม่สามารถแปลงค่าได้ในเส้นทางคำสั่งนี้
daemon status --jsonจะรายงานrpc.authWarningเมื่อการเชื่อมต่อหรือการยืนยันตัวตนของการตรวจสอบล้มเหลว ให้ส่ง--token/--passwordอย่างชัดเจน หรือแปลงค่าแหล่งที่มาของ secret ก่อน - หากการตรวจสอบสำเร็จ คำเตือน auth-ref ที่ยังแปลงค่าไม่ได้จะถูกระงับเพื่อหลีกเลี่ยงผลบวกลวง
status --deepเพิ่มการสแกนบริการระดับระบบแบบพยายามให้ดีที่สุด เมื่อพบบริการอื่นที่คล้าย Gateway เอาต์พุตสำหรับมนุษย์จะพิมพ์คำแนะนำการล้างข้อมูลและเตือนว่าคำแนะนำปกติยังคงเป็นหนึ่ง Gateway ต่อหนึ่งเครื่อง- สำหรับการติดตั้ง systemd บน Linux การตรวจสอบ token-drift ของ
statusรวมทั้งแหล่งที่มาของยูนิตEnvironment=และEnvironmentFile= - การตรวจสอบ drift แปลงค่า SecretRefs ของ
gateway.auth.tokenโดยใช้ runtime env ที่ผสานแล้ว (env ของคำสั่งบริการก่อน แล้วจึงใช้ process env เป็น fallback) - หากการยืนยันตัวตนด้วยโทเค็นไม่ได้ทำงานอย่างมีผลจริง (ตั้งค่า
gateway.auth.modeอย่างชัดเจนเป็นpassword/none/trusted-proxyหรือไม่ได้ตั้งค่าโหมดในกรณีที่รหัสผ่านสามารถชนะได้และไม่มีตัวเลือกโทเค็นใดชนะได้) การตรวจสอบ token-drift จะข้ามการแปลงค่าโทเค็นจากการกำหนดค่า - เมื่อการยืนยันตัวตนด้วยโทเค็นต้องใช้โทเค็นและ
gateway.auth.tokenจัดการโดย SecretRef,installจะตรวจสอบว่า SecretRef แปลงค่าได้ แต่จะไม่คงค่าโทเค็นที่แปลงแล้วไว้ในข้อมูลเมตา environment ของบริการ - หากการยืนยันตัวตนด้วยโทเค็นต้องใช้โทเค็นและ SecretRef ของโทเค็นที่กำหนดค่าไว้ยังแปลงค่าไม่ได้ การติดตั้งจะล้มเหลวแบบปิด
- หากกำหนดค่าทั้ง
gateway.auth.tokenและgateway.auth.passwordและไม่ได้ตั้งค่าgateway.auth.modeการติดตั้งจะถูกบล็อกจนกว่าจะตั้งค่าโหมดอย่างชัดเจน - บน macOS,
installจะเก็บ plist ของ LaunchAgent ให้เฉพาะเจ้าของเท่านั้น และโหลดค่า environment ของบริการที่จัดการผ่านไฟล์และ wrapper ที่เฉพาะเจ้าของเท่านั้น แทนการซีเรียลไลซ์คีย์ API หรือ env refs ของ auth-profile ลงในEnvironmentVariables - หากคุณตั้งใจเรียกใช้ Gateway หลายตัวบนโฮสต์เดียว ให้แยกพอร์ต การกำหนดค่า/สถานะ และเวิร์กสเปซออกจากกัน ดู /gateway#multiple-gateways-same-host
restart --safeขอให้ Gateway ที่กำลังทำงานอยู่ตรวจสอบงานที่ใช้งานอยู่ล่วงหน้าและกำหนดเวลารีสตาร์ตแบบรวมครั้งเดียวหลังจากงานที่ใช้งานอยู่หมดลงrestartแบบธรรมดายังคงพฤติกรรมเดิมของตัวจัดการบริการไว้ ส่วน--forceยังคงเป็นเส้นทางบังคับทันที
แนะนำ
ใช้ openclaw gateway สำหรับเอกสารและตัวอย่างปัจจุบัน