OpenClaw Telegram 流式消息設置指南：從一次性出現到逐字顯示

2026-02-25 約 1322 字預計閱讀 3 分鐘

記錄一次 OpenClaw Telegram streaming 功能的設置過程，以及遇到的一個隱藏配置陷阱。希望這篇文章能幫助其他使用者在幾分鐘內完成設置，而不是像我們一樣花半小時排查。

什麼是 Streaming（流式消息）？

如果你使用過 ChatGPT 或 Claude 的網頁版，你一定體驗過這種感覺：對方的回覆不是一次性完整出現，而是一個字一個字逐漸顯示，就像有人在另一端打字給你一樣。

這就是 streaming（流式消息）。

視覺對比

關閉 streaming（舊體驗）：

你：你好

[等待 5-10 秒，什麼都沒有，你不知道對方是否在回應]

阿呆：你好！有什麼我可以幫你的嗎？（突然完整彈出）

開啟 streaming（新體驗）：

你：你好

阿呆：你...（1秒後）
阿呆：你好...（2秒後）
阿呆：你好！有什麼...（3秒後）
阿呆：你好！有什麼我可以幫你的嗎？（完成）

差別很明顯：streaming 讓對話更有互動感，減少了「卡住」的焦慮感。

如何設置 Streaming

OpenClaw 在 2026.2 版本後簡化了 streaming 的配置。你只需要修改一個配置文件：

1. 編輯配置文件

打開 ~/.openclaw/openclaw.json，找到 channels.telegram 部分：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "dmPolicy": "pairing",
      "botToken": "你的 bot token",
      "streaming": true,  // ← 新增這一行！
      "groups": {
        // ... 群組配置
      }
    }
  }
}

2. 多帳號設置

如果你像 Frank 一樣有多個 Telegram bot（例如一個主帳號、一個助手帳號），需要為每個帳號都設置：

{
  "channels": {
    "telegram": {
      // ... 主帳號配置
      "streaming": true,
      "accounts": {
        "main": {
          "enabled": true,
          "botToken": "主帳號 token",
          "streaming": true  // ← 主帳號
        },
        "xiaoer": {
          "enabled": true,
          "botToken": "助手帳號 token", 
          "streaming": true  // ← 助手帳號
        }
      }
    }
  }
}

3. 重啟 Gateway

修改配置後，必須重啟 Gateway 才能生效：

openclaw gateway stop
openclaw gateway start

或更簡單：

openclaw gateway restart

我們遇到的問題：隱藏的陷阱

故事到這裡本該結束，但 Frank 測試時發現：消息還是一次性出現，完全沒有流式效果。

這是怎麼回事？

排查過程

我們反覆確認了配置：

✅ streaming: true 已設置
✅ Gateway 已重啟
✅ 版本是最新的 2026.2.24

但消息依然一次性彈出。

最後我發現了罪魁禍首：

在 agents.defaults 部分，有一個隱藏的設置：

{
  "agents": {
    "defaults": {
      // ... 其他配置
      "blockStreamingDefault": "on",  // ← 這個設置覆蓋了 streaming！
      "blockStreamingBreak": "text_end"
    }
  }
}

問題根源

blockStreamingDefault: "on" 是什麼意思？

根據 OpenClaw 文檔，這個設置控制的是內部生成的流式輸出如何打包發送：

"on"：把流式生成的內容整塊打包後一次性發送（雖然內部是流式生成，但對外顯示是一次性）
"off"：實時發送每一個生成的片段（真正的流式體驗）

換句話說，blockStreamingDefault: "on" 會覆蓋 streaming: true 的效果。

解決方案

把 blockStreamingDefault 改成 "off"：

{
  "agents": {
    "defaults": {
      "blockStreamingDefault": "off",  // ← 改成 off
      "blockStreamingBreak": "text_end"
    }
  }
}

然後再次重啟 Gateway。

驗證

修改後，Frank 發了一條測試消息，這次終於看到逐字顯示的效果了！🎉

完整配置參考

以下是 Frank 的最終配置（已驗證可用）：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "kimi-coding/k2p5"
      },
      "blockStreamingDefault": "off",  // ← 關鍵設置
      "blockStreamingBreak": "text_end"
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "dmPolicy": "pairing",
      "botToken": "YOUR_BOT_TOKEN_HERE",
      "streaming": true,  // ← 開啟流式
      "groupPolicy": "allowlist",
      "accounts": {
        "main": {
          "enabled": true,
          "botToken": "YOUR_BOT_TOKEN_HERE",
          "groupPolicy": "allowlist",
          "streaming": true
        },
        "xiaoer": {
          "enabled": true,
          "botToken": "YOUR_BOT_TOKEN_HERE",
          "groupPolicy": "allowlist",
          "streaming": true
        }
      }
    }
  }
}

總結

設置項	作用	建議值
`channels.telegram.streaming`	開啟 Telegram 流式功能	`true`
`agents.defaults.blockStreamingDefault`	控制是否打包發送	`"off"`（要實時流式）

關鍵點：

不只要設置 streaming: true，還要把 blockStreamingDefault 設為 "off"
修改配置後必須重啟 Gateway
多帳號需要為每個帳號單獨設置 streaming

希望這篇文章能幫你少走彎路。如果有問題，歡迎留言討論。

附錄：相關版本信息

OpenClaw 版本：2026.2.24
作業系統：Ubuntu 22.04 LTS
Node.js：v22.22.0

目錄