OpenClaw v2026.2.9 - 更新日志

### 新增 - iOS：新增 Alpha 节点应用及设置代码引导流程。(#11756) 感谢 @mbelinky。 - 频道：全面优化 BlueBubbles 并进行频道清理。(#11093) 感谢 @tyler6204。 - 插件：新增设备配对与手机控制插件（Telegram `/pair` 指令、iOS/Android 节点控制）。(#11755) 感谢 @mbelinky。 - 工具：将 Grok (xAI) 添加为 `web_search` 搜索提供商。(#12419) 感谢 @tmchow。 - 网关：为 Web UI 新增代理管理 RPC 方法（`agents.create`、`agents.update`、`agents.delete`）。(#11045) 感谢 @advaitpaliwal。 - Web UI：在聊天历史中显示压缩分隔线。(#11341) 感谢 @Takhoffman。 - 代理：在代理信封中包含运行时 Shell。(#1835) 感谢 @Takhoffman。 - 路径：新增 `OPENCLAW_HOME` 环境变量，用于覆盖内部路径解析所用的主目录。(#12091) 感谢 @sebslight。 ### 修复 - Telegram：强化引用解析；保留引用上下文；避免 QUOTE_TEXT_INVALID 错误；避免嵌套回复引用误分类。(#12156) 感谢 @rybnikov。 - Telegram：当使用过时的主题线程 ID 导致主动发送失败时，通过重试时不带 `message_thread_id` 参数来恢复发送。(#11620) - Telegram：使用 `<tg-spoiler>` HTML 标签渲染 Markdown 隐藏内容。(#11543) 感谢 @ezhikkk。 - Telegram：将命令注册条目截断至 100 条，避免启动时出现 `BOT_COMMANDS_TOO_MUCH` 错误。(#12356) 感谢 @arosstale。 - Telegram：将私聊 `allowFrom` 规则与发送者用户 ID 匹配（回退至聊天 ID），并优化配对日志清晰度。(#12779) 感谢 @liuxiaopai-ai。 - 引导流程：QuickStart 现在自动安装 Shell 补全功能（仅在手动安装时提示）。 - 认证：在存储/解析凭据前，清除粘贴的 API 密钥和令牌中嵌入的换行符。 - Web UI：优化聊天刷新，平滑滚动至最新消息，并在手动刷新时抑制新消息徽标闪烁。 - 工具/web_search：在网页搜索缓存键中包含提供商特定设置，并为 Grok 传递 `inlineCitations` 参数。(#12419) 感谢 @tmchow。 - 工具/web_search：规范化直接的 Perplexity 模型 ID，同时保持 OpenRouter 模型 ID 不变。(#12795) 感谢 @cdorsey。 - 模型故障转移：将 HTTP 400 错误视为可故障转移错误，启用自动模型回退机制。(#1879) 感谢 @orenyomtov。 - 错误处理：防止对话中提及“上下文溢出”主题时误触发上下文溢出检测。(#2078) 感谢 @sbking。 - 网关：修复压缩后记忆丢失问题；注入的转录写入现在会保留 Pi 会话的 `parentId` 链，使代理能够恢复记忆。(#12283) 感谢 @Takhoffman。 - 网关：修复多代理会话的使用量统计发现功能。(#11523) 感谢 @Takhoffman。 - 代理：修复因工具结果过大导致的上下文溢出问题（实施预限制与回退截断机制）。(#11579) 感谢 @tyler6204。 - 子代理/压缩：稳定公告触发时机，并在重试时保持压缩指标。(#11664) 感谢 @tyler6204。 - 定时任务：共享隔离的公告流程，并增强调度与投递的可靠性。(#11641) 感谢 @tyler6204。 - 定时任务工具：当 LLM 在添加请求中省略 `job` 包装器时，恢复扁平化参数。(#12124) 感谢 @tyler6204。 - 网关/CLI：当 `gateway.bind=lan` 时，使用局域网 IP 作为探测 URL 和控制 UI 链接。(#11448) 感谢 @AnonO6。 - 钩子：修复自 2026.2.2 版本（tsdown 迁移）以来捆绑钩子失效的问题。(#9295) 感谢 @patrickshao。 - 路由：在每次消息处理时通过加载配置来刷新绑定，使绑定变更无需重启即可生效。(#11372) 感谢 @juanpablodlc。 - 执行审批：以等宽字体渲染转发的命令，便于更安全地扫描审批内容。(#11937) 感谢 @sebslight。 - 配置：将 `maxTokens` 限制在 `contextWindow` 范围内，防止无效的模型配置。(#5516) 感谢 @lailoo。 - 思考：允许为 `github-copilot/gpt-5.2-codex` 和 `github-copilot/gpt-5.2` 模型启用 xhigh 模式。(#11646) 感谢 @LatencyTDH。 - Discord：支持论坛/媒体线程的创建起始消息，关联 `message thread create --message` 指令，并强化路由功能。(#10062) 感谢 @jarvis89757。 - 路径：结构化解析 `OPENCLAW_HOME` 派生的主目录路径，并修复工具元数据缩短功能中 Windows 盘符的处理问题。(#12125) 感谢 @mcaxtr。 - 记忆：为 Voyage 嵌入设置 `input_type` 以改进检索效果。(#10818) 感谢 @mcinteerj。 - 记忆/QMD：在代理间复用默认模型缓存，避免每个代理重复下载。(#12114) 感谢 @tyler6204。 - 媒体理解：支持识别 `.caf` 音频附件以进行转录。(#10982) 感谢 @succ985。 - 状态目录：遵循 `OPENCLAW_STATE_DIR` 环境变量设置默认设备身份和画布存储路径。(#4824) 感谢 @kossoy。

### Added - iOS: alpha node app + setup-code onboarding. (#11756) Thanks @mbelinky. - Channels: comprehensive BlueBubbles and channel cleanup. (#11093) Thanks @tyler6204. - Plugins: device pairing + phone control plugins (Telegram `/pair`, iOS/Android node controls). (#11755) Thanks @mbelinky. - Tools: add Grok (xAI) as a `web_search` provider. (#12419) Thanks @tmchow. - Gateway: add agent management RPC methods for the web UI (`agents.create`, `agents.update`, `agents.delete`). (#11045) Thanks @advaitpaliwal. - Web UI: show a Compaction divider in chat history. (#11341) Thanks @Takhoffman. - Agents: include runtime shell in agent envelopes. (#1835) Thanks @Takhoffman. - Paths: add `OPENCLAW_HOME` for overriding the home directory used by internal path resolution. (#12091) Thanks @sebslight. ### Fixes - Telegram: harden quote parsing; preserve quote context; avoid QUOTE_TEXT_INVALID; avoid nested reply quote misclassification. (#12156) Thanks @rybnikov. - Telegram: recover proactive sends when stale topic thread IDs are used by retrying without `message_thread_id`. (#11620) - Telegram: render markdown spoilers with `<tg-spoiler>` HTML tags. (#11543) Thanks @ezhikkk. - Telegram: truncate command registration to 100 entries to avoid `BOT_COMMANDS_TOO_MUCH` failures on startup. (#12356) Thanks @arosstale. - Telegram: match DM `allowFrom` against sender user id (fallback to chat id) and clarify pairing logs. (#12779) Thanks @liuxiaopai-ai. - Onboarding: QuickStart now auto-installs shell completion (prompt only in Manual). - Auth: strip embedded line breaks from pasted API keys and tokens before storing/resolving credentials. - Web UI: make chat refresh smoothly scroll to the latest messages and suppress new-messages badge flash during manual refresh. - Tools/web_search: include provider-specific settings in the web search cache key, and pass `inlineCitations` for Grok. (#12419) Thanks @tmchow. - Tools/web_search: normalize direct Perplexity model IDs while keeping OpenRouter model IDs unchanged. (#12795) Thanks @cdorsey. - Model failover: treat HTTP 400 errors as failover-eligible, enabling automatic model fallback. (#1879) Thanks @orenyomtov. - Errors: prevent false positive context overflow detection when conversation mentions "context overflow" topic. (#2078) Thanks @sbking. - Gateway: no more post-compaction amnesia; injected transcript writes now preserve Pi session `parentId` chain so agents can remember again. (#12283) Thanks @Takhoffman. - Gateway: fix multi-agent sessions.usage discovery. (#11523) Thanks @Takhoffman. - Agents: recover from context overflow caused by oversized tool results (pre-emptive capping + fallback truncation). (#11579) Thanks @tyler6204. - Subagents/compaction: stabilize announce timing and preserve compaction metrics across retries. (#11664) Thanks @tyler6204. - Cron: share isolated announce flow and harden scheduling/delivery reliability. (#11641) Thanks @tyler6204. - Cron tool: recover flat params when LLM omits the `job` wrapper for add requests. (#12124) Thanks @tyler6204. - Gateway/CLI: when `gateway.bind=lan`, use a LAN IP for probe URLs and Control UI links. (#11448) Thanks @AnonO6. - Hooks: fix bundled hooks broken since 2026.2.2 (tsdown migration). (#9295) Thanks @patrickshao. - Routing: refresh bindings per message by loading config at route resolution so binding changes apply without restart. (#11372) Thanks @juanpablodlc. - Exec approvals: render forwarded commands in monospace for safer approval scanning. (#11937) Thanks @sebslight. - Config: clamp `maxTokens` to `contextWindow` to prevent invalid model configs. (#5516) Thanks @lailoo. - Thinking: allow xhigh for `github-copilot/gpt-5.2-codex` and `github-copilot/gpt-5.2`. (#11646) Thanks @LatencyTDH. - Discord: support forum/media thread-create starter messages, wire `message thread create --message`, and harden routing. (#10062) Thanks @jarvis89757. - Paths: structurally resolve `OPENCLAW_HOME`-derived home paths and fix Windows drive-letter handling in tool meta shortening. (#12125) Thanks @mcaxtr. - Memory: set Voyage embeddings `input_type` for improved retrieval. (#10818) Thanks @mcinteerj. - Memory/QMD: reuse default model cache across agents instead of re-downloading per agent. (#12114) Thanks @tyler6204. - Media understanding: recognize `.caf` audio attachments for transcription. (#10982) Thanks @succ985. - State dir: honor `OPENCLAW_STATE_DIR` for default device identity and canvas storage paths. (#4824) Thanks @kossoy.