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

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

1

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

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

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

Считывает корректный файл UTF-8 как тело сообщения агента.
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 --deliver JSON содержит статус доставки для отправленных, подавленных, частично отправленных и неудачных отправок. См. Статус доставки JSON.

Примеры

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

Справочник по CLI агента

Полное описание флагов и параметров openclaw agent.

Субагенты

Фоновый запуск субагентов.

Сеансы

Как работают ключи сеансов и как --to, --agent и --session-id разрешают их.

Команды с косой чертой

Каталог встроенных команд, используемых в сеансах агентов.