Agent Send

Agent Send

openclaw agent exécute un seul tour d’agent depuis la ligne de commande sans avoir besoin d’un message de chat entrant. Utilisez-le pour les flux de travail scriptés, les tests et la livraison programmée.

Quick start

1. Exécuter un tour d'agent simple

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

   Cela envoie le message via le Gateway et imprime la réponse.

2. Cibler un agent ou une session spécifique

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

3. Livrer la réponse à un channel

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

Drapeaux

Drapeau	Description
--message \<text\>	Message à envoyer (requis)
--to \<dest\>	Dériver la clé de session à partir d’une cible (téléphone, id de chat)
--agent \<id\>	Cibler un agent configuré (utilise sa session main)
--session-id \<id\>	Réutiliser une session existante par id
--local	Forcer l’exécution locale intégrée (ignorer le Gateway)
--deliver	Envoyer la réponse à un channel de chat
--channel \<name\>	Channel de livraison (whatsapp, telegram, discord, slack, etc.)
--reply-to \<target\>	Remplacement de la cible de livraison
--reply-channel \<name\>	Remplacement du channel de livraison
--reply-account \<id\>	Remplacement de l’id de compte de livraison
--thinking \<level\>	Définir le niveau de réflexion (off, minimal, low, medium, high, xhigh)
--verbose \<on|full|off\>	Définir le niveau de verbosité
--timeout \<seconds\>	Remplacer le délai d’attente de l’agent
--json	Sortie JSON structurée

Comportement

• Par défaut, le CLI passe via le Gateway. Ajoutez --local pour forcer l’ runtime intégré sur la machine actuelle.
• Si le Gateway est inaccessible, le CLI revient à l’exécution intégrée locale.
• Sélection de session : --to dérive la clé de session (les cibles de groupe/channel préservent l’isolement ; les discussions directes sont réduites à main).
• Les indicateurs de réflexion et de mode détaillé (verbose) sont conservés dans le magasin de session.
• Sortie : texte brut par défaut, ou --json pour une charge utile structurée + métadonnées.

Exemples

# Simple turn with JSON output
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json

# Turn with thinking level
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium

# Deliver to a different channel than the session
openclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"

Connexes

• Référence de l’agent CLI
• Sous-agents — génération de sous-agents en arrière-plan
• Sessions — fonctionnement des clés de session