Agent coordination

Envio do agente

openclaw agent executa um único turno do agente pela linha de comando sem uma mensagem de chat recebida. Use-o para fluxos de trabalho com scripts, testes e entrega programática. Referência completa de opções e comportamento: Referência da CLI do agente.

Início rápido

Run a simple agent turn

bash

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

Envia a mensagem pelo Gateway e exibe a resposta.

Send a multiline prompt from a file

bash

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

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"

Opções

Opção	Descrição
`--message <text>`	Mensagem em linha a ser enviada
`--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 do chat)
`--session-key <key>`	Usa uma chave de sessão explícita
`--agent <id>`	Direciona a um agente configurado (usa sua sessão `main`)
`--session-id <id>`	Reutiliza uma sessão existente pelo ID
`--model <id>`	Substitui o modelo nesta execução (`provider/model` ou ID do modelo)
`--local`	Força o ambiente de execução incorporado local (ignora o Gateway)
`--deliver`	Envia a resposta para um canal de chat
`--channel <name>`	Canal de entrega; com `--agent` + `--to`, também se aplica ao escopo de MD
`--reply-to <target>`	Substitui o destino da entrega
`--reply-channel <name>`	Substitui o canal de entrega
`--reply-account <id>`	Substitui o ID da conta de entrega
`--thinking <level>`	Define o nível de raciocínio do perfil de modelo selecionado
`--verbose <on\|full\|off>`	Persiste o nível de detalhamento da sessão (`full` também registra a saída das ferramentas)
`--timeout <seconds>`	Substitui o tempo limite do agente (padrão: 600 ou o valor da configuração)
`--json`	Produz JSON estruturado

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

bash

# Simple turn with JSON outputopenclaw agent --to +15555550123 --message "Trace logs" --verbose on --json # Turn with a model overrideopenclaw agent --agent ops --model openai/gpt-5.4 --message "Summarize logs" # 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"