CLI commands

Tiến trình nền

openclaw daemon

Bí danh cũ để quản lý dịch vụ Gateway. openclaw daemon ... ánh xạ đến các lệnh điều khiển dịch vụ giống như openclaw gateway .... Nên dùng openclaw gateway trong tài liệu và ví dụ hiện tại.

Cách sử dụng

bash
openclaw daemon statusopenclaw daemon installopenclaw daemon startopenclaw daemon stopopenclaw daemon restartopenclaw daemon uninstall

Lệnh con và tùy chọn

Lệnh con Tùy chọn
status --url, --token, --password, --timeout, --no-probe, --require-rpc, --deep, --json
install --port, --runtime <node|bun>, --token, --wrapper <path>, --force, --json
uninstall --json
start --json
stop --json, --disable (chỉ dành cho launchd: vô hiệu hóa liên tục KeepAlive/RunAtLoad cho đến lần khởi động tiếp theo)
restart --force, --safe, --skip-deferral, --wait <duration>, --json
  • status: hiển thị trạng thái cài đặt dịch vụ (launchd/systemd/schtasks) và thăm dò tình trạng của Gateway.
  • install: cài đặt dịch vụ; --force cài đặt lại/ghi đè một bản cài đặt hiện có.
  • restart --safe: yêu cầu Gateway đang chạy kiểm tra sơ bộ công việc đang hoạt động và lên lịch một lần khởi động lại được gộp sau khi công việc hoàn tất, với giới hạn bởi gateway.reload.deferralTimeoutMs (mặc định 300000ms/5 phút; đặt thành 0 để chờ vô thời hạn). Khi hết khoảng thời gian này, việc khởi động lại vẫn bị buộc thực hiện. restart thông thường sử dụng trực tiếp trình quản lý dịch vụ; --force là tùy chọn ghi đè để thực hiện ngay lập tức.
  • restart --safe --skip-deferral: bỏ qua cổng trì hoãn do công việc đang hoạt động để Gateway khởi động lại ngay cả khi có báo cáo về yếu tố cản trở. Yêu cầu --safe.

Ghi chú

  • status phân giải các SecretRef xác thực đã cấu hình để xác thực phép thăm dò khi có thể. Nếu không phân giải được một SecretRef bắt buộc, status --json báo cáo rpc.authWarning; hãy truyền rõ --token/--password hoặc phân giải nguồn bí mật trước. Các cảnh báo xác thực chưa phân giải sẽ bị ẩn khi phép thăm dò vẫn thành công.
  • status --deep bổ sung quá trình quét cấp hệ thống theo khả năng tốt nhất để tìm các dịch vụ khác tương tự Gateway (in gợi ý dọn dẹp; vẫn khuyến nghị mỗi máy chỉ chạy một Gateway) và chạy xác thực cấu hình ở chế độ nhận biết Plugin, hiển thị các cảnh báo trong bản kê khai Plugin mà đường dẫn nhanh mặc định bỏ qua.
  • Trên các bản cài đặt systemd Linux, việc kiểm tra độ lệch token xem xét cả nguồn đơn vị Environment=EnvironmentFile=.
  • Việc kiểm tra độ lệch token phân giải các SecretRef gateway.auth.token bằng môi trường thời gian chạy đã hợp nhất (môi trường lệnh dịch vụ trước, sau đó là môi trường tiến trình). Nếu xác thực bằng token không thực sự hoạt động (gateway.auth.modepassword/none/trusted-proxy, hoặc chưa đặt và mật khẩu có thể được ưu tiên), quá trình phân giải token cấu hình sẽ bị bỏ qua.
  • install xác thực rằng gateway.auth.token do SecretRef quản lý có thể phân giải được nhưng không bao giờ lưu giá trị đã phân giải vào siêu dữ liệu môi trường dịch vụ; nếu không thể phân giải, quá trình cài đặt sẽ dừng theo nguyên tắc an toàn.
  • Nếu cả gateway.auth.tokengateway.auth.password đều được cấu hình nhưng gateway.auth.mode chưa được đặt, install sẽ chặn cho đến khi bạn đặt chế độ rõ ràng.
  • Trên macOS, install giới hạn quyền truy cập các tệp plist LaunchAgent và tệp môi trường/trình bao bọc được tạo chỉ cho chủ sở hữu (chế độ 0600/0700), thay vì nhúng bí mật vào EnvironmentVariables.
  • Chạy nhiều Gateway trên một máy chủ: tách biệt cổng, cấu hình/trạng thái và không gian làm việc. Xem Nhiều Gateway.

Liên quan

Was this useful?
On this page

On this page