English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Agent coordination

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

  • Run a simple agent turn

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

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

  • Target a specific agent or session

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

  • Deliver the reply to a 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"

    • Options

    Option Description
    --message \<text\> Message à envoyer (obligatoire)
    --to \<dest\> Déduire la clé de session à partir d’une cible (téléphone, identifiant de chat)
    --agent \<id\> Cibler un agent configuré (utilise sa session main)
    --session-id \<id\> Réutiliser une session existante par identifiant
    --local Forcer l’environnement d’exécution intégré local (ignorer le Gateway)
    --deliver Envoyer la réponse à un canal de chat
    --channel \<name\> Canal de livraison (whatsapp, telegram, discord, slack, etc.)
    --reply-to \<target\> Remplacement de la cible de livraison
    --reply-channel \<name\> Remplacement du canal de livraison
    --reply-account \<id\> Remplacement de l’identifiant du 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 Produire du JSON structuré

    Comportement

    • Par défaut, la CLI passe par le Gateway. Ajoutez --local pour forcer l’environnement d’exécution intégré sur la machine actuelle.
    • Si le Gateway est inaccessible, la CLI revient à l’exécution intégrée locale.
    • Sélection de session : --to déduit la clé de session (les cibles de groupe/canal préservent l’isolation ; les chats directs se replient sur main).
    • Les options 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

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

    Associé

    Agent CLI reference

    Référence complète des options et paramètres de openclaw agent.
    Sub-agents

    Création de sous-agents en arrière-plan.
    Sessions

    Fonctionnement des clés de session et résolution de --to, --agent et --session-id.
    Slash commands

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