На этой странице
На этой странице
Agent coordination
Отправка агента
openclaw agent запускает один ход агента из командной строки без
входящего сообщения чата. Используйте эту команду для сценарных рабочих процессов, тестирования и
программной доставки. Полное описание флагов и поведения:
Справочник по CLI агента.
Быстрый старт
Запустите простой ход агента
Отправляет сообщение через Gateway и выводит ответ.
Отправьте многострочную инструкцию из файла
Считывает корректный файл UTF-8 как тело сообщения агента.
Укажите конкретного агента или сеанс
Доставьте ответ в канал
Флаги
| Флаг | Описание |
|---|---|
--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 --deliverJSON содержит статус доставки для отправленных, подавленных, частично отправленных и неудачных отправок. См. Статус доставки JSON.
Примеры
Связанные материалы
Was this useful?