OpenClawDocs
Sur cette page

Sur cette page

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

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

bash
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 presence

system 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> : now ou next-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.

Voir aussi

Was this useful?