メインコンテンツへスキップ

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 は表示される作業中メッセージを 1 つ作成し、エージェントが読んだり、計画したり、ツールを呼び出したり、承認を待ったりしている間にそれを更新します。その後、チャンネルが安全に実行できる場合は、その下書きを最終回答に変えます。 
Shelling
- reading recent channel context
- checking matching issues
- preparing reply
ツールを多用する作業中に整理されたステータスメッセージを 1 つ表示し、ターンが完了したら最終回答を表示したい場合は、進行状況の下書きを使用します。

​
クイックスタート

チャンネルごとに streaming.mode: "progress" で進行状況の下書きを有効にします。 
{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
      },
    },
  },
}
通常はこれで十分です。OpenClaw は自動的に 1 語のラベルを選び、有用な作業が発生している間はコンパクトな進行状況行を追加し、そのターンでは重複する単独の進行状況メッセージを抑制します。

​
ユーザーに表示される内容

進行状況の下書きには 2 つの部分があります。
部分目的
ラベルThinking や Shelling などの短いタイトル。
進行状況行ツール呼び出し、タスク手順、承認などのコンパクトな実行更新。
ラベルは、エージェントが返信を開始するとすぐに表示されます。進行状況行は、エージェントが有用な作業更新を出した場合にのみ追加されます。可能な場合、最終回答は下書きを置き換えます。それ以外の場合、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 の組み込みの 1 語ラベルプールから選択します。 
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 はそのターンの古い単独のツール進行状況メッセージを抑制します。ラベルが設定されている場合を除き、最終回答までチャンネルは視覚的に静かなままです。

​
チャンネルの動作

各チャンネルは、対応している中で最もきれいなトランスポートを使用します。
チャンネル進行状況トランスポート注記
Discord1 つのメッセージを送信し、その後編集します。最終テキストは、安全なプレビューメッセージ 1 つに収まる場合、その場で編集されます。
Matrix1 つのイベントを送信し、その後編集します。アカウントレベルのストリーミング設定が、アカウントレベルの下書きを制御します。
Microsoft Teams個人チャット内のネイティブ Teams ストリーム。streaming.mode: "block" は Teams のブロック配信に対応します。
Slackネイティブストリームまたは編集可能な下書き投稿。スレッドの利用可否は、ネイティブストリーミングを使用できるかに影響します。
Telegram1 つのメッセージを送信し、その後編集します。最終タイムスタンプが有用なままになるよう、古い表示下書きが置き換えられる場合があります。
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 には Discord や Telegram で使用される同じ下書きプレビューのブロックモードがないため、streaming.mode: "block" は Teams のブロック配信として扱われます。

​
関連