跳轉到主要內容

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.

進度草稿讓長時間執行的代理程式輪次在聊天中顯得有動態，而不會把對話變成一疊暫時狀態回覆。 啟用進度草稿時，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 會選擇自動的一字標籤，等到工作持續至少五秒或發出第二個工作事件後，在有用工作發生時加入精簡的進度行，並抑制該輪次中重複的獨立進度閒聊。

​
使用者會看到什麼

進度草稿有兩個部分：
部分用途
標籤簡短的起始／狀態行，例如 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觀看答案文字出現一則草稿會以最新答案文字編輯。
block較大的答案預覽區塊一則預覽會以較大的區塊更新或附加。
progress工具密集或長時間執行的輪次一則狀態草稿，接著是最終答案。
當使用者更在意「正在發生什麼」，而不是逐 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" 會在可用時附加底層命令／細節，這在除錯時很有用，但在聊天中會更吵雜。 例如，同一個命令會依細節模式不同而顯示不同：
模式進度行
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,
        },
      },
    },
  },
}
進度行會自動壓縮，以在編輯草稿時減少聊天泡泡的版面重排。 OpenClaw 預設會截斷過長的進度行，讓重複的草稿編輯不會在每次更新時以不同方式換行。前綴會保持可讀，而路徑或原始命令等長細節會用省略號縮短。 Slack 可以將進度行轉譯為結構化的 Block Kit 欄位，而不是單一文字本文： 
{
  channels: {
    slack: {
      streaming: {
        mode: "progress",
        progress: {
          render: "rich",
        },
      },
    },
  },
}
豐富轉譯會保留相同的純文字備援，因此不支援較豐富格式的頻道和用戶端仍可顯示精簡進度文字。 保留單一進度草稿，但隱藏工具和任務行： 
{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          toolProgress: false,
        },
      },
    },
  },
}
使用 toolProgress: false 時，OpenClaw 仍會抑制該輪次較舊的獨立工具進度訊息。除非設定了標籤，否則頻道會在最終答案前保持視覺上的安靜。

​
頻道行為

每個頻道都會使用它支援的最乾淨傳輸方式：
頻道進度傳輸方式備註
Discord傳送一則訊息，然後編輯它。當最終文字能放入一則安全預覽訊息時，就會就地編輯。
Matrix傳送一個事件，然後編輯它。帳戶層級串流設定會控制帳戶層級草稿。
Microsoft Teams個人聊天中的原生 Teams 串流。streaming.mode: "block" 會對應到 Teams 區塊傳遞。
Slack原生串流或可編輯草稿貼文。對話串可用性會影響是否能使用原生串流。
Telegram傳送一則訊息，然後編輯它。較舊的可見草稿可能會被替換，讓最終時間戳保持有用。
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 也會將 streaming.mode: "block" 視為 Teams 區塊傳遞，因為它沒有 Discord 和 Telegram 使用的相同草稿預覽區塊模式。

​
相關