Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
openclaw system

Trình trợ giúp cấp hệ thống cho Gateway: đưa sự kiện hệ thống vào hàng đợi, điều khiển Heartbeat, và xem trạng thái hiện diện. Tất cả lệnh con system dùng Gateway RPC và chấp nhận các cờ máy khách dùng chung:
  • --url <url>
  • --token <token>
  • --timeout <ms>
  • --expect-final

​
Lệnh phổ biến

openclaw system event --text "Check for urgent follow-ups" --mode now
openclaw system event --text "Check for urgent follow-ups" --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"
openclaw system heartbeat enable
openclaw system heartbeat last
openclaw system presence

​
system event

Theo mặc định, đưa một sự kiện hệ thống vào hàng đợi trên phiên main. Heartbeat tiếp theo sẽ chèn nó dưới dạng một dòng System: trong prompt. Dùng --mode now để kích hoạt Heartbeat ngay lập tức; next-heartbeat chờ tick đã lên lịch tiếp theo. Truyền --session-key để nhắm tới một phiên cụ thể (ví dụ để chuyển tiếp việc hoàn tất tác vụ bất đồng bộ trở lại kênh đã khởi động tác vụ đó).
Ngoại lệ về thời điểm với --session-key: khi cung cấp --session-key, --mode next-heartbeat sẽ rút gọn thành một lần đánh thức có nhắm mục tiêu ngay lập tức thay vì chờ tick đã lên lịch tiếp theo. Các lần đánh thức có nhắm mục tiêu dùng ý định Heartbeat immediate, nên chúng bỏ qua cổng chưa đến hạn của runner, vốn nếu không sẽ trì hoãn (và thực tế là loại bỏ) một lần đánh thức có ý định event. Nếu bạn muốn gửi có độ trễ, hãy bỏ qua --session-key để sự kiện được đưa vào phiên chính và đi theo Heartbeat định kỳ tiếp theo.
Cờ:
  • --text <text>: văn bản sự kiện hệ thống bắt buộc.
  • --mode <mode>: now hoặc next-heartbeat (mặc định).
  • --session-key <sessionKey>: tùy chọn; nhắm tới một phiên tác nhân cụ thể thay vì phiên chính của tác nhân. Các khóa không thuộc về tác nhân đã phân giải sẽ quay về phiên chính của tác nhân.
  • --json: đầu ra máy đọc được.
  • --url, --token, --timeout, --expect-final: các cờ Gateway RPC dùng chung.

​
system heartbeat last|enable|disable

Điều khiển Heartbeat:
  • last: hiển thị sự kiện Heartbeat gần nhất.
  • enable: bật lại Heartbeat (dùng tùy chọn này nếu chúng đã bị tắt).
  • disable: tạm dừng Heartbeat.
Cờ:
  • --json: đầu ra máy đọc được.
  • --url, --token, --timeout, --expect-final: các cờ Gateway RPC dùng chung.

​
system presence

Liệt kê các mục hiện diện hệ thống hiện tại mà Gateway biết (nút, phiên bản, và các dòng trạng thái tương tự). Cờ:
  • --json: đầu ra máy đọc được.
  • --url, --token, --timeout, --expect-final: các cờ Gateway RPC dùng chung.

​
Ghi chú

  • Yêu cầu một Gateway đang chạy và có thể truy cập bằng cấu hình hiện tại của bạn (cục bộ hoặc từ xa).
  • Sự kiện hệ thống là tạm thời và không được duy trì qua các lần khởi động lại.

​
Liên quan