English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

CLI commands

Агент

openclaw agent

Запустіть хід агента через Gateway (використовуйте --local для вбудованого режиму). Використовуйте --agent <id>, щоб напряму націлитися на налаштованого агента.

Передайте принаймні один селектор сеансу:

  • --to <dest>
  • --session-id <id>
  • --agent <id>

Пов’язане:

Параметри

  • -m, --message <text>: обов’язкове тіло повідомлення
  • -t, --to <dest>: одержувач, що використовується для визначення ключа сеансу
  • --session-id <id>: явний ідентифікатор сеансу
  • --agent <id>: ідентифікатор агента; перевизначає прив’язки маршрутизації
  • --model <id>: перевизначення моделі для цього запуску (provider/model або ідентифікатор моделі)
  • --thinking <level>: рівень мислення агента (off, minimal, low, medium, high, а також підтримувані провайдером користувацькі рівні, як-от xhigh, adaptive або max)
  • --verbose <on|off>: зберегти рівень докладності для сеансу
  • --channel <channel>: канал доставки; пропустіть, щоб використовувати основний канал сеансу
  • --reply-to <target>: перевизначення цілі доставки
  • --reply-channel <channel>: перевизначення каналу доставки
  • --reply-account <id>: перевизначення облікового запису доставки
  • --local: запустити вбудованого агента напряму (після попереднього завантаження реєстру Plugin)
  • --deliver: надіслати відповідь назад у вибраний канал/ціль
  • --timeout <seconds>: перевизначити тайм-аут агента (за замовчуванням 600 або значення з конфігурації)
  • --json: вивести JSON

Приклади

openclaw agent --to +15555550123 --message "status update" --deliver
openclaw agent --agent ops --message "Summarize logs"
openclaw agent --agent ops --model openai/gpt-5.4 --message "Summarize logs"
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json
openclaw agent --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"
openclaw agent --agent ops --message "Run locally" --local

Примітки

  • Режим Gateway повертається до вбудованого агента, коли запит Gateway завершується помилкою. Використовуйте --local, щоб одразу примусово виконати вбудований режим.
  • --local усе одно спочатку попередньо завантажує реєстр Plugin, тому надані Plugin провайдери, інструменти й канали залишаються доступними під час вбудованих запусків.
  • --local і вбудовані резервні запуски вважаються одноразовими. Вбудовані ресурси зворотного підключення MCP і теплі stdio-сеанси Claude, відкриті для цього локального процесу, завершуються після відповіді, тож скриптові виклики не залишають локальні дочірні процеси активними.
  • Запуски на базі Gateway залишають належні Gateway ресурси зворотного підключення MCP у запущеному процесі Gateway; старіші клієнти все ще можуть надсилати історичний прапорець очищення, але Gateway приймає його як сумісну операцію без дії.
  • --channel, --reply-channel і --reply-account впливають на доставку відповіді, а не на маршрутизацію сеансу.
  • --json залишає stdout зарезервованим для відповіді JSON. Діагностика Gateway, Plugin і вбудованого резервного режиму спрямовується до stderr, щоб скрипти могли напряму аналізувати stdout.
  • JSON вбудованого резервного режиму містить meta.transport: "embedded" і meta.fallbackFrom: "gateway", щоб скрипти могли відрізняти резервні запуски від запусків Gateway.
  • Якщо Gateway приймає запуск агента, але CLI перевищує час очікування фінальної відповіді, вбудований резервний режим використовує новий явний ідентифікатор сеансу/запуску gateway-fallback-* і повідомляє meta.fallbackReason: "gateway_timeout" разом із полями резервного сеансу. Це запобігає конкуренції з належним Gateway блокуванням транскрипта або непомітній заміні початкового маршрутизованого сеансу розмови.
  • Коли ця команда запускає повторну генерацію models.json, облікові дані провайдера, керовані SecretRef, зберігаються як несекретні маркери (наприклад, назви змінних середовища, secretref-env:ENV_VAR_NAME або secretref-managed), а не як розв’язаний секретний відкритий текст.
  • Записи маркерів є авторитетними щодо джерела: OpenClaw зберігає маркери з активного знімка конфігурації джерела, а не з розв’язаних значень секретів під час виконання.

Пов’язане