openclaw agent запускает один ход агента из командной строки без
входящего сообщения чата. Используйте эту команду для сценарных рабочих процессов, тестирования и
программной доставки. Полное описание флагов и поведения:
Справочник по CLI агента.
Быстрый старт
1
Запустите простой ход агента
2
Отправьте многострочную инструкцию из файла
3
Укажите конкретного агента или сеанс
4
Доставьте ответ в канал
Флаги
Поведение
- По умолчанию 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.
Примеры
Связанные материалы
Справочник по CLI агента
Полное описание флагов и параметров
openclaw agent.Субагенты
Фоновый запуск субагентов.
Сеансы
Как работают ключи сеансов и как
--to, --agent и --session-id разрешают их.Команды с косой чертой
Каталог встроенных команд, используемых в сеансах агентов.