Documentation Index
Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Progress drafts は、長時間実行されるエージェントターンを、会話を一時的なステータス返信の積み重ねにせずに、チャット上で動いているように見せます。
Progress drafts を有効にすると、OpenClaw はターンが実際に作業していることを示した後でのみ、表示される作業中メッセージを 1 つ作成し、エージェントが読み取り、計画し、ツールを呼び出し、または承認を待つ間にそれを更新し、チャネルが安全に実行できる場合は、その下書きを最終回答に変換します。
Shelling...
📖 from docs/concepts/progress-drafts.md
🔎 Web Search: for "discord edit message"
🛠️ Bash: run tests
クイックスタート
チャネルごとに streaming.mode: "progress" で Progress drafts を有効にします。
{
channels: {
discord: {
streaming: {
mode: "progress",
},
},
},
}
ユーザーに表示される内容
Progress draft は 2 つの部分で構成されます。
| 部分 | 目的 |
|---|
| ラベル | 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 | 回答テキストが表示されていく様子を見る場合 | 最新の回答テキストで編集される 1 つの下書き。 |
block | より大きな回答プレビューのチャンク | より大きなチャンクで更新または追加される 1 つのプレビュー。 |
progress | ツールを多用する、または長時間実行されるターン | 1 つのステータス下書き、その後に最終回答。 |
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 は Progress drafts と /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,
},
},
},
},
}
{
channels: {
slack: {
streaming: {
mode: "progress",
progress: {
render: "rich",
},
},
},
},
}
{
channels: {
discord: {
streaming: {
mode: "progress",
progress: {
toolProgress: false,
},
},
},
},
}
toolProgress: false の場合でも、OpenClaw はそのターンについて古い単独のツール進捗メッセージを抑制します。ラベルが設定されている場合を除き、チャネルは最終回答まで視覚的に静かなままです。
チャネルの動作
各チャネルは、サポートする最もクリーンなトランスポートを使用します。
| チャネル | 進捗トランスポート | 注記 |
|---|
| Discord | 1 つのメッセージを送信し、その後編集します。 | 最終テキストが 1 つの安全なプレビューメッセージに収まる場合は、その場で編集されます。 |
| Matrix | 1 つのイベントを送信し、その後編集します。 | アカウントレベルのストリーミング設定が、アカウントレベルの下書きを制御します。 |
| Microsoft Teams | 個人チャットのネイティブ Teams ストリーム。 | streaming.mode: "block" は Teams ブロック配信にマップされます。 |
| Slack | ネイティブストリームまたは編集可能な下書き投稿。 | スレッドの可用性は、ネイティブストリーミングを使用できるかどうかに影響します。 |
| Telegram | 1 つのメッセージを送信し、その後編集します。 | 最終タイムスタンプが有用なままになるように、古い表示下書きが置き換えられる場合があります。 |
| Mattermost | 編集可能な下書き投稿。 | ツール活動は同じ下書き形式の投稿に折り込まれます。 |
最終化
最終回答の準備ができると、OpenClaw はチャットをきれいに保とうとします。
- 下書きを安全に最終回答にできる場合、OpenClaw はその場で編集します。
- チャネルがネイティブの進捗ストリーミングを使用する場合、ネイティブトランスポートが最終テキストを受け入れた時点で、OpenClaw はそのストリームを最終化します。
- 最終回答にメディア、承認プロンプト、明示的な返信先、過剰なチャンク数、または編集や送信の失敗がある場合、OpenClaw は通常のチャネル配信パスで最終回答を送信します。
フォールバックパスは意図的なものです。テキストを失ったり、返信スレッドを誤ったり、チャネルが安全に表現できないペイロードで下書きを上書きしたりするよりも、新しい最終回答を送信する方が適切です。
トラブルシューティング
最終回答しか表示されません。
メッセージを処理したアカウントまたはチャネルで、channels.<channel>.streaming.mode が progress に設定されていることを確認します。一部のグループまたは引用返信のパスでは、チャネルが正しいメッセージを安全に編集できない場合、そのターンの下書きプレビューが無効になることがあります。
ラベルは表示されますが、ツール行が表示されません。
streaming.progress.toolProgress を確認します。false の場合、OpenClaw は単一下書きの動作を維持しますが、ツールとタスクの進捗行を非表示にします。
編集された下書きではなく、新しい最終メッセージが表示されます。
これは安全のためのフォールバックです。メディア返信、長い回答、明示的な返信先、古い Telegram 下書き、Slack スレッド先の欠落、削除されたプレビューメッセージ、またはネイティブストリームの最終化失敗で発生することがあります。
単独の進捗メッセージがまだ表示されます。
Progress mode は、下書きがアクティブな場合に既定の単独のツール進捗メッセージを抑制します。それでも単独メッセージが表示される場合は、そのターンが実際に progress mode を使用しており、streaming.mode: "off" や、そのメッセージの下書きを作成できないチャネルパスではないことを確認します。
Teams の動作が Discord や Telegram と異なります。
Microsoft Teams は、汎用の送信して編集するプレビュートランスポートの代わりに、個人チャットでネイティブストリームを使用します。また Teams は、Discord や Telegram で使われる同じ下書きプレビューブロックモードを持たないため、streaming.mode: "block" を Teams ブロック配信として扱います。
