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

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 створює одне видиме повідомлення про роботу в процесі, оновлює його, поки агент читає, планує, викликає інструменти або чекає на схвалення, а потім перетворює цю чернетку на фінальну відповідь, коли канал може зробити це безпечно. 
Shelling
- reading recent channel context
- checking matching issues
- preparing reply
Використовуйте чернетки перебігу роботи, коли потрібне одне охайне повідомлення зі статусом під час роботи з багатьма інструментами та фінальна відповідь після завершення ходу.

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

Увімкніть чернетки перебігу роботи для кожного каналу через streaming.mode: "progress": 
{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
      },
    },
  },
}
Зазвичай цього достатньо. OpenClaw вибере автоматичну однослівну мітку, додаватиме стислі рядки перебігу, поки відбувається корисна робота, і приглушить дубльовані окремі повідомлення про перебіг для цього ходу.

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

Чернетка перебігу роботи має дві частини:
ЧастинаПризначення
МіткаКороткий заголовок, наприклад Thinking або Shelling.
Рядки перебігуСтислі оновлення запуску, як-от виклики інструментів, кроки завдання або схвалення.
Мітка з’являється одразу, коли агент починає відповідати. Рядки перебігу додаються лише тоді, коли агент надсилає корисні оновлення про роботу. Фінальна відповідь замінює чернетку, коли це можливо; інакше 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,
        },
      },
    },
  },
}

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

Рядки перебігу ввімкнені типово в режимі перебігу. Вони походять із реальних подій запуску: запусків інструментів, оновлень елементів, планів завдань, схвалень, виводу команд, підсумків патчів і подібної активності агента. Обмежте кількість рядків, що залишаються видимими: 
{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          maxLines: 4,
        },
      },
    },
  },
}
Збережіть одну чернетку перебігу, але приховайте рядки інструментів і завдань: 
{
  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, видалених повідомлень попереднього перегляду або невдалої фіналізації нативного потоку. Я все ще бачу окремі повідомлення про перебіг. Режим перебігу приглушує типові окремі повідомлення про перебіг інструментів, коли чернетка активна. Якщо окремі повідомлення все ще з’являються, перевірте, що хід справді використовує режим перебігу, а не streaming.mode: "off" або шлях каналу, який не може створити чернетку для цього повідомлення. Teams поводиться інакше, ніж Discord або Telegram. Microsoft Teams використовує нативний потік в особистих чатах замість універсального транспорту попереднього перегляду з надсиланням і редагуванням. Teams також трактує streaming.mode: "block" як блокову доставку Teams, оскільки не має такого самого блокового режиму попереднього перегляду чернеток, який використовують Discord і Telegram.

​
Пов’язане