Envoi d'agent

openclaw agent exécute un seul tour d’agent à partir de 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 programmatique.

Quick start

1. Exécuter un tour d'agent simple

   openclaw agent --agent main --message "What is the weather today?"
   ```Gateway
   
   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"
   
   # Target an exact session key
   openclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

3. Envoyer 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"

Flags

Flag	Description
--message \<text\>	Message à envoyer (requis)
--to \<dest\>	Dériver la clé de session à partir d’une cible (téléphone, id de chat)
--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 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 pour le profil de modèle sélectionné
--verbose \<on|full|off\>	Définir le niveau de verbosité
--timeout \<seconds\>	Remplacer le délai d’expiration de l’agent
--json	Sortie JSON structurée

Comportement

• Par défaut, le CLI passe par le Gateway. Ajoutez CLIGateway--local pour forcer l’exécution intégrée sur la machine actuelle.
• Si le Gateway est inaccessible, le CLI revient à l’exécution locale intégrée.
• Sélection de session : --to dérive la clé de session (les cibles de groupe/channel préservent l’isolement ; les chats directs s’effondrent vers 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 lorsque fournies ; 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 chaînes littérales global et unknown restent non limitées uniquement lorsqu’aucun --agent n’est fourni ; dans ce cas, le repli intégré et la propriété du magasin utilisent l’agent par défaut configuré.
• Les indicateurs de réflexion (thinking) et de mode verbeux (verbose) sont conservés dans le magasin de session.
• Sortie : texte brut par défaut, ou --json pour la charge utile structurée + métadonnées.
• Avec --json --deliver, le JSON inclut le statut de livraison pour les envois envoyés, supprimés, partiels et échoués. Voir Statut de livraison JSON.

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

# Exact session key
openclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

# Legacy key scoped to an agent
openclaw agent --agent ops --session-key incident-42 --message "Summarize status"

# 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

Référence complète des indicateurs et options openclaw agent.

Sous-agents

Génération de sous-agents en arrière-plan.

Sessions

Fonctionnement des clés de session et résolution de celles-ci par --to, --agent et --session-id.

Commandes slash

Catalogue de commandes natives utilisé dans les sessions d’agent.