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

Agent coordination

Envio do agente

openclaw agent executa um único turno de agente pela linha de comando sem precisar de uma mensagem de chat de entrada. Use-o para workflows com scripts, testes e entrega programática.

Início rápido

  • Run a simple agent turn

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

    Isso envia a mensagem pelo Gateway e imprime a resposta.

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

    • Flags

    Flag Descrição
    --message \<text\> Mensagem a enviar (obrigatório)
    --to \<dest\> Deriva a chave de sessão de um destino (telefone, id do chat)
    --agent \<id\> Direciona para um agente configurado (usa a sessão main dele)
    --session-id \<id\> Reutiliza uma sessão existente por id
    --local Força o runtime incorporado local (ignora o Gateway)
    --deliver Envia a resposta para um canal de chat
    --channel \<name\> Canal de entrega (whatsapp, telegram, discord, slack etc.)
    --reply-to \<target\> Substituição do destino de entrega
    --reply-channel \<name\> Substituição do canal de entrega
    --reply-account \<id\> Substituição do id da conta de entrega
    --thinking \<level\> Define o nível de raciocínio para o perfil de modelo selecionado
    --verbose \<on|full|off\> Define o nível de detalhamento
    --timeout \<seconds\> Substitui o timeout do agente
    --json Gera JSON estruturado

    Comportamento

    • Por padrão, a CLI passa pelo Gateway. Adicione --local para forçar o runtime incorporado na máquina atual.
    • Se o Gateway estiver inacessível, a CLI recorre à execução incorporada local.
    • Seleção de sessão: --to deriva a chave de sessão (destinos de grupo/canal preservam o isolamento; chats diretos convergem para main).
    • As flags de raciocínio e detalhamento persistem no armazenamento da sessão.
    • Saída: texto simples por padrão, ou --json para payload estruturado + metadados.

    Exemplos

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

    Relacionado

    Agent CLI reference

    Referência completa de flags e opções de openclaw agent.
    Sub-agents

    Geração de subagentes em segundo plano.
    Sessions

    Como as chaves de sessão funcionam e como --to, --agent e --session-id as resolvem.
    Slash commands

    Catálogo de comandos nativos usado dentro das sessões de agente.