​

Outils de session

OpenClaw fournit aux agents des outils pour travailler entre les sessions, inspecter l’état et orchestrer des sous-agents.

​

Outils disponibles

​

Lister et lire les sessions

sessions_list renvoie les sessions avec leur clé, type, canal, modèle, comptes de jetons et horodatages. Filtrez par type (main, group, cron, hook, node) ou par récence (activeMinutes). sessions_history récupère la transcription de conversation d’une session spécifique. Par défaut, les résultats d’outil sont exclus — transmettez includeTools: true pour les voir. La vue renvoyée est volontairement bornée et filtrée pour la sécurité :

• le texte assistant est normalisé avant rappel :
  • les balises de réflexion sont supprimées
  • les blocs d’échafaudage <relevant-memories> / <relevant_memories> sont supprimés
  • les blocs de charge utile XML d’appel d’outil en texte brut tels que <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls> et <function_calls>...</function_calls> sont supprimés, y compris les charges utiles tronquées qui ne se ferment jamais correctement
  • l’échafaudage rétrogradé d’appel/résultat d’outil tel que [Tool Call: ...], [Tool Result ...] et [Historical context ...] est supprimé
  • les jetons de contrôle du modèle divulgués tels que <|assistant|>, les autres jetons ASCII <|...|> et les variantes pleine largeur <｜...｜> sont supprimés
  • les XML mal formés d’appel d’outil MiniMax tels que <invoke ...> / </minimax:tool_call> sont supprimés
• le texte de type identifiants/jetons est expurgé avant d’être renvoyé
• les longs blocs de texte sont tronqués
• les historiques très volumineux peuvent supprimer les lignes plus anciennes ou remplacer une ligne surdimensionnée par [sessions_history omitted: message too large]
• l’outil signale des indicateurs récapitulatifs tels que truncated, droppedMessages, contentTruncated, contentRedacted et bytes

Les deux outils acceptent soit une clé de session (comme "main"), soit un ID de session issu d’un appel de liste précédent. Si vous avez besoin de la transcription exacte octet par octet, inspectez le fichier de transcription sur le disque au lieu de traiter sessions_history comme un dump brut.

​

Envoi de messages inter-sessions

sessions_send livre un message à une autre session et peut éventuellement attendre la réponse :

• Fire-and-forget : définissez timeoutSeconds: 0 pour mettre en file et renvoyer immédiatement.
• Attendre une réponse : définissez un délai d’expiration et obtenez la réponse inline.

Après que la cible a répondu, OpenClaw peut exécuter une boucle de réponse réciproque où les agents alternent les messages (jusqu’à 5 tours). L’agent cible peut répondre REPLY_SKIP pour s’arrêter plus tôt.

​

Assistants de statut et d’orchestration

session_status est l’outil léger équivalent à /status pour la session courante ou une autre session visible. Il signale l’utilisation, l’heure, l’état du modèle/runtime et le contexte des tâches en arrière-plan liées lorsqu’il est présent. Comme /status, il peut compléter des compteurs clairsemés de jetons/cache à partir de la dernière entrée d’utilisation de transcription, et model=default efface un remplacement par session. sessions_yield termine intentionnellement le tour en cours afin que le message suivant puisse être l’événement de suivi que vous attendez. Utilisez-le après avoir lancé des sous-agents lorsque vous souhaitez que les résultats d’achèvement arrivent comme message suivant au lieu de construire des boucles de sondage. subagents est l’assistant du plan de contrôle pour les sous-agents OpenClaw déjà lancés. Il prend en charge :

• action: "list" pour inspecter les exécutions actives/récentes
• action: "steer" pour envoyer des consignes de suivi à un enfant en cours d’exécution
• action: "kill" pour arrêter un enfant ou all

​

Lancement de sous-agents

sessions_spawn crée une session isolée pour une tâche en arrière-plan. C’est toujours non bloquant — il renvoie immédiatement avec un runId et un childSessionKey. Options principales :

• runtime: "subagent" (par défaut) ou "acp" pour les agents de harnais externes.
• Remplacements model et thinking pour la session enfant.
• thread: true pour lier le lancement à un fil de discussion (Discord, Slack, etc.).
• sandbox: "require" pour imposer le sandboxing sur l’enfant.

Les sous-agents feuille par défaut n’obtiennent pas d’outils de session. Lorsque maxSpawnDepth >= 2, les sous-agents orchestrateurs de profondeur 1 reçoivent en plus sessions_spawn, subagents, sessions_list et sessions_history afin qu’ils puissent gérer leurs propres enfants. Les exécutions feuille n’obtiennent toujours pas d’outils d’orchestration récursive. Après l’achèvement, une étape d’annonce publie le résultat sur le canal du demandeur. La livraison de l’achèvement préserve le routage lié thread/sujet lorsqu’il est disponible, et si l’origine d’achèvement n’identifie qu’un canal, OpenClaw peut encore réutiliser la route stockée de la session demandeuse (lastChannel / lastTo) pour une livraison directe. Pour le comportement spécifique à ACP, consultez ACP Agents.

​

Visibilité

Les outils de session sont limités afin de restreindre ce que l’agent peut voir : La valeur par défaut est tree. Les sessions sandboxées sont limitées à tree quelle que soit la configuration.

​

Pour aller plus loin

• Gestion des sessions — routage, cycle de vie, maintenance
• ACP Agents — lancement de harnais externes
• Multi-agent — architecture multi-agent
• Configuration de la passerelle — réglages de configuration des outils de session