v2026.3.24 — OpenAI 相容閘道 + Teams 官方 SDK
發布日期:2026 年 3 月 25 日 定位:功能增強 + 相容性擴展 Breaking Changes:無
整體概況
v2026.3.24 是 3 月份截至目前的最新穩定版,重點在 Gateway OpenAI 相容性大幅擴展、Microsoft Teams 全面遷移至官方 SDK、Skills 管理 UX 革新,以及多項安全與通道修復。主要目的是讓 OpenClaw Gateway 能更容易跟第三方生態整合。
核心亮點
1. Gateway OpenAI 相容性擴展
新增兩個關鍵端點,讓 OpenClaw Gateway 變成更完整的 OpenAI 相容 API 閘道:
GET /v1/models # 列出可用模型
POST /v1/embeddings # 向量嵌入
POST /v1/chat/completions # 轉發明確的模型覆寫
POST /v1/responses # 轉發明確的模型覆寫
也就是說,使用 OpenAI SDK 的第三方工具(RAG 管線、IDE 外掛、自動化腳本)可以直接指向 OpenClaw Gateway,不用改程式碼。
2. Microsoft Teams 全面遷移至官方 SDK
從自訂整合遷移至官方 Teams SDK,並加入 AI agent UX 最佳實踐:
| 功能 | 說明 |
|---|---|
| 串流回覆 | 1 對話即時串流 |
| 歡迎卡片 | Prompt starters 引導新使用者 |
| AI 標籤 | 原生 AI labeling 標示 |
| 狀態更新 | 資訊性狀態更新 + 打字指示器 |
| 訊息編輯/刪除 | 含 in-thread fallback |
3. Skills 管理 UX 革新
- 狀態篩選分頁:All / Ready / Needs Setup / Disabled(含計數)
- 點擊展開的詳細對話框:需求、開關、安裝動作、API 金鑰輸入
- Skills info 從「missing」軟化為「needs setup」+ 設定指引
- Bundled skills 新增一鍵安裝配方(coding-agent、gh-issues、weather 等)
4. Agent Tools 可見性
/tools 指令現在顯示當前 agent 實際可用的工具(非全部已安裝的):
- 新增精簡預設視圖 + 可選詳細模式
- Control UI 新增「Available Right Now」即時區段
- 提問前即可確認哪些工具可用
5. Slack 互動回覆豐富格式
- 恢復 direct delivery 的豐富回覆對等性
- 自動將尾部
Options:行渲染為按鈕/選擇器 - Reply controls 從 plugin interactive handlers 隔離
重要技術方向
Gateway 作為通用 OpenAI 閘道
新增 /v1/models 和 /v1/embeddings 是 OpenClaw 朝「完整 OpenAI 相容 API 閘道」邁出的關鍵一步,讓第三方整合變得容易很多。
Skills/Plugin 使用者體驗
一鍵安裝、缺失依賴提示、API 金鑰引導——讓 skill 安裝和設定變得更順暢。
Node.js 生態支援
支援的 Node 22 最低版本降至 22.14+。openclaw update 新增預檢 engines.node,避免在過期 Node 上安裝。
重要修復
- Sandbox 媒體派送繞過(安全):封閉
mediaUrl/fileUrl別名逸出 media-root 限制 - Gateway 通道啟動隔離:一個損壞通道不再阻擋後續通道啟動
- Gateway Restart Sentinel:透過 heartbeat 喚醒中斷的 session,保留 thread/topic 路由
- WhatsApp 群組回聲:追蹤 gateway 發送的 ID 僅抑制匹配回聲
- Docker 首次安裝:修復 gateway 啟動前的 pre-start loop 失敗