Passer au contenu principal

​
Envoi d’agent

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

​
Démarrage rapide

1

Exécuter un tour d'agent simple

openclaw agent --message "What is the weather today?"
Cela envoie le message via la Gateway et affiche la réponse.
2

Cibler un agent ou une session spécifique

# 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"
3

Distribuer la réponse vers un canal

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

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

​
Drapeaux

FlagDescription
--message \<text\>Message à envoyer (obligatoire)
--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
--localForcer le runtime embarqué local (ignorer la Gateway)
--deliverEnvoyer la réponse vers un canal de discussion
--channel \<name\>Canal de distribution (whatsapp, telegram, discord, slack, etc.)
--reply-to \<target\>Remplacement de la cible de distribution
--reply-channel \<name\>Remplacement du canal de distribution
--reply-account \<id\>Remplacement de l’id du compte de distribution
--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’expiration de l’agent
--jsonProduire du JSON structuré

​
Comportement

  • Par défaut, la CLI passe par la Gateway. Ajoutez --local pour forcer le runtime embarqué sur la machine actuelle.
  • Si la Gateway est inaccessible, la CLI bascule sur l’exécution embarquée locale.
  • Sélection de session : --to dérive la clé de session (les cibles de groupe/canal préservent l’isolation ; les discussions directes sont ramenées à main).
  • Les drapeaux 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.

​
Exemples

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

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

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

​
Liens associés