Перейти до основного вмісту

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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

1

Run a simple agent turn

openclaw agent --message "What is the weather today?"
Це надсилає повідомлення через Gateway і виводить відповідь.
2

Target a specific agent or session

# 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"
3

Deliver the reply to a channel

# 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"

Прапорці

ПрапорецьОпис
--message \<text\>Повідомлення для надсилання (обов’язково)
--to \<dest\>Вивести ключ сесії з цілі (телефон, id чату)
--agent \<id\>Націлитися на налаштованого агента (використовує його сесію main)
--session-id \<id\>Повторно використати наявну сесію за id
--localПримусово використати локальне вбудоване середовище виконання (оминути 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\>Перевизначити час очікування агента
--jsonВивести структурований JSON

Поведінка

  • За замовчуванням CLI працює через Gateway. Додайте --local, щоб примусово використати вбудоване середовище виконання на поточній машині.
  • Якщо Gateway недоступний, CLI повертається до локального вбудованого запуску.
  • Вибір сесії: --to виводить ключ сесії (цілі груп/каналів зберігають ізоляцію; прямі чати згортаються до main).
  • Прапорці мислення й докладності зберігаються в сховищі сесії.
  • Виведення: за замовчуванням звичайний текст або --json для структурованого корисного навантаження + метаданих.
  • З --json --deliver JSON містить статус доставки для надісланих, приглушених, часткових і невдалих надсилань. Див. статус доставки JSON.

Приклади

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

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

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

Пов’язане

Agent CLI reference

Повний довідник прапорців і параметрів openclaw agent.

Sub-agents

Запуск фонових під-агентів.

Sessions

Як працюють ключі сесій і як --to, --agent та --session-id їх визначають.

Slash commands

Власний каталог команд, що використовується всередині сесій агентів.