CLI commands
Système
openclaw system
Utilitaires système pour le Gateway : mise en file d’attente des événements système, contrôle des Heartbeats et affichage de la présence.
Toutes les sous-commandes system utilisent le RPC du Gateway et acceptent les options client communes :
| Option | Valeur par défaut | Description |
|---|---|---|
--url <url> |
gateway.remote.url si configurée |
URL WebSocket du Gateway. |
--token <token> |
aucune | Jeton du Gateway (si requis). |
--timeout <ms> |
30000 |
Délai d’expiration du RPC en millisecondes. |
--expect-final |
désactivée | Attendre la réponse finale (agent). |
--json |
désactivée | Produire du JSON. heartbeat last/enable/disable et system presence affichent toujours la charge utile JSON RPC brute, quelle que soit cette option ; system event l’utilise pour basculer entre du JSON et une simple ligne ok. |
Commandes courantes
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
Met par défaut un événement système en file d’attente dans la session principale. Le prochain Heartbeat l’injecte dans l’invite sous la forme d’une ligne System:. Utilisez --mode now pour déclencher immédiatement le Heartbeat ; next-heartbeat (valeur par défaut) attend le prochain déclenchement planifié.
Passez --session-key pour cibler une session précise, par exemple afin de relayer la fin d’une tâche asynchrone vers le canal qui l’a lancée.
Options :
--text <text>: texte requis de l’événement système.--mode <mode>:nowounext-heartbeat(valeur par défaut).--session-key <sessionKey>: facultatif ; cible une session d’agent précise au lieu de la session principale de l’agent. Les clés qui n’appartiennent pas à l’agent résolu utilisent à la place la session principale de cet agent.
system heartbeat last|enable|disable
last: afficher le dernier événement de Heartbeat.enable: réactiver les Heartbeats (utilisez cette commande s’ils ont été désactivés).disable: suspendre les Heartbeats.
system presence
Répertorie les entrées de présence système actuellement connues du Gateway (nœuds, instances et lignes d’état similaires).
Remarques
- Nécessite un Gateway en cours d’exécution et accessible avec votre configuration actuelle (locale ou distante).
- Les événements système sont éphémères et ne sont pas conservés après un redémarrage.
