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 fluxos de trabalho com scripts, testes e entrega programática.

Início rápido

Run a simple agent turn

bash

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

Isso envia a mensagem pelo Gateway e imprime a resposta.

Send a multiline prompt from a file

bash

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

Isso lê um arquivo UTF-8 válido como o corpo da mensagem do agente.

Target a specific agent or session

bash

# Target a specific agentopenclaw agent --agent ops --message "Summarize logs" # Target a phone number (derives session key)openclaw agent --to +15555550123 --message "Status update" # Reuse an existing sessionopenclaw agent --session-id abc123 --message "Continue the task" # Target an exact session keyopenclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

Deliver the reply to a channel

bash

# Deliver to WhatsApp (default channel)openclaw agent --to +15555550123 --message "Report ready" --deliver # Deliver to Slackopenclaw agent --agent ops --message "Generate report" \  --deliver --reply-channel slack --reply-to "#reports"

Flags

Flag	Descrição
`--message \<text\>`	Mensagem inline a enviar
`--message-file \<path\>`	Lê a mensagem de um arquivo UTF-8 válido
`--to \<dest\>`	Deriva a chave de sessão de um destino (telefone, id de chat)
`--session-key \<key\>`	Usa uma chave de sessão explícita
`--agent \<id\>`	Direciona para um agente configurado (usa sua sessão `main`)
`--session-id \<id\>`	Reutiliza uma sessão existente por id
`--local`	Força o runtime local embutido (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 verboso
`--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 embutido na máquina atual.
Passe exatamente um de --message ou --message-file. Mensagens de arquivo preservam conteúdo de várias linhas após remover um BOM UTF-8 opcional.
Se o Gateway estiver inacessível, a CLI recorre à execução local embutida.
Seleção de sessão: --to deriva a chave de sessão (destinos de grupo/canal preservam o isolamento; chats diretos convergem para main).
--session-key seleciona uma chave explícita. Chaves com prefixo de agente devem usar agent:<agent-id>:<session-key>, e --agent deve corresponder a esse id de agente quando ambos forem fornecidos. Chaves sem sentinela explícita recebem escopo de --agent quando fornecido; por exemplo, --agent ops --session-key incident-42 roteia para agent:ops:incident-42. Sem --agent, chaves sem sentinela explícita recebem escopo do agente padrão configurado. Literais global e unknown permanecem sem escopo apenas quando nenhum --agent é fornecido; nesse caso, o fallback embutido e a propriedade do armazenamento usam o agente padrão configurado.
Flags de raciocínio e verbosidade persistem no armazenamento da sessão.
Saída: texto simples por padrão, ou --json para payload estruturado + metadados.
Com --json --deliver, o JSON inclui o status de entrega para envios enviados, suprimidos, parciais e com falha. Veja status de entrega JSON.

Exemplos

bash

# Simple turn with JSON outputopenclaw agent --to +15555550123 --message "Trace logs" --verbose on --json # Turn with thinking levelopenclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium # Multiline prompt from a fileopenclaw agent --agent ops --message-file ./task.md # Exact session keyopenclaw agent --session-key agent:ops:incident-42 --message "Summarize status" # Legacy key scoped to an agentopenclaw agent --agent ops --session-key incident-42 --message "Summarize status" # Deliver to a different channel than the sessionopenclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"