realvco Docs

v2026.4.29 — Steering 預設打開 + People Wiki + 多個提供商擴充

發布日期：2026 年 4 月 29 日
定位：訊息流程 + 記憶 + 提供商三線同步進化
Breaking Changes：受限 profile（messaging、minimal）的 tools.exec/tools.fs 不再隱式放寬（需要顯式 alsoAllow）

核心亮點

1. Active-Run Steering 預設打開

跑到一半要修正方向，不必再等：

  • steer 模式預設啟用：在下一個 model 邊界 drain 所有 pending Pi steering messages
  • 舊的「一次處理一則」邏輯改成 queue 模式
  • 新增 500ms followup fallback debounce
  • 新增 steering queue 文件

2. Visible Reply Enforcement

新增全域 messages.visibleReplies 設定：

  • 強制可見輸出走 message(action=send) 對任何來源 chat
  • messages.groupChat.visibleReplies 仍可作群組 / 頻道覆寫

3. Subagent 路由 metadata

Gateway events 暴露 spawnedBy 在 subagent chat 和 agent broadcast payload：

  • Client 可以路由子 session 事件，不必再多查一次 session

4. Heartbeat 跟進承諾（commitments）

新增 opt-in inferred follow-up commitments：

  • 隱藏批次 extraction
  • per-agent / per-channel scoping
  • heartbeat delivery
  • CLI 管理
  • commitments.enabled / commitments.maxPerDay 簡單配置
  • heartbeat-interval due-time clamping（不會立刻 echo）

5. People-Aware Memory Wiki

記憶長成有人物意識的 wiki：

  • 代理人面向的人物 wiki metadata
  • 規範化別名
  • 人物卡片
  • 關係圖
  • 隱私 / 來源報告
  • 證據種類 drilldown
  • 搜尋模式：人物查找、問題路由、來源證據、原始 claim

6. Active Memory 進化

  • 可選的 per-conversation allowedChatIds / deniedChatIds filter（只對特定對話啟用召回）
  • 子代理人 timeout 時，回傳 bounded partial recall summary（包含預設 temporary-transcript path）
  • 新增 read-only doctor.memory.remHarness RPC，operator 可以預覽 bounded REM dreaming output

7. NVIDIA 提供商

新增 NVIDIA 提供商：

  • API-key onboarding
  • 設定文件
  • 靜態 catalog metadata
  • 字面 model-ref picker 支援（保留 provider prefix）

8. Bedrock Opus 4.7 Thinking 對齊

Bedrock 模型 ref 暴露完整 Claude Opus 4.7 thinking profile（xhigh、adaptive、max）：

  • Opus / Sonnet 4.6 維持 adaptive-by-default
  • /think 選單和驗證跟 Anthropic transport 一致

9. 大批次 Slack Block Kit 修補

Slack 多項邊界限制處理：

  • 互動 buttons / selects 維持在 Slack Block Kit value / count 限制內
  • 過長 button URL 直接丟掉但保留有效 callback values
  • 原生 approval metadata context 跟 update fallback text 都加上限制
  • 訊息工具呈現和 interactive blocks 在 Slack send 時合併
  • Block Kit fallback text 在 send 和 edit 都 cap 到 Slack send 限制

10. 跨頻道穩定批次

  • Telegram：streaming preview 改用 durable message edits（不再 flicker）；低 long-polling timeout 自動 clamp
  • Discord：唯讀 allowlist / default-target accessor 不再解析 SecretRef
  • WhatsApp：要拿到 Baileys outbound 訊息 ID 才標記 auto-reply 已送（過去失敗的群組回覆會誤標已送）
  • Microsoft Teams：(本次有相關 edge cases 修補)
  • Matrix：(本次有相關 edge cases 修補)
  • Feishu：空 text 訊息（如 {"text":""} 無媒體）跳過，避免下游 LLM 拒絕
  • Signal：群組 allowlist 比對 inbound group ID 和 sender ID；installer 下載有 timeout / size check / partial cleanup
  • Voice Call：pre-auth webhook in-flight limiting 在 socket remote address 缺失時仍維持

11. Gateway / 啟動 / 升級可靠度

  • Sysexits 78：systemd 偵測到 lock / EADDRINUSE 衝突時 exit 78（停止 Restart=always 的 plugin reload 重啟迴圈）
  • 開機 startup 跳過憑證-free tools.web.fetch 的 web-fetch 提供商發現（讓 Docker / K8s gateway 在有 fetch 限制時也能 bind）
  • Gateway/models 服務最後一次成功的 model catalog；stale reload 在背景 refresh
  • 安裝管線：OPENCLAW_SKIP_ONBOARDING 給自動化 Docker 安裝跳過互動 onboarding
  • Plugins runtime-deps：跨版本 container 升級不再 crash-loop on read-only image-layer 路徑
  • CLI/update：packaged Node compile cache 用 OpenClaw 版本和安裝 metadata scope 化（避免 global install 重用舊 chunk）

12. 安全強化

  • Tools 安全：tools.exec / tools.fs 不再隱式放寬限制 profile（messaging、minimal），需要 alsoAllow
  • OpenGrep 掃描：精確 OpenGrep rulepack、source-rule compiler、provenance metadata check、PR / 全掃描 workflow，傳 SARIF 到 GitHub Code Scanning
  • GHSA 分流政策：媒體 / base64 解碼和格式轉換的 overhead 在配置接受限制後分類為 performance-only（除非 demonstrate 限制 bypass、crash、exhaustion、data exposure）
  • Outbound HTML sanitize：plain-text sanitization 把 re-formed HTML tags 拿掉，nested tag fragments 不再留下 CodeQL-detected <script> 序列
  • Secrets：用 padded timing-safe buffers 比較 credential bytes（不再 hash candidate password）
  • QQBot：debug log argument 在寫入 console.* 前 sanitize，gateway payload 不能偽造 log lines
  • OAuth/secrets：root-level Google OAuth client_secret_*.json 下載被忽略，本地 client-secret 不會出現在 commit 候選名單

13. Control UI / i18n

語系登錄擴充新增 6 種：

  • 波斯文（fa）
  • 荷蘭文（nl）
  • 越南文（vi）
  • 義大利文（it）
  • 阿拉伯文（ar）
  • 泰文（th）

並支援 fa、nl、vi、zh-TW 文件 glossaries。

升級建議

  • 在意對話被打斷修正體驗的客戶：steering 預設打開值得試
  • 想做客服風 / 群組顯式回覆的客戶：messages.visibleReplies 可以強制
  • 心智 model 想做「人物 + 關係」記憶的客戶：People Wiki 是大幅升級
  • 用 NVIDIA 模型的客戶：直接升級
  • 在 Bedrock 跑 Opus 4.7 想用 thinking 的客戶：升級即享完整 profile
  • 用 Slack 大量互動 / 按鈕的客戶：邊界處理修補很有幫助
  • 用 Telegram / Signal / WhatsApp 群組的客戶：穩定性大幅提升
  • 受限 profile 用戶：注意 tools.exec / tools.fs 行為變更，需要 alsoAllow

這是當前 OpenClaw 的最新版本。

← v2026.4.27 · 回到列表