Envoi de l’agent

openclaw agent exécute un seul tour d’agent depuis la ligne de commande sans nécessiter de message de chat entrant. Utilisez-le pour les workflows scriptés, les tests et la livraison programmatique.

Démarrage rapide

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

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

# Target a specific agentopenclaw agent --agent ops --message "Summarize logs" # Target a phone number (derives session key)openclaw agent --to +15555550123 --message "Status update" # Reuse an existing sessionopenclaw agent --session-id abc123 --message "Continue the task" # Target an exact session keyopenclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

# Deliver to WhatsApp (default channel)openclaw agent --to +15555550123 --message "Report ready" --deliver # Deliver to Slackopenclaw agent --agent ops --message "Generate report" \  --deliver --reply-channel slack --reply-to "#reports"

Indicateurs

Comportement

• Par défaut, la CLI passe par le Gateway. Ajoutez --local pour forcer le runtime intégré sur la machine actuelle.
• Passez exactement l’un des deux : --message ou --message-file. Les messages issus de fichiers conservent le contenu multiligne après suppression d’un BOM UTF-8 facultatif.
• Si le Gateway est injoignable, la CLI se rabat sur l’exécution intégrée locale.
• Sélection de session : --to dérive la clé de session (les cibles de groupe/canal conservent l’isolation ; les chats directs se replient sur main).
• --session-key sélectionne une clé explicite. Les clés préfixées par agent doivent utiliser agent:<agent-id>:<session-key>, et --agent doit correspondre à cet id d’agent lorsque les deux sont fournis. Les clés nues non sentinelles sont limitées à --agent lorsqu’il est fourni ; par exemple, --agent ops --session-key incident-42 achemine vers agent:ops:incident-42. Sans --agent, les clés nues non sentinelles sont limitées à l’agent par défaut configuré. Les littéraux global et unknown restent sans portée uniquement lorsqu’aucun --agent n’est fourni ; dans ce cas, le repli intégré et la propriété du stockage utilisent l’agent par défaut configuré.
• Les indicateurs de réflexion et de verbosité persistent dans le stockage de session.
• Sortie : texte brut par défaut, ou --json pour une charge utile structurée + métadonnées.
• Avec --json --deliver, le JSON inclut l’état de livraison pour les envois effectués, supprimés, partiels et échoués. Consultez État de livraison JSON.

Exemples

# Simple turn with JSON outputopenclaw agent --to +15555550123 --message "Trace logs" --verbose on --json # Turn with thinking levelopenclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium # Multiline prompt from a fileopenclaw agent --agent ops --message-file ./task.md # Exact session keyopenclaw agent --session-key agent:ops:incident-42 --message "Summarize status" # Legacy key scoped to an agentopenclaw agent --agent ops --session-key incident-42 --message "Summarize status" # Deliver to a different channel than the sessionopenclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"

Connexe