---
read_when:
    - Вы хотите запускать агентов из скриптов или командной строки
    - Вам нужно программно доставлять ответы агента в канал чата
summary: Запускайте циклы агента из CLI и при необходимости отправляйте ответы в каналы
title: Отправка агента
x-i18n:
    generated_at: "2026-07-13T18:41:05Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 24
    provider: openai
    source_hash: 23ad57735bd43a2bba5add571e9572da0fbe7b516a70515c674e1ababaab081a
    source_path: tools/agent-send.md
    workflow: 16
---

`openclaw agent` запускает один ход агента из командной строки без
входящего сообщения чата. Используйте эту команду для сценарных рабочих процессов, тестирования и
программной доставки. Полное описание флагов и поведения:
[Справочник по CLI агента](/ru/cli/agent).

## Быстрый старт

<Steps>
  <Step title="Запустите простой ход агента">
    ```bash
    openclaw agent --agent main --message "Какая сегодня погода?"
    ```

    Отправляет сообщение через Gateway и выводит ответ.

  </Step>

  <Step title="Отправьте многострочную инструкцию из файла">
    ```bash
    openclaw agent --agent ops --message-file ./task.md
    ```

    Считывает корректный файл UTF-8 как тело сообщения агента.

  </Step>

  <Step title="Укажите конкретного агента или сеанс">
    ```bash
    # Указать конкретного агента
    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 "Суммируй статус"
    ```

  </Step>

  <Step title="Доставьте ответ в канал">
    ```bash
    # Доставить в WhatsApp (канал по умолчанию)
    openclaw agent --to +15555550123 --message "Отчёт готов" --deliver

    # Доставить в Slack
    openclaw agent --agent ops --message "Сформируй отчёт" \
      --deliver --reply-channel slack --reply-to "#reports"
    ```

  </Step>
</Steps>

## Флаги

| Флаг                        | Описание                                                          |
| --------------------------- | -------------------------------------------------------------------- |
| `--message <text>`          | Встроенное сообщение для отправки                                               |
| `--message-file <path>`     | Считать сообщение из корректного файла UTF-8                             |
| `--to <dest>`               | Сформировать ключ сеанса из адресата (телефона, идентификатора чата)                    |
| `--session-key <key>`       | Использовать явный ключ сеанса                                          |
| `--agent <id>`              | Указать настроенного агента (используется его сеанс `main`)                  |
| `--session-id <id>`         | Повторно использовать существующий сеанс по идентификатору                                      |
| `--model <id>`              | Переопределение модели для этого запуска (`provider/model` или идентификатор модели)           |
| `--local`                   | Принудительно использовать локальную встроенную среду выполнения (пропустить Gateway)                          |
| `--deliver`                 | Отправить ответ в канал чата                                     |
| `--channel <name>`          | Канал доставки; вместе с `--agent` + `--to` также применяется к области личных сообщений     |
| `--reply-to <target>`       | Переопределение адресата доставки                                             |
| `--reply-channel <name>`    | Переопределение канала доставки                                            |
| `--reply-account <id>`      | Переопределение идентификатора учётной записи доставки                                         |
| `--thinking <level>`        | Задать уровень рассуждений для выбранного профиля модели                    |
| `--verbose <on\|full\|off>` | Сохранить уровень подробности для сеанса (`full` также записывает вывод инструментов в журнал) |
| `--timeout <seconds>`       | Переопределить время ожидания агента (по умолчанию 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-id>:<session-key>`, а `--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](/ru/cli/agent#json-delivery-status).

## Примеры

```bash
# Простой ход с выводом 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"
```

## Связанные материалы

<CardGroup cols={2}>
  <Card title="Справочник по CLI агента" href="/ru/cli/agent" icon="terminal">
    Полное описание флагов и параметров `openclaw agent`.
  </Card>
  <Card title="Субагенты" href="/ru/tools/subagents" icon="users">
    Фоновый запуск субагентов.
  </Card>
  <Card title="Сеансы" href="/ru/concepts/session" icon="comments">
    Как работают ключи сеансов и как `--to`, `--agent` и `--session-id` разрешают их.
  </Card>
  <Card title="Команды с косой чертой" href="/ru/tools/slash-commands" icon="slash">
    Каталог встроенных команд, используемых в сеансах агентов.
  </Card>
</CardGroup>