Envoi de l’agent

​

Démarrage rapide

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

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

# Cibler un agent spécifique
openclaw 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 existante
openclaw agent --session-id abc123 --message "Continue the task"

# Cibler une clé de session exacte
openclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

# Distribuer sur WhatsApp (canal par défaut)
openclaw agent --to +15555550123 --message "Report ready" --deliver

# Distribuer sur Slack
openclaw agent --agent ops --message "Generate report" \
  --deliver --reply-channel slack --reply-to "#reports"

​

Options

​

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

# Tour simple avec sortie JSON
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json

# Tour avec remplacement du modèle
openclaw agent --agent ops --model openai/gpt-5.4 --message "Summarize logs"

# Tour avec niveau de réflexion
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium

# Invite multiligne depuis un fichier
openclaw agent --agent ops --message-file ./task.md

# Clé de session exacte
openclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

# Ancienne clé limitée à un agent
openclaw agent --agent ops --session-key incident-42 --message "Summarize status"

# Distribuer sur un canal différent de celui de la session
openclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"

​

Rubriques connexes