推進草稿

進度草稿讓長時間執行的代理程式輪次在聊天中顯得有動態，而不會把對話變成一疊暫時狀態回覆。

啟用進度草稿時，OpenClaw 只會在該輪次證明正在執行實際工作後，建立一則可見的進行中訊息；在代理程式閱讀、規劃、呼叫工具或等待核准時更新它；並在頻道能安全處理時，把該草稿轉成最終答案。

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

當你希望在工具密集的工作期間只顯示一則整潔的狀態訊息，並在輪次完成時顯示最終答案時，請使用進度草稿。

快速開始

使用 streaming.mode: "progress" 逐頻道啟用進度草稿：

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

這通常就足夠了。OpenClaw 會選擇自動的一字標籤，等到工作持續至少五秒或發出第二個工作事件後，在有用工作發生時加入精簡的進度行，並抑制該輪次中重複的獨立進度閒聊。

使用者會看到什麼

進度草稿有兩個部分：

標籤會在代理程式開始有意義的工作，且持續忙碌五秒或發出第二個工作事件後出現。它是滾動進度行清單的一部分，因此一旦出現足夠具體的工作，起始狀態就會捲走。純文字回覆不會顯示進度草稿。只有在代理程式發出有用的工作更新時，才會加入進度行，例如 🛠️ Bash: run tests、🔎 Web Search: for "discord edit message" 或 ✍️ Write: to /tmp/file。 預設情況下，它們使用與 /verbose 相同的精簡說明模式；除錯時若也想附加原始命令／細節，請設定 agents.defaults.toolProgressDetail: "raw"。 在可行時，最終答案會取代草稿；否則 OpenClaw 會正常傳送最終答案，並依照頻道的傳輸方式清理草稿或停止更新草稿。

選擇模式

channels.<channel>.streaming.mode 控制可見的進行中行為：

當使用者更在意「正在發生什麼」，而不是逐 token 觀看答案文字串流時，請選擇 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,        },      },    },  },}

控制進度行

在進度模式中，進度行預設啟用。它們來自真實執行事件：工具開始、項目更新、任務計畫、核准、命令輸出、修補摘要，以及類似的代理程式活動。

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 預設會截斷過長的進度行，讓重複的草稿編輯不會在每次更新時以不同方式換行。前綴會保持可讀，而路徑或原始命令等長細節會用省略號縮短。

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 也會將 streaming.mode: "block" 視為 Teams 區塊傳遞，因為它沒有 Discord 和 Telegram 使用的相同草稿預覽區塊模式。

相關

• 串流與分塊
• 訊息
• 頻道設定
• Discord
• Matrix
• Microsoft Teams
• Slack
• Telegram