> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Отправка агента `openclaw agent` запускает один ход агента из командной строки без входящего сообщения чата. Используйте эту команду для сценарных рабочих процессов, тестирования и программной доставки. Полное описание флагов и поведения: [Справочник по CLI агента](https://docs2.openclaw.ai/ru/cli/agent.md). ## Быстрый старт **1. Запустите простой ход агента** ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw agent --agent main --message "Какая сегодня погода?" ``` Отправляет сообщение через Gateway и выводит ответ. **2. Отправьте многострочную инструкцию из файла** ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw agent --agent ops --message-file ./task.md ``` Считывает корректный файл UTF-8 как тело сообщения агента. **3. Укажите конкретного агента или сеанс** ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # Указать конкретного агента openclaw agent --agent ops --message "Суммируй журналы" # Указать номер телефона (ключ сеанса формируется автоматически) openclaw agent --to +15555550123 --message "Обновление статуса" # Повторно использовать существующий сеанс openclaw agent --session-id abc123 --message "Продолжи задачу" # Указать точный ключ сеанса openclaw agent --session-key agent:ops:incident-42 --message "Суммируй статус" ``` **4. Доставьте ответ в канал** ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # Доставить в WhatsApp (канал по умолчанию) openclaw agent --to +15555550123 --message "Отчёт готов" --deliver # Доставить в Slack openclaw agent --agent ops --message "Сформируй отчёт" \ --deliver --reply-channel slack --reply-to "#reports" ``` ## Флаги | Флаг | Описание | | - | - | | `--message ` | Встроенное сообщение для отправки | | `--message-file ` | Считать сообщение из корректного файла UTF-8 | | `--to ` | Сформировать ключ сеанса из адресата (телефона, идентификатора чата) | | `--session-key ` | Использовать явный ключ сеанса | | `--agent ` | Указать настроенного агента (используется его сеанс `main`) | | `--session-id ` | Повторно использовать существующий сеанс по идентификатору | | `--model ` | Переопределение модели для этого запуска (`provider/model` или идентификатор модели) | | `--local` | Принудительно использовать локальную встроенную среду выполнения (пропустить Gateway) | | `--deliver` | Отправить ответ в канал чата | | `--channel ` | Канал доставки; вместе с `--agent` + `--to` также применяется к области личных сообщений | | `--reply-to ` | Переопределение адресата доставки | | `--reply-channel ` | Переопределение канала доставки | | `--reply-account ` | Переопределение идентификатора учётной записи доставки | | `--thinking ` | Задать уровень рассуждений для выбранного профиля модели | | `--verbose ` | Сохранить уровень подробности для сеанса (`full` также записывает вывод инструментов в журнал) | | `--timeout ` | Переопределить время ожидания агента (по умолчанию 600 или значение конфигурации) | | `--json` | Вывести структурированный JSON | ## Поведение * По умолчанию CLI работает **через Gateway**. Добавьте `--local`, чтобы принудительно использовать встроенную среду выполнения на текущем компьютере. * Передайте ровно один из параметров: `--message` или `--message-file`. Сообщения из файлов сохраняют многострочное содержимое после удаления необязательной метки BOM UTF-8. * Если запрос к Gateway завершается ошибкой, CLI **переходит** к локальному встроенному запуску; при превышении времени ожидания Gateway переход выполняется с новым сеансом, а не параллельно с исходным журналом диалога. * Выбор сеанса: `--to` формирует ключ сеанса (адресаты групп и каналов сохраняют изоляцию; личные чаты сводятся к `main`). При совместном использовании `--agent`, `--channel` и `--to` маршрутизация следует каноническому адресату канала и `session.dmScope`. Для стабильных идентификаторов, используемых только для исходящих сообщений, применяется принадлежащий провайдеру сеанс, изолированный от основного сеанса агента. * `--session-key` выбирает явный ключ. Ключи с префиксом агента должны использовать `agent::`, а `--agent` должен соответствовать этому идентификатору агента, если указаны оба параметра. Простые ключи, не являющиеся служебными, относятся к области `--agent`, если он указан; например, `--agent ops --session-key incident-42` направляется в `agent:ops:incident-42`. Без `--agent` простые ключи, не являющиеся служебными, относятся к области настроенного агента по умолчанию. Литеральные `global` и `unknown` остаются без области только тогда, когда не указан `--agent`; путь перехода к встроенной среде выполнения связывает эти служебные сеансы с настроенным агентом по умолчанию. * `--reply-channel` и `--reply-account` влияют только на доставку. * Флаги рассуждений и подробности сохраняются в хранилище сеансов. * Вывод: по умолчанию обычный текст или `--json` для структурированных данных и метаданных. * При использовании `--json --deliver` JSON содержит статус доставки для отправленных, подавленных, частично отправленных и неудачных отправок. См. [Статус доставки JSON](https://docs2.openclaw.ai/ru/cli/agent.md#json-delivery-status). ## Примеры ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # Простой ход с выводом JSON openclaw agent --to +15555550123 --message "Проанализируй журналы" --verbose on --json # Ход с переопределением модели openclaw agent --agent ops --model openai/gpt-5.4 --message "Суммируй журналы" # Ход с уровнем рассуждений openclaw agent --session-id 1234 --message "Суммируй входящие сообщения" --thinking medium # Многострочная инструкция из файла openclaw agent --agent ops --message-file ./task.md # Точный ключ сеанса openclaw agent --session-key agent:ops:incident-42 --message "Суммируй статус" # Устаревший ключ в области агента openclaw agent --agent ops --session-key incident-42 --message "Суммируй статус" # Доставить в канал, отличный от канала сеанса openclaw agent --agent ops --message "Предупреждение" --deliver --reply-channel telegram --reply-to "@admin" ``` ## Связанные материалы > [card] [Справочник по CLI агента](https://docs2.openclaw.ai/ru/cli/agent.md) > > Полное описание флагов и параметров `openclaw agent`. > [card] [Субагенты](https://docs2.openclaw.ai/ru/tools/subagents.md) > > Фоновый запуск субагентов. > [card] [Сеансы](https://docs2.openclaw.ai/ru/concepts/session.md) > > Как работают ключи сеансов и как `--to`, `--agent` и `--session-id` разрешают их. > [card] [Команды с косой чертой](https://docs2.openclaw.ai/ru/tools/slash-commands.md) > > Каталог встроенных команд, используемых в сеансах агентов.