realvco Docs

v2026.3.7 — Context Engine 外掛架構 + 容器化大改

發布日期：2026 年 3 月 8 日 定位：架構級變更 + 多平台穩定性 Breaking Changes：1 項（Gateway auth mode）

整體概況

v2026.3.7 是 3 月份規模最大的版本，包含超過 230 項變更與修復。最重大的架構變更是引入可插拔 Context Engine——讓第三方可以用插件來提供替代的上下文管理策略。同時大幅強化 ACP 持久化通道繫結、Docker/Podman 多階段建構，以及幾乎所有通訊平台的穩定性修復。

核心亮點

1. Context Engine 外掛介面（全新架構）

這是 OpenClaw 走向「核心可插拔化」的重要里程碑。新增 ContextEngine 外掛插槽，提供完整生命週期掛鉤：

bootstrap → ingest → assemble → compact → afterTurn → prepareSubagentSpawn → onSubagentEnded
  • 採用 slot-based registry + 設定驅動的解析機制
  • LegacyContextEngine wrapper 保持向下相容
  • 透過 AsyncLocalStorage 為子代理提供 scoped runtime
  • 社群可開發如 lossless-claw 等替代壓縮策略

Context Engine 外掛讓「上下文管理」從核心邏輯變成可替換模組。也就是說，未來可以依照不同情境（長對話、多文件分析、程式碼審查）選用最合適的上下文策略。

2. ACP 持久化通道繫結

  • Discord channel 與 Telegram topic 繫結可持久化，重啟不遺失
  • Telegram /acp spawn 支援 --thread here|auto topic 繫結
  • 繫結成功在 topic 釘選確認訊息
  • Per-topic agentId 覆寫：不同 topic 路由到專屬 agent

3. Docker/Podman 容器化重大改進

  • 多階段建構（multi-stage build）：最終映像不含 build tools、源碼或 Bun
  • OPENCLAW_VARIANT=slim：可產出 bookworm-slim 精簡變體
  • OPENCLAW_EXTENSIONS：container build 時預裝選定的 bundled extension
  • 映像體積大幅縮小，啟動速度也明顯加快

4. 外掛系統大幅強化

  • prependSystemContext / appendSystemContext：靜態外掛引導文字可放入 system prompt
  • plugins.entries.<id>.hooks.allowPromptInjection 策略控制
  • 壓縮生命週期事件：session:compact:before / session:compact:after
  • Bundled plugins 從 monolithic import 遷至 scoped subpaths
  • 啟動效能改善：disabled plugin 跳過載入

5. Gateway SecretRef + 認證加固

  • gateway.auth.token 支援 SecretRef
  • API key 不再寫入 models.json、認證標籤移除 token 片段
  • 設定載入失敗時 fail closed
  • 新增 gateway run --password-file

Breaking Changes

gateway.auth.mode 需顯式設定。當 gateway.auth.token 與 gateway.auth.password 同時存在時，必須明確指定 token 或 password。否則啟動/配對/TUI 會失敗。

重要技術方向

上下文管理可插拔化

Context Engine 外掛讓社群可以開發替代壓縮策略，不需修改核心邏輯，為大型上下文管理帶來更多彈性。

容器化部署現代化

多階段建構 + slim variant + extension 預裝，持續改善容器化的部署體驗。

全平台通訊穩定性

LINE、Telegram、Discord、Feishu、Mattermost、Slack、WhatsApp、iMessage 都收到大量修復，特別是 LINE 的多項綜合修復整合了數十個 PR。

重要修復

  • Memory/Hybrid search BM25 排序：負值 FTS5 排序導致強匹配被排到弱匹配後面
  • TUI /new Session 隔離：多個 TUI client 互相收到對方回覆
  • Routing binding 擴展性：大型 binding 設定下 resolveAgentRoute 出現多秒停頓
  • Slack app_mention 競態去重：同一訊息觸發重複回覆
  • 設定載入 fail closed：無效設定不再靜默降級為寬鬆 defaults