Agent coordination

Надсилання агентом

openclaw agent запускає один хід агента з командного рядка без потреби у вхідному повідомленні чату. Використовуйте його для скриптових робочих процесів, тестування та програмної доставки.

Швидкий старт

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

bash

openclaw agent --agent main --message "What is the weather today?"

Це надсилає повідомлення через Gateway і виводить відповідь.

Надішліть багаторядковий prompt із файлу

bash

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

Це читає чинний UTF-8 файл як тіло повідомлення агента.

Спрямуйте на конкретного агента або сесію

bash

# Target a specific agentopenclaw agent --agent ops --message "Summarize logs" # Target a phone number (derives session key)openclaw agent --to +15555550123 --message "Status update" # Reuse an existing sessionopenclaw agent --session-id abc123 --message "Continue the task" # Target an exact session keyopenclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

Доставте відповідь у канал

bash

# Deliver to WhatsApp (default channel)openclaw agent --to +15555550123 --message "Report ready" --deliver # Deliver to Slackopenclaw agent --agent ops --message "Generate report" \  --deliver --reply-channel slack --reply-to "#reports"

Прапорці

Прапорець	Опис
`--message \<text\>`	Вбудоване повідомлення для надсилання
`--message-file \<path\>`	Прочитати повідомлення з чинного UTF-8 файлу
`--to \<dest\>`	Вивести ключ сесії з цілі (телефон, id чату)
`--session-key \<key\>`	Використати явний ключ сесії
`--agent \<id\>`	Спрямувати на налаштованого агента (використовує його сесію `main`)
`--session-id \<id\>`	Повторно використати наявну сесію за id
`--local`	Примусово використати локальний вбудований runtime (пропустити Gateway)
`--deliver`	Надіслати відповідь у канал чату
`--channel \<name\>`	Канал доставки (whatsapp, telegram, discord, slack тощо)
`--reply-to \<target\>`	Перевизначення цілі доставки
`--reply-channel \<name\>`	Перевизначення каналу доставки
`--reply-account \<id\>`	Перевизначення id облікового запису доставки
`--thinking \<level\>`	Установити рівень міркування для вибраного профілю моделі
`--verbose \<on\|full\|off\>`	Установити рівень докладності
`--timeout \<seconds\>`	Перевизначити timeout агента
`--json`	Вивести структурований JSON

Поведінка

За замовчуванням CLI проходить через Gateway. Додайте --local, щоб примусово використати вбудований runtime на поточній машині.
Передайте рівно один із --message або --message-file. Файлові повідомлення зберігають багаторядковий вміст після видалення необов’язкового UTF-8 BOM.
Якщо Gateway недоступний, CLI повертається до локального вбудованого запуску.
Вибір сесії: --to виводить ключ сесії (цілі груп/каналів зберігають ізоляцію; прямі чати згортаються до main).
--session-key вибирає явний ключ. Ключі з префіксом агента мають використовувати agent:<agent-id>:<session-key>, а --agent має збігатися з цим agent id, коли вказано обидва. Голі ключі без sentinel прив’язуються до --agent, коли його вказано; наприклад, --agent ops --session-key incident-42 маршрутизується до agent:ops:incident-42. Без --agent голі ключі без sentinel прив’язуються до налаштованого агента за замовчуванням. Літеральні global і unknown залишаються без прив’язки лише коли --agent не вказано; у такому разі вбудований fallback і власність сховища використовують налаштованого агента за замовчуванням.
Прапорці thinking і verbose зберігаються в store сесії.
Вивід: звичайний текст за замовчуванням або --json для структурованого payload + metadata.
З --json --deliver JSON містить статус доставки для надісланих, придушених, часткових і невдалих надсилань. Див. статус доставки JSON.

Приклади

bash

# Simple turn with JSON outputopenclaw agent --to +15555550123 --message "Trace logs" --verbose on --json # Turn with thinking levelopenclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium # Multiline prompt from a fileopenclaw agent --agent ops --message-file ./task.md # Exact session keyopenclaw agent --session-key agent:ops:incident-42 --message "Summarize status" # Legacy key scoped to an agentopenclaw agent --agent ops --session-key incident-42 --message "Summarize status" # Deliver to a different channel than the sessionopenclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"