> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Envoi d’agent

# `openclaw agent` (executions directes de l’agent)

`openclaw agent` execute un seul tour d’agent sans necessiter de message de chat entrant.
Par defaut, il passe **par la Gateway (passerelle)** ; ajoutez `--local` pour forcer le
runtime integre sur la machine courante.

## Comportement

* Requis : `--message <text>`
* Selection de session :
  * `--to <dest>` derive la cle de session (les cibles groupe/canal preservent l’isolation ; les discussions directes se regroupent en `main`), **ou**
  * `--session-id <id>` reutilise une session existante par identifiant, **ou**
  * `--agent <id>` cible directement un agent configure (utilise la cle de session `main` de cet agent)
* Execute le meme runtime d’agent integre que les reponses entrantes normales.
* Les indicateurs de raisonnement/verbeux persistent dans le stockage de session.
* Sortie :
  * par defaut : affiche le texte de reponse (ainsi que les lignes `MEDIA:<url>`)
  * `--json` : affiche la charge utile structuree + les metadonnees
* Livraison optionnelle vers un canal avec `--deliver` + `--channel` (les formats de cible correspondent a `openclaw message --target`).
* Utilisez `--reply-channel`/`--reply-to`/`--reply-account` pour remplacer la livraison sans modifier la session.

Si la Gateway (passerelle) est inaccessible, le CLI **bascule** vers l’execution locale integree.

## Exemples

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw agent --to +15555550123 --message "status update"
openclaw agent --agent ops --message "Summarize logs"
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json
openclaw agent --to +15555550123 --message "Summon reply" --deliver
openclaw agent --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"
```

## Drapeaux

* `--local` : execution locale (necessite les cles API du fournisseur de modele dans votre shell)
* `--deliver` : envoyer la reponse vers le canal choisi
* `--channel` : canal de livraison (`whatsapp|telegram|discord|googlechat|slack|signal|imessage`, par defaut : `whatsapp`)
* `--reply-to` : remplacement de la cible de livraison
* `--reply-channel` : remplacement du canal de livraison
* `--reply-account` : remplacement de l’identifiant de compte de livraison
* `--thinking <off|minimal|low|medium|high|xhigh>` : persister le niveau de raisonnement (modeles GPT-5.2 + Codex uniquement)
* `--verbose <on|full|off>` : persister le niveau verbeux
* `--timeout <seconds>` : remplacer le delai d’expiration de l’agent
* `--json` : sortie JSON structuree