Чернетки прогресу

Чернетки перебігу виконання роблять довгі ходи агента в чаті живими, не перетворюючи розмову на стос тимчасових статусних відповідей. Коли чернетки перебігу виконання ввімкнено, OpenClaw створює одне видиме повідомлення про роботу в процесі лише після того, як хід доводить, що виконує реальну роботу, оновлює його, поки агент читає, планує, викликає інструменти або чекає на схвалення, а потім перетворює цю чернетку на фінальну відповідь, коли канал може зробити це безпечно.

Shelling...
📖 from docs/concepts/progress-drafts.md
🔎 Web Search: for "discord edit message"
🛠️ Bash: run tests

Використовуйте чернетки перебігу виконання, коли вам потрібне одне охайне статусне повідомлення під час роботи з великою кількістю інструментів і фінальна відповідь, коли хід завершено.

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

Увімкніть чернетки перебігу виконання для кожного каналу за допомогою streaming.mode: "progress":

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
      },
    },
  },
}

Зазвичай цього достатньо. OpenClaw вибере автоматичну мітку з одного слова, зачекає, доки робота триватиме щонайменше п’ять секунд або згенерує другу подію роботи, додаватиме стислі рядки перебігу виконання, поки відбувається корисна робота, і приглушить дублікати окремої балаканини про перебіг виконання для цього ходу.

Що бачать користувачі

Чернетка перебігу виконання має дві частини:

Частина	Призначення
Мітка	Короткий початковий або статусний рядок, як-от `Thinking...` або `Shelling...`.
Рядки перебігу	Стислі оновлення запуску з тими самими піктограмами інструментів і форматером подробиць, що й у докладному виводі.

Мітка з’являється після того, як агент починає змістовну роботу й або лишається зайнятим п’ять секунд, або генерує другу подію роботи. Вона є частиною рухомого списку рядків перебігу виконання, тому початковий статус зникає з поля зору, коли з’являється достатньо конкретної роботи. Відповіді лише простим текстом не показують чернетку перебігу виконання. Рядки перебігу додаються лише тоді, коли агент генерує корисні оновлення роботи, наприклад 🛠️ Bash: run tests, 🔎 Web Search: for "discord edit message" або ✍️ Write: to /tmp/file. За замовчуванням вони використовують той самий стислий режим пояснення, що й /verbose; задайте agents.defaults.toolProgressDetail: "raw" під час налагодження, якщо також хочете додавати необроблені команди або подробиці. Фінальна відповідь замінює чернетку, коли це можливо; інакше OpenClaw надсилає фінальну відповідь звичайним способом і очищає чернетку або припиняє її оновлювати відповідно до транспорту каналу.

Виберіть режим

channels.<channel>.streaming.mode керує видимою поведінкою роботи в процесі:

Режим	Найкраще для	Що з’являється в чаті
`off`	Тихих каналів	Лише фінальна відповідь.
`partial`	Спостереження за появою тексту відповіді	Одна чернетка, відредагована з найновішим текстом відповіді.
`block`	Більших фрагментів попереднього перегляду відповіді	Один попередній перегляд, оновлений або доповнений більшими фрагментами.
`progress`	Ходів із великою кількістю інструментів або довгим виконанням	Одна статусна чернетка, потім фінальна відповідь.

Вибирайте progress, коли користувачам важливіше «що відбувається», ніж спостерігати, як текст відповіді транслюється токен за токеном. Вибирайте partial, коли сама відповідь є сигналом перебігу виконання. Вибирайте block, коли потрібні оновлення чернетки попереднього перегляду більшими текстовими фрагментами. У Discord і Telegram streaming.mode: "block" і далі означає потоковий попередній перегляд, а не звичайну доставку блоками. Використовуйте streaming.block.enabled або застарілий blockStreaming, коли потрібні звичайні блокові відповіді.

Налаштуйте мітки

Мітки перебігу виконання розташовані в channels.<channel>.streaming.progress. Стандартна мітка — auto, яка вибирає з вбудованого в OpenClaw пулу міток з одного слова з трьома крапками:

Thinking...
Shelling...
Scuttling...
Clawing...
Pinching...
Molting...
Bubbling...
Tiding...
Reefing...
Cracking...
Sifting...
Brining...
Nautiling...
Krilling...
Barnacling...
Lobstering...
Tidepooling...
Pearling...
Snapping...
Surfacing...

Використайте фіксовану мітку:

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          label: "Investigating",
        },
      },
    },
  },
}

Використайте власний автоматичний пул міток:

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          label: "auto",
          labels: ["Checking", "Reading", "Testing", "Finishing"],
        },
      },
    },
  },
}

Приховайте мітку й показуйте лише рядки перебігу виконання:

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          label: false,
        },
      },
    },
  },
}

Керуйте рядками перебігу виконання

Рядки перебігу виконання ввімкнені за замовчуванням у режимі progress. Вони походять із реальних подій запуску: запусків інструментів, оновлень елементів, планів завдань, схвалень, виводу команд, підсумків патчів і подібної активності агента. OpenClaw використовує той самий форматер для чернеток перебігу виконання і /verbose:

{
  agents: {
    defaults: {
      toolProgressDetail: "explain", // explain | raw
    },
  },
}

"explain" є стандартним значенням і зберігає чернетки стабільними завдяки стислим міткам на кшталт 🛠️ check JS syntax for /tmp/app.js. "raw" додає базову команду або подробицю, коли вона доступна, що корисно під час налагодження, але створює більше шуму в чаті. Наприклад, та сама команда виглядає по-різному залежно від режиму подробиць:

Режим	Рядок перебігу виконання
`explain`	`🛠️ check JS syntax for /tmp/app.js`
`raw`	`🛠️ check JS syntax for /tmp/app.js, node --check /tmp/app.js`

Обмежте кількість видимих рядків:

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          maxLines: 4,
        },
      },
    },
  },
}

Рядки перебігу виконання автоматично стискаються, щоб зменшити переливання бульбашки чату під час редагування чернетки. OpenClaw за замовчуванням обрізає довгі рядки перебігу виконання, щоб повторні редагування чернетки не переносилися інакше під час кожного оновлення. Префікс залишається читабельним, а довгі подробиці, як-от шляхи або необроблені команди, скорочуються трьома крапками. Slack може відображати рядки перебігу виконання як структуровані поля Block Kit замість єдиного текстового тіла:

{
  channels: {
    slack: {
      streaming: {
        mode: "progress",
        progress: {
          render: "rich",
        },
      },
    },
  },
}

Розширене відображення зберігає той самий простотекстовий запасний варіант, щоб канали й клієнти, які не підтримують багатшу форму, усе одно могли показувати стислий текст перебігу виконання. Збережіть одну чернетку перебігу виконання, але приховайте рядки інструментів і завдань:

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          toolProgress: false,
        },
      },
    },
  },
}

З toolProgress: false OpenClaw усе одно приглушує старіші окремі повідомлення про перебіг виконання інструментів для цього ходу. Канал лишається візуально тихим до фінальної відповіді, крім мітки, якщо її налаштовано.

Поведінка каналів

Кожен канал використовує найчистіший транспорт, який він підтримує:

Канал	Транспорт перебігу виконання	Примітки
Discord	Надіслати одне повідомлення, потім редагувати його.	Фінальний текст редагується на місці, коли вміщується в одне безпечне повідомлення попереднього перегляду.
Matrix	Надіслати одну подію, потім редагувати її.	Конфігурація потокового передавання на рівні облікового запису керує чернетками на рівні облікового запису.
Microsoft Teams	Нативний потік Teams в особистих чатах.	`streaming.mode: "block"` відображається на блокову доставку Teams.
Slack	Нативний потік або редагований допис-чернетка.	Доступність потоку впливає на те, чи можна використовувати нативне потокове передавання.
Telegram	Надіслати одне повідомлення, потім редагувати його.	Старіші видимі чернетки можуть бути замінені, щоб фінальні часові позначки лишалися корисними.
Mattermost	Редагований допис-чернетка.	Активність інструментів згортається в той самий допис у стилі чернетки.

Канали без безпечної підтримки редагування зазвичай повертаються до індикаторів набору або доставки лише фінальної відповіді.

Фіналізація

Коли фінальна відповідь готова, OpenClaw намагається зберегти чат чистим:

Якщо чернетка може безпечно стати фінальною відповіддю, OpenClaw редагує її на місці.
Якщо канал використовує нативне потокове передавання перебігу виконання, OpenClaw фіналізує цей потік, коли нативний транспорт приймає фінальний текст.
Якщо фінальна відповідь містить медіа, запит схвалення, явну ціль відповіді, забагато фрагментів або невдале редагування чи надсилання, OpenClaw надсилає фінальну відповідь через звичайний шлях доставки каналу.

Запасний шлях є навмисним. Краще надіслати нову фінальну відповідь, ніж втратити текст, неправильно прив’язати відповідь до потоку або перезаписати чернетку вмістом, який канал не може безпечно представити.

Усунення несправностей

Я бачу лише фінальну відповідь. Перевірте, що channels.<channel>.streaming.mode задано як progress для облікового запису або каналу, який обробив повідомлення. Деякі шляхи групових повідомлень або відповідей із цитатою можуть вимикати попередні перегляди чернеток для ходу, коли канал не може безпечно редагувати правильне повідомлення. Я бачу мітку, але не бачу рядків інструментів. Перевірте streaming.progress.toolProgress. Якщо це false, OpenClaw зберігає поведінку однієї чернетки, але приховує рядки перебігу виконання інструментів і завдань. Я бачу нове фінальне повідомлення замість відредагованої чернетки. Це безпечний запасний варіант. Таке може статися для відповідей із медіа, довгих відповідей, явних цілей відповіді, старих чернеток Telegram, відсутніх цілей потоків Slack, видалених повідомлень попереднього перегляду або невдалої фіналізації нативного потоку. Я все ще бачу окремі повідомлення про перебіг виконання. Режим progress приглушує стандартні окремі повідомлення про перебіг виконання інструментів, коли чернетка активна. Якщо окремі повідомлення все ще з’являються, перевірте, що хід справді використовує режим progress, а не streaming.mode: "off" або шлях каналу, який не може створити чернетку для цього повідомлення. Teams поводиться інакше, ніж Discord або Telegram. Microsoft Teams використовує нативний потік в особистих чатах замість універсального транспорту попереднього перегляду з надсиланням і редагуванням. Teams також трактує streaming.mode: "block" як блокову доставку Teams, бо не має такого самого блокового режиму попереднього перегляду чернеток, який використовують Discord і Telegram.

Documentation Index

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

​Що бачать користувачі

​Виберіть режим

​Налаштуйте мітки

​Керуйте рядками перебігу виконання

​Поведінка каналів

​Фіналізація

​Усунення несправностей

​Пов’язане