進捗ドラフト

進行状況ドラフトは、長時間実行されるエージェントターンを、一時的なステータス返信の積み重ねにすることなく、チャット内で動いているように感じさせます。

進行状況ドラフトを有効にすると、OpenClaw は、そのターンが実際に作業していることが確認された後にのみ、表示される作業中メッセージを 1 つ作成し、エージェントが読み取り、計画、ツール呼び出し、承認待ちをしている間にそれを更新し、チャンネルが安全に対応できる場合は、そのドラフトを最終回答に変換します。

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

ツールを多用する作業中に整ったステータスメッセージを 1 つ表示し、ターンの完了時に最終回答を出したい場合は、進行状況ドラフトを使用します。

クイックスタート

streaming.mode: "progress" でチャンネルごとに進行状況ドラフトを有効にします。

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

通常はこれで十分です。OpenClaw は自動で 1 語のラベルを選び、作業が少なくとも 5 秒続くか 2 つ目の作業イベントが発生するまで待ち、有用な作業が進んでいる間はコンパクトな進行状況行を追加し、そのターンについて重複する単独の進行状況メッセージを抑制します。

ユーザーに表示されるもの

進行状況ドラフトは 2 つの部分で構成されます。

ラベルは、エージェントが意味のある作業を開始し、5 秒間忙しい状態が続くか 2 つ目の作業イベントを発生させた後に表示されます。これはローリング形式の進行状況行リストの一部であるため、十分な具体的作業が表示されると、開始ステータスはスクロールして消えていきます。プレーンテキストのみの返信では、進行状況ドラフトは表示されません。進行状況行は、エージェントが有用な作業更新を発生させた場合にのみ追加されます。たとえば 🛠️ Bash: run tests、🔎 Web Search: for "discord edit message"、✍️ Write: to /tmp/file などです。 デフォルトでは /verbose と同じコンパクトな説明モードを使用します。デバッグ中で、生のコマンドや詳細も追加したい場合は、agents.defaults.toolProgressDetail: "raw" を設定します。 可能な場合、最終回答はドラフトを置き換えます。それ以外の場合、OpenClaw は通常どおり最終回答を送信し、チャンネルのトランスポートに応じてドラフトをクリーンアップするか、更新を停止します。

モードを選択する

channels.<channel>.streaming.mode は、表示される進行中の挙動を制御します。

ユーザーが回答テキストのトークン単位のストリーム表示よりも「何が起きているか」を重視する場合は、progress を選びます。

回答そのものが進行状況のシグナルである場合は、partial を選びます。

大きめのテキストチャンクでドラフトプレビューを更新したい場合は、block を選びます。Discord と Telegram では、streaming.mode: "block" は通常のブロック配信ではなく、引き続きプレビューストリーミングです。通常のブロック返信が必要な場合は、streaming.block.enabled または従来の blockStreaming を使用します。

ラベルを設定する

進行状況ラベルは channels.<channel>.streaming.progress 配下にあります。

デフォルトのラベルは auto で、OpenClaw の組み込み 1 語ラベルプールから選択されます。

WorkingShellingScuttlingClawingPinchingMoltingBubblingTidingReefingCrackingSiftingBriningNautilingKrillingBarnaclingLobsteringTidepoolingPearlingSnappingSurfacing

固定ラベルを使用します。

{  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,        },      },    },  },}

進行状況行を制御する

進行状況モードでは、進行状況行はデフォルトで有効です。これらは、ツール開始、項目更新、タスク計画、承認、コマンド出力、パッチ要約、類似するエージェント活動など、実際の実行イベントから生成されます。

ツールは、単一のツール呼び出しがまだ実行中の間にも、型付きの進行状況を発行できます。これにより、遅いフェッチや検索は、ツールが最終結果を返す前に、表示中のドラフトを更新できます。進行状況更新は、空のモデル内容と明示的なパブリックチャンネルメタデータを持つ部分的なツール結果です。

{  "content": [],  "progress": {    "text": "Fetching page content...",    "visibility": "channel",    "privacy": "public",    "id": "web_fetch:fetching"  }}

OpenClaw はチャンネルの進行状況 UI に progress.text のみを表示します。通常のツール結果は後で content および details として到着し、モデルに返されるのはその部分だけです。

ツールに進行状況を追加する場合は、短く汎用的なメッセージを使い、その操作が有用といえるだけ十分長く保留された後に遅延表示します。

const clearProgressTimer = scheduleToolProgress(  onUpdate,  { text: "Fetching page content...", id: "web_fetch:fetching" },  5_000,  { signal },); try {  return await runToolWork();} finally {  clearProgressTimer();}

このパターンにより、高速な呼び出しでは進行状況行が表示されず、長い呼び出しではまだ保留中の間に 1 行表示され、キャンセルされた呼び出しでは古い進行状況が表示される前にタイマーがクリアされます。進行状況テキストは公開 UI のサイドチャンネルであるため、秘密情報、生の引数、取得した内容、コマンド出力、ページテキストを含めてはいけません。

OpenClaw は進行状況ドラフトと /verbose に同じフォーマッターを使用します。

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

"explain" はデフォルトで、🛠️ check JS syntax for /tmp/app.js のような簡潔なラベルによりドラフトを安定させます。"raw" は利用可能な場合に基になるコマンドや詳細を追加します。これはデバッグ中には有用ですが、チャットではやや騒がしくなります。

たとえば、同じコマンドでも詳細モードによって表示が異なります。

表示され続ける行数を制限します。

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

ドラフトの編集中にチャット吹き出しのリフローを減らすため、進行状況行は自動的に圧縮されます。

OpenClaw はデフォルトで長い進行状況行を切り詰め、繰り返しのドラフト編集で更新のたびに折り返しが変わらないようにします。デフォルトの 1 行あたりの上限は 120 文字です。文章は単語境界で切られ、パスや生コマンドのような長い詳細は、接尾部が見えるように中央の省略記号で短縮されます。

1 行あたりの上限を調整します。

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

Slack では、進行状況行を単一のテキスト本文ではなく、構造化された Block Kit フィールドとしてレンダリングできます。

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

リッチレンダリングは同じプレーンテキストのフォールバックを保持するため、よりリッチな形をサポートしないチャンネルやクライアントでも、コンパクトな進行状況テキストを表示できます。

単一の進行状況ドラフトを維持しつつ、ツール行とタスク行を非表示にします。

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

toolProgress: false の場合でも、OpenClaw はそのターンについて従来の単独ツール進行状況メッセージを抑制します。ラベルが設定されている場合を除き、チャンネルは最終回答まで視覚的に静かなままです。

チャンネルの挙動

各チャンネルは、サポートする中で最もクリーンなトランスポートを使用します。

安全な編集サポートのないチャンネルは、通常、入力中インジケーターまたは最終回答のみの配信にフォールバックします。

最終化

最終回答の準備ができると、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 はまた、Discord と Telegram で使われる同じ下書きプレビューブロックモードを持たないため、streaming.mode: "block" を Teams ブロック配信として扱います。

関連

• ストリーミングとチャンク化
• メッセージ
• チャンネル設定
• Discord
• Matrix
• Microsoft Teams
• Slack
• Telegram