realvco Docs

v2026.3.24 — OpenAI 相容閘道 + Teams 官方 SDK

發布日期:2026 年 3 月 25 日 定位:功能增強 + 相容性擴展 Breaking Changes:無


整體概況

v2026.3.24 是 3 月份截至目前的最新穩定版,重點在 Gateway OpenAI 相容性大幅擴展Microsoft Teams 全面遷移至官方 SDKSkills 管理 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 失敗