Agent coordination

Envoi de l’agent

openclaw agent exécute un seul tour d’agent depuis la ligne de commande sans message de discussion entrant. Utilisez-le pour les workflows scriptés, les tests et la distribution automatisée. Référence complète des options et du comportement : Référence de la CLI de l’agent.

Démarrage rapide

Exécuter un tour d’agent simple

bash

openclaw agent --agent main --message "What is the weather today?"

Envoie le message via le Gateway et affiche la réponse.

Envoyer une invite multiligne depuis un fichier

bash

openclaw agent --agent ops --message-file ./task.md

Lit un fichier UTF-8 valide comme corps du message de l’agent.

Cibler un agent ou une session spécifique

bash

# Cibler un agent spécifiqueopenclaw agent --agent ops --message "Summarize logs" # Cibler un numéro de téléphone (dérive la clé de session)openclaw agent --to +15555550123 --message "Status update" # Réutiliser une session existanteopenclaw agent --session-id abc123 --message "Continue the task" # Cibler une clé de session exacteopenclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

Distribuer la réponse sur un canal

bash

# Distribuer sur WhatsApp (canal par défaut)openclaw agent --to +15555550123 --message "Report ready" --deliver # Distribuer sur Slackopenclaw agent --agent ops --message "Generate report" \  --deliver --reply-channel slack --reply-to "#reports"

Options

Option	Description
`--message <text>`	Message en ligne à envoyer
`--message-file <path>`	Lire le message depuis un fichier UTF-8 valide
`--to <dest>`	Dériver la clé de session d’une cible (téléphone, identifiant de discussion)
`--session-key <key>`	Utiliser une clé de session explicite
`--agent <id>`	Cibler un agent configuré (utilise sa session `main`)
`--session-id <id>`	Réutiliser une session existante par identifiant
`--model <id>`	Remplacer le modèle pour cette exécution (`provider/model` ou identifiant de modèle)
`--local`	Forcer l’environnement d’exécution intégré local (ignorer le Gateway)
`--deliver`	Envoyer la réponse à un canal de discussion
`--channel <name>`	Canal de distribution ; avec `--agent` + `--to`, s’applique aussi à la portée des messages privés
`--reply-to <target>`	Remplacer la cible de distribution
`--reply-channel <name>`	Remplacer le canal de distribution
`--reply-account <id>`	Remplacer l’identifiant du compte de distribution
`--thinking <level>`	Définir le niveau de réflexion pour le profil de modèle sélectionné
`--verbose <on\|full\|off>`	Conserver le niveau de verbosité pour la session (`full` journalise également la sortie des outils)
`--timeout <seconds>`	Remplacer le délai d’expiration de l’agent (600 par défaut, ou valeur de configuration)
`--json`	Produire une sortie JSON structurée

Comportement

Par défaut, la CLI passe par le Gateway. Ajoutez --local pour forcer l’environnement d’exécution intégré sur la machine actuelle.
Transmettez exactement l’une des options --message ou --message-file. Les messages de fichier conservent le contenu multiligne après la suppression d’un éventuel BOM UTF-8.
Si la requête au Gateway échoue, la CLI se rabat sur l’exécution intégrée locale ; en cas d’expiration du délai du Gateway, elle se rabat sur une nouvelle session au lieu de mettre en concurrence la transcription d’origine.
Sélection de la session : --to dérive la clé de session (les cibles de groupe/canal conservent leur isolation ; les discussions directes sont regroupées dans main). Lorsque --agent, --channel et --to sont utilisés ensemble, le routage suit le destinataire canonique du canal et session.dmScope. Les identités stables utilisées uniquement pour les envois sortants emploient une session détenue par le fournisseur et isolée de la session principale de l’agent.
--session-key sélectionne une clé explicite. Les clés préfixées par un agent doivent utiliser agent:<agent-id>:<session-key>, et --agent doit correspondre à cet identifiant d’agent lorsque les deux sont fournis. Les clés simples qui ne sont pas des sentinelles sont limitées à --agent lorsqu’il est fourni ; par exemple, --agent ops --session-key incident-42 dirige vers agent:ops:incident-42. Sans --agent, les clés simples qui ne sont pas des sentinelles sont limitées à l’agent configuré par défaut. Les valeurs littérales global et unknown restent sans portée uniquement lorsqu’aucun --agent n’est fourni ; le chemin de repli intégré résout ces sessions sentinelles vers l’agent configuré par défaut.
--reply-channel et --reply-account affectent uniquement la distribution.
Les options de réflexion et de verbosité sont conservées dans le stockage de session.
Sortie : texte brut par défaut, ou --json pour une charge utile structurée accompagnée de métadonnées.
Avec --json --deliver, le JSON inclut l’état de distribution des envois effectués, supprimés, partiels et ayant échoué. Consultez État de distribution JSON.

Exemples

bash

# Tour simple avec sortie JSONopenclaw agent --to +15555550123 --message "Trace logs" --verbose on --json # Tour avec remplacement du modèleopenclaw agent --agent ops --model openai/gpt-5.4 --message "Summarize logs" # Tour avec niveau de réflexionopenclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium # Invite multiligne depuis un fichieropenclaw agent --agent ops --message-file ./task.md # Clé de session exacteopenclaw agent --session-key agent:ops:incident-42 --message "Summarize status" # Ancienne clé limitée à un agentopenclaw agent --agent ops --session-key incident-42 --message "Summarize status" # Distribuer sur un canal différent de celui de la sessionopenclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"