Envio do agente

​

Início rápido

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

openclaw agent --agent ops --message-file ./task.md

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

# Target an exact session key
openclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

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

​

Opções

​

Comportamento

• Por padrão, a CLI passa pelo Gateway. Adicione --local para forçar o ambiente de execução incorporado na máquina atual.
• Passe exatamente uma das opções --message ou --message-file. As mensagens de arquivo preservam o conteúdo multilinha após remover um BOM UTF-8 opcional.
• Se a solicitação ao Gateway falhar, a CLI recorre à execução incorporada local; um tempo limite do Gateway recorre a uma nova sessão, em vez de disputar com a transcrição original.
• Seleção de sessão: --to deriva a chave de sessão (destinos de grupo/canal preservam o isolamento; chats diretos são consolidados em main). Quando --agent, --channel e --to são usados em conjunto, o roteamento segue o destinatário canônico do canal e session.dmScope. Identidades estáveis usadas apenas para envio utilizam uma sessão pertencente ao provedor, isolada da sessão principal do agente.
• --session-key seleciona uma chave explícita. Chaves prefixadas por agente devem usar agent:<agent-id>:<session-key>, e --agent deve corresponder ao ID desse agente quando ambos forem fornecidos. Chaves simples que não sejam sentinelas são associadas ao escopo de --agent quando ele é fornecido; por exemplo, --agent ops --session-key incident-42 direciona para agent:ops:incident-42. Sem --agent, chaves simples que não sejam sentinelas são associadas ao escopo do agente padrão configurado. Os valores literais global e unknown permanecem sem escopo somente quando nenhum --agent é fornecido; o caminho de contingência incorporado resolve essas sessões sentinelas para o agente padrão configurado.
• --reply-channel e --reply-account afetam somente a entrega.
• As opções de raciocínio e detalhamento persistem no armazenamento da sessão.
• Saída: texto simples por padrão ou --json para carga estruturada + metadados.
• Com --json --deliver, o JSON inclui o status de entrega de envios realizados, suprimidos, parciais e com falha. Consulte Status de entrega em JSON.

​

Exemplos

# Simple turn with JSON output
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json

# Turn with a model override
openclaw agent --agent ops --model openai/gpt-5.4 --message "Summarize logs"

# Turn with thinking level
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium

# Multiline prompt from a file
openclaw agent --agent ops --message-file ./task.md

# Exact session key
openclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

# Legacy key scoped to an agent
openclaw agent --agent ops --session-key incident-42 --message "Summarize status"

# Deliver to a different channel than the session
openclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"

​

Relacionados