Agent coordination

Agent senden

openclaw agent führt eine einzelne Agent-Ausführung über die Befehlszeile aus, ohne dass eine eingehende Chatnachricht erforderlich ist. Verwenden Sie es für skriptgesteuerte Workflows, Tests und programmatische Zustellung.

Schnellstart

  • Einfache Agent-Ausführung starten

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

    Dadurch wird die Nachricht über das Gateway gesendet und die Antwort ausgegeben.

  • Bestimmten Agent oder bestimmte Sitzung ansteuern

    # 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"
    
  • Antwort an einen Kanal zustellen

    # 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 Beschreibung
    --message \<text\> Zu sendende Nachricht (erforderlich)
    --to \<dest\> Sitzungsschlüssel aus einem Ziel ableiten (Telefon, Chat-ID)
    --agent \<id\> Konfigurierten Agent ansteuern (verwendet dessen main-Sitzung)
    --session-id \<id\> Vorhandene Sitzung anhand der ID wiederverwenden
    --local Lokale eingebettete Laufzeit erzwingen (Gateway überspringen)
    --deliver Antwort an einen Chatkanal senden
    --channel \<name\> Zustellungskanal (whatsapp, telegram, discord, slack usw.)
    --reply-to \<target\> Zustellungsziel überschreiben
    --reply-channel \<name\> Zustellungskanal überschreiben
    --reply-account \<id\> ID des Zustellungskontos überschreiben
    --thinking \<level\> Denkstufe für das ausgewählte Modellprofil festlegen
    --verbose \<on|full|off\> Ausführlichkeitsstufe festlegen
    --timeout \<seconds\> Agent-Timeout überschreiben
    --json Strukturiertes JSON ausgeben

    Verhalten

    • Standardmäßig läuft die CLI über das Gateway. Fügen Sie --local hinzu, um die eingebettete Laufzeit auf dem aktuellen Rechner zu erzwingen.
    • Wenn das Gateway nicht erreichbar ist, fällt die CLI auf die lokale eingebettete Ausführung zurück.
    • Sitzungsauswahl: --to leitet den Sitzungsschlüssel ab (Gruppen-/Kanalziele behalten die Isolation bei; direkte Chats werden auf main zusammengeführt).
    • Thinking- und Verbose-Flags werden im Sitzungsspeicher beibehalten.
    • Ausgabe: standardmäßig Nur-Text oder --json für strukturierte Nutzdaten und Metadaten.

    Beispiele

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

    Verwandte Themen