Passer au contenu principal

Documentation Index

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

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

​
openclaw system

Assistants au niveau système pour le Gateway : mettre en file d’attente des événements système, contrôler les heartbeats, et afficher la présence. Toutes les sous-commandes system utilisent le RPC du Gateway et acceptent les indicateurs client partagés :
  • --url <url>
  • --token <token>
  • --timeout <ms>
  • --expect-final

​
Commandes courantes

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

Met en file d’attente un événement système sur la session principale par défaut. Le prochain heartbeat l’injectera comme une ligne System: dans le prompt. Utilisez --mode now pour déclencher le heartbeat immédiatement ; next-heartbeat attend le prochain tick planifié. Passez --session-key pour cibler une session spécifique (par exemple pour relayer la fin d’une tâche asynchrone au canal qui l’a démarrée).
Exception de synchronisation avec --session-key : lorsque --session-key est fourni, --mode next-heartbeat se réduit à un réveil ciblé immédiat au lieu d’attendre le prochain tick planifié. Les réveils ciblés utilisent l’intention de heartbeat immediate, ce qui leur permet de contourner la barrière not-due du runner qui autrement différerait (et abandonnerait effectivement) un réveil d’intention event. Si vous voulez une livraison différée, omettez --session-key afin que l’événement arrive sur la session principale et accompagne le prochain heartbeat régulier.
Indicateurs :
  • --text <text> : texte d’événement système requis.
  • --mode <mode> : now ou next-heartbeat (par défaut).
  • --session-key <sessionKey> : facultatif ; cible une session d’agent spécifique au lieu de la session principale de l’agent. Les clés qui n’appartiennent pas à l’agent résolu retombent sur la session principale de l’agent.
  • --json : sortie lisible par machine.
  • --url, --token, --timeout, --expect-final : indicateurs RPC Gateway partagés.

​
system heartbeat last|enable|disable

Contrôles Heartbeat :
  • last : affiche le dernier événement heartbeat.
  • enable : réactive les heartbeats (à utiliser s’ils ont été désactivés).
  • disable : met les heartbeats en pause.
Indicateurs :
  • --json : sortie lisible par machine.
  • --url, --token, --timeout, --expect-final : indicateurs RPC Gateway partagés.

​
system presence

Répertorie les entrées de présence système actuelles connues du Gateway (nœuds, instances et lignes d’état similaires). Indicateurs :
  • --json : sortie lisible par machine.
  • --url, --token, --timeout, --expect-final : indicateurs RPC Gateway partagés.

​
Notes

  • Nécessite un Gateway en cours d’exécution, joignable par votre configuration actuelle (locale ou distante).
  • Les événements système sont éphémères et ne persistent pas entre les redémarrages.

​
Associé