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

​

Швидкий початок

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

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

# Target a specific agent
openclaw agent --agent ops --message "Summarize logs"

# Target a phone number (derives session key)
openclaw agent --to +15555550123 --message "Status update"

# Reuse an existing session
openclaw agent --session-id abc123 --message "Continue the task"

# Target an exact session key
openclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

# Deliver to WhatsApp (default channel)
openclaw agent --to +15555550123 --message "Report ready" --deliver

# Deliver to Slack
openclaw agent --agent ops --message "Generate report" \
  --deliver --reply-channel slack --reply-to "#reports"

​

Прапорці

​

Поведінка

• Типово 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.

​

Приклади

# Simple turn with JSON output
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json

# Turn with a model override
openclaw agent --agent ops --model openai/gpt-5.4 --message "Summarize logs"

# Turn with thinking level
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium

# Multiline prompt from a file
openclaw agent --agent ops --message-file ./task.md

# Exact session key
openclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

# Legacy key scoped to an agent
openclaw agent --agent ops --session-key incident-42 --message "Summarize status"

# Deliver to a different channel than the session
openclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"

​

Пов’язані матеріали