Agent coordination

Отправка агента

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

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

Запустите простой ход агента

bash

openclaw agent --agent main --message "Какая сегодня погода?"

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

Отправьте многострочную инструкцию из файла

bash

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

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

Укажите конкретного агента или сеанс

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 "Суммируй статус"

Доставьте ответ в канал

bash

# Доставить в WhatsApp (канал по умолчанию)openclaw agent --to +15555550123 --message "Отчёт готов" --deliver # Доставить в Slackopenclaw agent --agent ops --message "Сформируй отчёт" \  --deliver --reply-channel slack --reply-to "#reports"

Флаги

Флаг	Описание
`--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.

Примеры

bash

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