CLI commands
System
openclaw system
Pomocnicze funkcje systemowe dla Gateway: kolejkowanie zdarzeń systemowych, sterowanie sygnałami Heartbeat i wyświetlanie informacji o obecności.
Wszystkie podpolecenia system używają RPC Gateway i przyjmują wspólne flagi klienta:
| Flaga | Wartość domyślna | Opis |
|---|---|---|
--url <url> |
gateway.remote.url, jeśli ustawiono |
Adres URL WebSocket Gateway. |
--token <token> |
brak | Token Gateway (jeśli jest wymagany). |
--timeout <ms> |
30000 |
Limit czasu RPC w milisekundach. |
--expect-final |
wyłączone | Oczekuj na odpowiedź końcową (agenta). |
--json |
wyłączone | Wyświetl dane JSON. Polecenia heartbeat last/enable/disable i system presence zawsze wyświetlają nieprzetworzony ładunek JSON RPC niezależnie od tej flagi; system event używa jej do przełączania między formatem JSON a zwykłym wierszem ok. |
Typowe polecenia
openclaw system event --text "Check for urgent follow-ups" --mode nowopenclaw system event --text "Check for urgent follow-ups" --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"openclaw system heartbeat enableopenclaw system heartbeat lastopenclaw system presencesystem event
Domyślnie kolejkuje zdarzenie systemowe w sesji głównej. Następny
Heartbeat wstawia je do monitu jako wiersz System:. Użyj --mode now, aby
natychmiast wyzwolić Heartbeat; next-heartbeat (wartość domyślna) oczekuje na
następne zaplanowane wywołanie.
Przekaż --session-key, aby wskazać konkretną sesję, na przykład w celu przekazania
informacji o zakończeniu zadania asynchronicznego z powrotem do kanału, który je uruchomił.
Flagi:
--text <text>: wymagany tekst zdarzenia systemowego.--mode <mode>:nowlubnext-heartbeat(wartość domyślna).--session-key <sessionKey>: opcjonalne; wskazuje konkretną sesję agenta zamiast jego sesji głównej. Klucze, które nie należą do rozpoznanego agenta, powodują użycie jego sesji głównej.
system heartbeat last|enable|disable
last: wyświetla ostatnie zdarzenie Heartbeat.enable: ponownie włącza sygnały Heartbeat (użyj tej opcji, jeśli zostały wyłączone).disable: wstrzymuje sygnały Heartbeat.
system presence
Wyświetla bieżące wpisy obecności systemowej znane Gateway (węzły, instancje i podobne wiersze stanu).
Uwagi
- Wymaga działającego Gateway dostępnego przy użyciu bieżącej konfiguracji (lokalnie lub zdalnie).
- Zdarzenia systemowe są tymczasowe i nie są zachowywane po ponownym uruchomieniu.
