ストリーミングとチャンク化

• ブロックストリーミング（チャンネル）: アシスタントが書き込みながら、完了したブロックを送信します。これらは通常のチャンネルメッセージであり、トークン差分ではありません。
• プレビューストリーミング（Telegram/Discord/Slack/Matrix/Mattermost/MS Teams）: 生成中に一時的なプレビューメッセージを更新します（送信 + 編集/追記）。

​

ブロックストリーミング（チャンネルメッセージ）

Model output
  └─ text_delta/events
       ├─ (blockStreamingBreak=text_end)
       │    └─ chunker emits blocks as buffer grows
       └─ (blockStreamingBreak=message_end)
            └─ chunker flushes at message_end
                   └─ channel send (block replies)

• text_delta/events: モデルストリームイベント（非ストリーミングモデルでは疎になる場合があります）。
• chunker: 最小/最大境界 + 改行優先度を適用する EmbeddedBlockChunker。
• channel send: 実際の送信メッセージ（ブロック返信）。

• text_end: チャンクャーが送出したらすぐにブロックをストリーミングし、各 text_end でフラッシュします。
• message_end: アシスタントメッセージが完了するまで待ち、バッファされた出力をフラッシュします。バッファされたテキストが maxChars を超える場合は引き続きチャンクャーを使うため、最後に複数のチャンクを送出できます。

​

ブロックストリーミングでのメディア配信

​

チャンク化アルゴリズム（低/高境界）

• 低境界: 強制されない限り、バッファ >= minChars になるまで送出しません。
• 高境界: maxChars より前での分割を優先します。強制時は maxChars で分割します。
• 改行優先度チェーン: paragraph -> newline -> sentence -> 空白 -> ハードブレーク。
• コードフェンス: フェンス内では絶対に分割しません。maxChars で強制される場合は、Markdown の妥当性を保つためにフェンスを閉じて再度開きます。

​

結合（ストリーミングされたブロックを結合）

• 結合はフラッシュ前にアイドル間隔（idleMs）を待ちます。
• バッファは maxChars で上限が設定され、超過するとフラッシュされます。
• minChars は、十分なテキストが蓄積するまで小さな断片の送信を防ぎます（最終フラッシュでは残りのテキストを常に送信します）。
• 結合子は blockStreamingChunk.breakPreference から導出されます: paragraph -> \n\n、newline -> \n、sentence -> スペース。
• チャンネル上書きは *.blockStreamingCoalesce（アカウントごとの設定を含む）で利用できます。
• Discord、Signal、Slack は、上書きされない限りデフォルトで { minChars: 1500, idleMs: 1000 } に結合します。

​

ブロック間の人間らしいペーシング

​

「チャンクをストリーミングするか、すべてを送るか」

• チャンクをストリーミング: blockStreamingDefault: "on" + blockStreamingBreak: "text_end" （生成しながら送出）。Telegram 以外のチャンネルでは *.blockStreaming: true も必要です。
• 最後にすべてをストリーミング: blockStreamingBreak: "message_end"（1 回フラッシュし、非常に長い場合は複数チャンクになる可能性があります）。
• ブロックストリーミングなし: blockStreamingDefault: "off"（最終返信のみ）。

​

プレビューストリーミングモード

​

チャンネルマッピング

• channels.slack.streaming.nativeTransport は、channels.slack.streaming.mode="partial" のときに Slack ネイティブストリーミング API 呼び出し（chat.startStream/chat.appendStream/chat.stopStream）を切り替えます（デフォルト: true）。
• Slack ネイティブストリーミングと Slack アシスタントスレッドステータスには返信スレッドターゲットが必要です。トップレベルの DM ではそのスレッド形式のプレビューは表示されませんが、Slack の下書きプレビュー投稿と編集は引き続き使用できます。

​

レガシーキー移行

​

ランタイム動作

​

Telegram

• DM とグループ/トピック全体で sendMessage + editMessageText のプレビュー更新を使います。最終テキストはアクティブなプレビューをその場で編集します。Telegram の一時的な 30 秒「入力中」下書き（sendMessageDraft）は回答ストリーミングには使われません。
• 短い初期プレビューはプッシュ通知 UX のため引き続きデバウンスされますが、アクティブな実行が視覚的に無音のままにならないよう、境界付き遅延の後に実体化されます。
• 長い最終回答では、最初のチャンクにプレビューメッセージを再利用し、残りのチャンクのみ送信します。
• block モードは、streaming.preview.chunk.maxChars（デフォルト 800、Telegram の 4096 編集上限でキャップ）でプレビューを新しいメッセージへローテーションします。他のモードでは、1 つのプレビューを最大 4096 文字まで伸ばします。
• progress モードは、ツール進行状況を編集可能なステータス下書きに保持し、回答ストリーミングがアクティブだがツール行がまだ利用できない場合にステータスラベルを実体化し、完了時に下書きをクリアして、通常の配信を通じて最終回答を送信します。
• 完了したテキストが確認される前に最終編集が失敗した場合、OpenClaw は通常の最終配信を使い、古いプレビューをクリーンアップします。
• 二重ストリーミングを避けるため、Telegram ブロックストリーミングが明示的に有効な場合、プレビューストリーミングはスキップされます。
• /reasoning stream は、最終配信後に削除される一時プレビューへ reasoning を書き込めます。
• Telegram の選択引用返信は例外です。replyToMode が "off" ではなく、選択引用テキストが存在する場合、そのターンでは OpenClaw は回答プレビューストリームをスキップします（最終回答はネイティブの引用返信パスを通る必要があります）。そのため、ツール進行状況のプレビュー行はレンダリングできません。選択引用テキストがない現在メッセージへの返信では、プレビューストリーミングは維持されます。詳細は Telegram チャンネルドキュメント を参照してください。

​

Discord

• send + edit プレビュー メッセージを使用します。
• block モードはドラフトのチャンク化 (draftChunk) を使用します。
• Discord のブロック ストリーミングが明示的に有効化されている場合、プレビュー ストリーミングはスキップされます。
• 最終メディア、エラー、明示的な返信ペイロードは、新しいドラフトをフラッシュせずに保留中のプレビューをキャンセルし、その後通常の配信を使用します。

​

Slack

• partial は、利用可能な場合に Slack ネイティブ ストリーミング (chat.startStream/append/stop) を使用できます。
• block は追記スタイルのドラフト プレビューを使用します。
• progress はステータス プレビュー テキストを使用し、その後に最終回答を送信します。
• 返信スレッドのないトップレベル DM は、Slack ネイティブ ストリーミングの代わりにドラフト プレビュー投稿と編集を使用します。
• ネイティブおよびドラフト プレビュー ストリーミングは、そのターンのブロック返信を抑制するため、Slack の返信は 1 つの配信パスだけでストリーミングされます。
• 最終メディア/エラー ペイロードと進行状況の最終結果は、使い捨てのドラフト メッセージを作成しません。プレビューを編集できるテキスト/ブロックの最終結果だけが、保留中のドラフト テキストをフラッシュします。

​

Mattermost

• 思考、ツール アクティビティ、部分返信テキストを単一のドラフト プレビュー投稿にストリーミングし、最終回答を安全に送信できるときにその場で確定します。
• プレビュー投稿が削除されたか、確定時に何らかの理由で利用できない場合は、新しい最終投稿の送信にフォールバックします。
• 最終メディア/エラー ペイロードは、一時的なプレビュー投稿をフラッシュする代わりに、通常の配信前に保留中のプレビュー更新をキャンセルします。

​

Matrix

• 最終テキストがプレビュー イベントを再利用できる場合、ドラフト プレビューはその場で確定します。
• メディアのみ、エラー、返信先不一致の最終結果は、通常の配信前に保留中のプレビュー更新をキャンセルします。すでに表示されている古いプレビューは編集削除されます。

​

ツール進行状況のプレビュー更新

• Discord、Slack、Telegram、Matrix は、プレビュー ストリーミングが有効な場合、デフォルトでツール進行状況と Codex の前置き更新をライブ プレビュー編集にストリーミングします。Microsoft Teams は個人チャットでネイティブの進行状況ストリームを使用します。
• Telegram は v2026.4.22 以降、ツール進行状況プレビュー更新を有効にした状態で出荷されています。有効のままにすることで、そのリリース済みの動作を維持できます。
• Mattermost は、すでにツール アクティビティを単一のドラフト プレビュー投稿に組み込んでいます（上記を参照）。
• ツール進行状況の編集は、アクティブなプレビュー ストリーミング モードに従います。プレビュー ストリーミングが off の場合、またはブロック ストリーミングがメッセージを引き継いでいる場合はスキップされます。Telegram では、streaming.mode: "off" は最終結果のみです。汎用的な進行状況の雑談も、単独のステータス メッセージとして配信される代わりに抑制されます。一方で、承認プロンプト、メディア ペイロード、エラーは引き続き通常どおりルーティングされます。
• プレビュー ストリーミングは維持しつつツール進行状況行を非表示にするには、そのチャネルの streaming.preview.toolProgress を false に設定します（デフォルトは true）。コマンド/実行テキストを非表示にしつつツール進行状況行を表示したままにするには、streaming.preview.commandText を "status" に設定するか、streaming.progress.commandText を "status" に設定します。リリース済みの動作を維持するため、デフォルトは "raw" です。このポリシーは、OpenClaw のコンパクト進行状況レンダラーを使用するドラフト/進行状況チャネルで共有されます。これには Discord、Matrix、Microsoft Teams、Mattermost、Slack ドラフト プレビュー、Telegram が含まれます。プレビュー編集を完全に無効化するには、streaming.mode を off に設定します。

​

進行状況ドラフトのレンダリング

​

コメンタリー進行状況レーン

• streaming.progress.commentary - モデルのツール実行前の コメンタリー（短い「確認してから…」のようなナレーション）を、進行状況ドラフト内でツール行と交互にレンダリングします。

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

{
  "channels": {
    "telegram": {
      "streaming": {
        "mode": "partial",
        "preview": {
          "toolProgress": true,
          "commandText": "status"
        }
      }
    }
  }
}

{
  "channels": {
    "telegram": {
      "streaming": {
        "mode": "progress",
        "progress": {
          "toolProgress": true,
          "commandText": "status"
        }
      }
    }
  }
}

​

関連

• メッセージ ライフサイクル リファクタリング - 共有プレビュー、編集、ストリーム、確定設計の対象
• 進行状況ドラフト - 長いターン中に更新される、作業中であることが見えるメッセージ
• メッセージ - メッセージ ライフサイクルと配信
• 再試行 - 配信失敗時の再試行動作
• チャネル - チャネルごとのストリーミング サポート