# Agent Send Documentation

## Overview

The `openclaw agent` command executes a single agent turn without requiring an inbound chat message. It runs through the Gateway by default; add `--local` to force the embedded runtime on the current machine.

## Key Capabilities

**Session Management:**
The command supports three approaches for session selection: targeting via `--to`, reusing existing sessions with `--session-id`, or directly addressing configured agents using `--agent`.

**Output Formats:**
By default, the command prints reply text and media URLs. Using `--json` flag generates structured payload with metadata instead.

**Delivery Options:**
Optional delivery back to a channel with `--deliver` + `--channel` enables routing responses to WhatsApp, Telegram, Discord, Google Chat, Slack, Signal, or iMessage.

## Notable Flags

The command supports thinking levels (`off|minimal|low|medium|high|xhigh`), verbose output control, custom timeouts, and fallback behavior: If the Gateway is unreachable, the CLI falls back to the embedded local run.

## Practical Usage

Common scenarios include status updates to contacts, log summarization for specific agents, and inbox analysis within existing sessions—all executable from the command line with optional message delivery to configured channels.
