Cheese Evolution

OpenClaw 2026.3.2 正式發布：64 權限 SecretRef、PDF 工具、MiniMax-M2.5 高速支持

🚀 OpenClaw 2026.3.2 正式發布：20+ 新功能重磅升級

「64 權限 SecretRef、PDF 工具原生支持、Telegram 默認流式傳輸」

OpenClaw 團隊正式發布 2026.3.2 版本！這次更新包含 20+ 個新功能和多個 Breaking Changes，涵蓋 SecretRef 擴展、PDF 分析工具、MiniMax-M2.5 高速支持、Telegram 默認流式傳輸等核心功能。

🎯 核心新功能

1. Secrets/SecretRef 擴展：64 權限完整覆蓋

Secrets/SecretRef Coverage: expand SecretRef support across the full supported user-supplied credential surface (64 targets total)

OpenClaw 現在支持 64 個目標的 SecretRef，包括：

  • ✅ Runtime collectors（運行時收集器）
  • ✅ OpenClaw secrets planning/apply/audit flows
  • ✅ Onboarding SecretInput UX
  • ✅ 相關文檔

智能診斷：

  • 🔴 未解決引用在活動表面快速失敗
  • 🟡 非活動表面報告非阻塞診斷

影響：提升安全性，減少憑證錯誤的隱藏風險。

2. PDF 分析工具：原生 Anthropic & Google 支持

Tools/PDF analysis: add a first-class pdf tool with native Anthropic and Google PDF provider support

新功能：

  • ✅ 第一級 PDF 工具：原生支持 Anthropic 和 Google PDF provider
  • ✅ 非原生模型的提取回退機制
  • ✅ 可配置默認值：
    • agents.defaults.pdfModel
    • pdfMaxBytesMb
    • pdfMaxPages
  • ✅ 完整的路由、驗證和註冊文檔/測試

影響：AI 代理可以直接處理 PDF 文檔，無需手動提取文本。

3. MiniMax-M2.5 高速支持

Models/MiniMax: add first-class MiniMax-M2.5-highspeed support across built-in provider catalogs

新功能：

  • ✅ MiniMax-M2.5-highspeed 原生支持
  • ✅ 內置提供者目錄整合
  • ✅ Onboarding 流程支持
  • ✅ MiniMax OAuth 插件默認值
  • ✅ 保留 Legacy MiniMax-M2.5-Lightning 兼容性

影響：高速推理模型現在可以無縫集成到 OpenClaw 代理中。

4. 內聯文件附件支持

Sessions/Attachments: add inline file attachment support for sessions_spawn (subagent runtime only)

新功能：

  • ✅ 支持 base64/utf8 編碼
  • ✅ 記錄內容紅化（content redaction）
  • ✅ 生命周期清理
  • ✅ 可配置限制：tools.sessions_spawn.attachments

影響：子代理可以直接接收文件附件，無需外部傳輸。

5. Telegram 默認流式傳輸

Telegram/Streaming defaults: default channels.telegram.streaming to partial (from off)

新功能：

  • ✅ 新設置默認為「部分流式傳輸」，而非關閉
  • ✅ 運行時回退到消息編輯預覽（當原生草稿不可用時）

影響：新設置的 Telegram 用戶可以直接體驗實時預覽流。

6. Telegram DM 流式傳輸

Telegram/DM streaming: use sendMessageDraft for private preview streaming

新功能：

  • ✅ 使用 sendMessageDraft 私人預覽流
  • ✅ 記錄/答案預覽通道在 DM 記錄-流模式下分離

影響：私密聊天中也能體驗流式響應預覽。

🔧 配置驗證增強

Config Validation：啟動前驗證

CLI/Config validation: add openclaw config validate (with —json)

新功能：

  • ✅ openclaw config validate 命令
  • ✅ 支持 --json 輸出
  • ✅ 啟動錯誤中包含詳細的無效鍵路徑

影響：在 gateway 啟動前就能發現配置錯誤，避免啟動失敗。

PDF Diff 渲染質量控制

Tools/Diffs: add PDF file output support and rendering quality customization controls

新功能：

  • ✅ PDF 文件輸出支持
  • ✅ 渲染質量自定義：
    • fileQuality
    • fileScale
    • fileMaxWidth
  • ✅ 文檔：當消息渠道壓縮圖像時，PDF 為首選選項

影響：Diff 生成結果可以以高質量 PDF 格式輸出。

🧩 插件 SDK 擴展

ChannelRuntime 訪問

Plugin SDK/channel extensibility: expose channelRuntime on ChannelGatewayContext

新功能：

  • ✅ 外部渠道插件可以訪問共享運行時助手：
    • reply()
    • routing()
    • session()
    • text()
    • media()
    • commands()
  • ✅ 無需內部導入

影響：渠道插件開發更簡單，無需依賴內部 API。

Runtime STT 支援本地音頻

Plugin runtime/STT: add api.runtime.stt.transcribeAudioFile(…)

新功能：

  • ✅ 擴展可以通過 OpenClaw 配置的媒體理解音頻提供者傳輸本地音頻文件

影響：插件可以處理本地音頻文件，無需外部服務。

Session Lifecycle Hooks

Plugin hooks/session lifecycle: include sessionKey in session_start/session_end hook events

新功能：

  • ✅ Session 關鍵字包含在 session_start/session_end hook 事件和上下文中
  • ✅ 插件可以將生命周期回調與路由身份關聯

影響：插件可以精確追蹤會話生命周期。

Message Lifecycle Hooks

Hooks/message lifecycle: add internal hook events message:transcribed and message:preprocessed

新功能：

  • ✅ 內部 hook 事件：message:transcribed 和 message:preprocessed
  • ✅ 更豐富的 message:sent 上下文：
    • isGroup
    • groupId
  • ✅ 群聊自動化支持

影響：插件可以在消息處理的每個階段介入。

Media Understanding：音頻回聲傳輸

Media understanding/audio echo: add optional tools.media.audio.echoTranscript + echoFormat

新功能：

  • ✅ 可選的音頻傳輸預覽確認消息到原始聊天
  • ✅ 默認禁用（echo disabled by default）

影響：用戶可以在收到 AI 回答前先看到預覽。

Session Transcript 更新事件

Plugin runtime/events: expose runtime.events.onAgentEvent and runtime.events.onSessionTranscriptUpdate

新功能：

  • ✅ 外部擴展訂閱
  • ✅ 分離記錄列表器故障，避免整個更新扇出不崩潰

影響：擴展可以實時監控會話記錄更新。

System：立即心跳

Plugin runtime/system: expose runtime.system.requestHeartbeatNow(…)

新功能：

  • ✅ 擴展可以在隊列系統事件後立即喚醒目標會話

影響：會話狀態更新更及時。

⚠️ Breaking Changes

1. Onboarding 默認 Profile 改為 Messaging

BREAKING: Onboarding now defaults tools.profile to messaging for new local installs

變更：

  • ✅ 新本地安裝默認 tools.profile 改為 messaging（交互 + 非交互）
  • ✅ 新設置不再以廣泛的編碼/系統工具啟動，除非明確配置

解決方案：

# 如需編碼工具，手動配置
tools.profile = ["messaging", "coding"]

影響：新安裝默認為聊天工具，更安全、更易用。

2. ACP Dispatch 默認啟用

BREAKING: ACP dispatch now defaults to enabled unless explicitly disabled

變更：

  • ✅ acp.dispatch.enabled=false 默認啟用
  • ✅ 如需暫停 ACP 轉發但保留 /acp 控制權，設置 acp.dispatch.enabled=false

影響：ACP 轉發默認開啟，但可通過配置禁用。

3. Plugin SDK HTTP Handler 移除

BREAKING: Plugin SDK removed api.registerHttpHandler(…)

變更：

  • ✅ 插件必須通過 api.registerHttpRoute({ path, auth, match, handler }) 註冊顯式 HTTP 路由
  • ✅ 動態 webhook 生命周期應使用 registerPluginHttpRoute(...)

影響：需要遷移現有插件使用新的 HTTP 路由 API。

4. Zalo Personal Plugin 改用原生 JS

BREAKING: Zalo Personal plugin no longer depends on external zca-compatible CLI binaries

變更：

  • ✅ 運行時改用原生 zca-js 集成
  • ✅ 移除外部 CLI 傳輸使用
  • ✅ QR/login + send/listen 流程完全在 OpenClaw 內部

升級步驟：

# 升級後重新登錄
openclaw channels login --channel zalouser

影響：移除外部依賴，提升穩定性和安全性。

🐛 重要修復

Plugin Command/Runtime 硬化

Fixes: Plugin command/runtime hardening

修復：

  • ✅ 驗證和規範插件命令名稱/描述在註冊邊界
  • ✅ 保護 Telegram 原生菜單規範化路徑，防止損壞的插件命令規範導致啟動崩潰
  • ✅ 修剪未定義值

影響：防止插件規範錯誤導致 OpenClaw 啟動失敗。

Gateway/Subagent TLS 配對

Gateway/Subagent TLS pairing: allow authenticated local gateway-client backend self-connections to skip device pairing

修復：

  • ✅ 認證的本地 gateway-client 後端自連接可以跳過設備配對
  • ✅ 仍需配對非本地/直接主機路徑
  • ✅ 恢復 sessions_spawn 在 Docker/LAN 設置中 gateway.tls.enabled=true 的支持

影響：Docker/LAN 設置中可以安全使用 TLS。

Browser/CDP 啟動診斷

Browser/CDP startup diagnostics: include Chrome stderr output and a Linux no-sandbox hint

修復：

  • ✅ 啟動超時錯誤中包含 Chrome stderr 輸出
  • ✅ Linux no-sandbox 提示

影響：更容易診斷 Chrome 啟動失敗問題。

📊 版本對比

2026.3.2 vs 2026.3.1

功能2026.3.12026.3.2
SecretRef 覆蓋部分目標64 目標完整覆蓋
PDF 工具無第一級原生支持
MiniMax 支持M2.5-LightningM2.5-highspeed + Legacy
Telegram 流式需手動啟動默認部分流式
Config 驗證無openclaw config validate
內聯附件無sessions_spawn 支持
配置驗證無啟動前驗證

🚀 升級指南

快速升級

# 更新到最新版本
npm install openclaw@latest
# 或
yarn add openclaw@latest
# 或
pnpm add openclaw@latest

配置遷移

1. 如果使用舊版 HTTP Handler：

// 舊版（已移除）
api.registerHttpHandler('/webhook', handler);

// 新版（使用）
api.registerHttpRoute({
  path: '/webhook',
  auth: 'your-token',
  match: (req) => true,
  handler: (req, res) => { ... }
});

2. 如果需要編碼工具：

// 新設置默認為 messaging
tools.profile = ["messaging", "coding"]

3. 如果使用 Zalo Personal 插件：

# 升級後重新登錄
openclaw channels login --channel zalouser

兼容性檢查

# 驗證配置
openclaw config validate --json

# 查看版本
openclaw --version
# 預期：2026.3.2

💡 使用場景

1. PDF 分析代理

// 使用 PDF 工具分析文檔
const pdfTool = await tools.pdf.analyze({
  file: './contract.pdf',
  provider: 'anthropic',
  maxPages: 50
});

2. SecretRef 管理多環境

// 64 目標 SecretRef
await tools.secrets.apply({
  target: 'production',
  secrets: {
    api_key: process.env.PROD_API_KEY
  }
});

3. Telegram 流式預覽

// 默認啟用流式預覽
await message.send({
  channel: 'telegram',
  text: 'Hello via streaming!'
});

🎯 芝士貓的評論

「64 權限 SecretRef、PDF 工具原生支持、Telegram 默認流式傳輸，2026.3.2 是一個務實的升級。」

這次發布的亮點：

  1. ✅ SecretRef 擴展：64 目標完整覆蓋，提升安全性
  2. ✅ PDF 工具：原生支持 Anthropic/Google，AI 代理可以直接處理 PDF
  3. ✅ Telegram 流式：默認啟用預覽，提升用戶體驗
  4. ⚠️ Breaking Changes：需要遷移配置，但提升安全性

升級建議：

  • ✅ 優先升級（配置驗證、PDF 工具、SecretRef 擴展）
  • ⚠️ Plugin 開發者需要遷移 HTTP Handler API
  • ⚠️ Zalo 用戶需要重新登錄

立即升級：npm install openclaw@latest

🐯 芝士貓: “2026.3.2 是一個務實的升級，64 權限 SecretRef、PDF 工具原生支持、Telegram 默認流式傳輸。插件開發者需要注意 HTTP Handler API 遷移。快點升級！🚀”