编者摘要：本次 Openclaw 新版本迭代，围绕架构重构、稳定性提升与能力扩展展开，对上一版本存在的调度瓶颈、工具调用受限、运维成本高等问题做针对性优化。上一版本核心定位是基础智能体执行框架，具备任务拆解、基础动作调用能力，但负载均衡能力弱，长任务易中断；记忆模块简单，多轮上下文容易丢失；可接入工具数量有限，监控指标偏少，仅能满足小规模验证场景，难以支撑企业级连续任务。
新版本重点升级底层调度引擎，优化任务分片与重试机制，大幅降低长任务失败率；重构记忆子系统，支持分层记忆存储，区分短期上下文与长期知识库，减少信息遗忘。对比旧版，工具接入接口标准化，新增插件热加载，无需重启即可扩展能力；完善全链路观测面板，可追踪每个动作耗时、token 消耗与异常日志，方便运维排查。
同时，新版本保留原有 API 兼容，旧业务代码改动量小，降低迁移成本。在资源开销上做了裁剪，同等任务下内存占用下降。短板方面，旧版部分废弃自定义插件需要改造后迁移，大规模并发场景仍需压力测试。整体来看，Openclaw 从原型验证工具升级为可落地的企业级智能体执行框架，适合多智能体协同、自动化业务流程场景。
20个关键问题问与答
-
Q：技能检索新特性的好处？A：减少 Prompt 占用，降低上下文成本，按需加载技能。 -
Q：Agent 检索到技能会自动运行吗？A：不会，仅读取说明，执行需要用户审批。 -
Q：MCP Apps 是什么？A：MCP 插件可在聊天侧边独立面板运行，读写工作区文件。 -
Q：备份支持哪些存储？A：本地外接盘、Cloudflare R2，支持加密。 -
Q：Code Mode 保存变量重启还在吗？A：是的，仅保存 JSON 小结果，普通单元格变量重置。 -
Q：Snooze 休眠会话任务还跑吗？A：后台继续执行，仅从活跃列表隐藏。 -
Q：Mac 新版本还需要手动装 Node 吗？A：全新打包安装不需要；老安装可迁移到内置运行时。 -
Q：模型列表是否需要重启网关刷新？A：不需要，支持动态更新。 -
Q：Workboard 旧数据升级前提？A：先升级到 2026.9.7，执行 doctor --fix。 -
Q：Bun-only 安装支持 macOS 和 Linux？A：支持，可不带 Node 运行 CLI。 -
Q：断网时 Web UI 能干什么？A：读缓存对话、编辑草稿；消息排队，联网校验后发送。 -
Q：聊天表情回复会触发 Agent 一轮执行吗？A：不会，Agent 在下一轮才感知。 -
Q：自动化任务失败自动修复的开关？A： failureAlert:false关闭修复请求和告警。 -
Q：子代理等待参数从 required 改成？A： awaitResults:true，旧 key 被忽略。 -
Q：Lobster 插件作用？A：交互式工作流，聊天内填写表单、暂停恢复流程。 -
Q：GitHub Sandbox 身份默认开启吗？A：默认关闭，开启有凭证泄露风险。 -
Q：Agents API 旧 authFingerprint 会话会自动迁移？A：不会，需要重置会话。 -
Q：Btrfs 数据库转换有什么风险？A：关闭文件校验和压缩，升级前必须完整备份。 -
Q：升级最重要前置操作？A：完整备份，检查旧数据是否需要中间版本迁移 + doctor 修复。 -
Q：插件开发者新增能力？A：监听会话变更、等待会话持久化，ClawHub 预览插件信息。
版本核心定位：智能体按需技能检索 + MCP 插件应用面板 + 外部存储备份 + 多端原生客户端增强 + 自动化工作流升级，大量底层运维、数据库、模型 / 提供商、安全权限修复。
一、新增 & 增强功能
1. 已安装技能发现（Installed-skill discovery）
智能体不再把全部技能库一次性塞进 Prompt，任务需要时才检索匹配的本地技能，支持嵌入式 Agent、Code Mode。
-
检索遵循当前读权限，只检索指令文本；匹配到后再单独读取完整技能说明 -
仅查询，不会自动安装 / 执行技能
2. MCP Apps 插件扩展（MCP Apps with conversations and files）
MCP 插件可在聊天侧边独立应用面板运行，支持挂载工作区文件、富表单预览：
-
可把内容附加到消息，支持临时授权重复调用工具 -
全屏 / 分栏布局自适应，支持明暗主题；文件编辑存在覆盖旧版本风险，需要提示审批策略 -
提供参考 Demo（PR #161747）
3. 外部存储备份（Backups on external storage）
备份支持外接磁盘、Cloudflare R2，可恢复到全新 staging 目录：
-
定时备份可选，自动清理过期备份，保留最新副本 -
支持加密密码 / 明文两种上传模式； --output可本地留存明文归档 -
跨语言状态提示与配置向导
4. Code Mode 会话存储
交互式 Code Mode 可保存小型 JSON 结果，跨单元格、对话重启复用；仅成功执行的单元格保存数据，变量每次执行重置。
-
旧版本值保留在历史记录与导出，有大小上限，累计历史可超限，保存告警需要查看日志。
5. 会话休眠（Conversation snooze）
Web 控制台可休眠会话：任务后台继续执行，但从活跃侧边栏隐藏；可手动唤醒、定时自动唤醒。归档 / 子会话 / 受保护会话不支持。移动端（iOS/Android）、Mac 原生客户端同样支持该能力。Demo PR #161960。
6. 打包桌面运行时（Mac + Linux）
-
Mac：全新安装自带运行时，无需手动装 Node/CLI；关闭 App 可选择后台保持网关运行 -
Linux：提供 Bun 打包版，支持纯 Bun 安装，无需 Node；切换运行时需要手动确认，切换失败无自动回滚
7. 模型目录动态更新
模型列表、价格无需重启 OpenClaw 即可刷新，正在运行任务保持原有模型信息；
-
OpenAI API 用户可直接选用账号内可用模型，早于内置目录更新 -
修复 DeepInfra、Vercel 价格解析异常（防止无穷大价格）
8. Workboard 会话看板
可选 Workboard 插件，用状态、规则、固定钉选组织会话，个人过滤器不影响其他人视图；看板 Agent 可协助整理。
⚠️ 2026.7 前旧 KV 数据需要先在 OpenClaw 2026.9.7 执行
doctor --fix升级，再升级本版本，否则数据异常。
9. 其他平台 & 体验增强
-
- Bun 独立安装
macOS/Linux 支持纯 Bun 环境运行 openclaw命令，优化 Codex 报错、大截图 / MCP 输出崩溃问题。 - 可续传 Worker 安装包
Worker 下载中断可断点续传；配对凭证有效期延长，注意凭证安全。 - npm 包精简
移除无关平台原生二进制，减小安装体积，减少更新失败；Docker 包补齐打包文件。 - 仅工作区会话支持图片查看
网关媒体库允许 Agent 读取截图、附件、生成图片；多用户网关存在跨会话媒体读取风险。 - 离线聊天能力
断网时可读缓存对话、编辑草稿、排队消息；联网重校验后发送；缓存存在浏览器本地安全风险。 - 草稿与消息恢复
侧边栏标记草稿，跨页面保留附件、目标；可恢复 / 删除未发送队列消息。 - 聊天多媒体
支持 YouTube 视频、本地音视频（最大 4GiB）；会话重启后附件 / 生成媒体依然可见。 - 聊天表情回复
多人会话可添加表情回复，不触发 Agent 新一轮调用，Agent 在下一轮感知表情。 - PR 工单控制
管理员可通过 CI 弹窗调度 Agent 执行 PR 任务，浏览器关闭后台继续执行；支持会话发布变更。 - 回复导航、跨会话更新、子代理等待状态
跳转原始消息、查看子代理等待任务、外部会话消息折叠展示。 - IM 移动端增强
iOS/iPad 支持直接粘贴截图进聊天；移动端查看 / 添加表情；Mac 原生侧边栏分组、颜色标记、批量管理会话，可浏览 Claude Code 会话。
10. 模型提供商新增能力
-
GitHub Copilot：内置 Claude Sonnet 5.5 / Opus 5.5 定义 -
Ollama Cloud：支持 GLM 5.3、Kimi K3、DeepSeek V4.1 Flash 的思考长度控制 -
Baseten 默认预置 DeepSeek V4.1 Flash -
新增 Ultrafast极速模式，用于 OpenAI Responses 路由，Codex 需手动开启 -
后台摘要 / 标题任务可复用主账号模型运行时
11. Agents API 增强
托管会话可限制 / 选择原生工具（如 web 搜索），MCP 权限与 OpenClaw 权限独立；支持 Streamable HTTP MCP 私有服务；可配置托管 VM 网络白名单，精确域名控制。
旧版 authFingerprint 绑定不再支持自动迁移，需要重置会话。
12. 自动化 / 定时任务（重点更新）
-
定时 Job 继承所属会话当前工具与权限，支持按任务名 / ID 检索作业日志 -
按需自动化：短任务直接返回结果；长任务后台执行，返回 Run ID 跟踪 -
连续失败作业可自动请求会话修复工作区问题，可关闭告警与自动修复 -
定时脚本支持 MCP 条件检查，无变更时跳过模型调用 -
Lobster 交互式工作流插件：聊天内回答表单、暂停、恢复、取消流程
13. 企业与团队权限
-
GitHub 登录绑定角色：管理员可预先按验证 GitHub 账号分配角色，用户首次登录生效 -
访客邀请与吊销：支持 GitHub 账号访客邀请，可批量吊销跨邮箱别名权限 -
Sandbox 内启用 GitHub 身份：可选开关，让 Docker/Podman 沙盒内 Agent 使用托管 GitHub 凭证（默认关闭，高风险） -
托管工作树：隐形子 Agent 使用独立 Git 工作目录，不占用侧边会话
14. 插件 SDK 开发者 API
插件可监听会话变更、等待会话落盘持久化；ClawHub 可在安装前预览插件 README、版本与信任信息；插件可保存独立会话状态。
15. 数据库、运维与诊断
-
数据库空间回收：SQLite 可回收已删除记录释放磁盘空间，停机执行 -
Btrfs 数据库专项维护：Linux Btrfs 离线转换，开启原地写入（关闭校验和压缩） -
更新前自动创建恢复副本：Doctor 修复、升级前自动备份配置 / 数据库，保留 30 天副本 -
中断更新修复：清理废弃更新任务，解决升级阻塞 -
大数据库异步校验：网关 UI 可先启动，数据库后台完成校验 -
Node 内存诊断：采集堆、请求内存指标，对接 Prometheus/OpenTelemetry；监控区分插件流量指标
二、Bug 修复与优化（Fixes and refinements）
分大类简要汇总：
- 安装 & 初始化
LM Studio/llama.cpp 地址错误可修正；网关端口冲突检测；多语言（简 / 繁中文）设置向导修复；macOS 虚拟机安装文档完善 - Web UI
聊天列表同步、归档撤销、长会话增量加载、工作目录校验、浏览器终端 RGB 色彩、媒体预览优化；权限变更实时生效 - 更新维护
升级校验逻辑、Windows 2026.9.4 自动更新问题修复；Doctor 修复会话所有权、配置迁移；旧版本数据需要中间版本迁移（重要，升级前务必备份） - 消息渠道
Telegram、Discord、Slack、WhatsApp、IMAP、Teams、飞书等消息队列、附件、媒体解析、回调迁移修复；旧渠道配置需要桥接版本迁移 - Memory 记忆模块
多语言记忆检索、重音 / 非拉丁字符检索；记忆索引死锁恢复；嵌入服务商断网自动重试；旧 Dreaming/Wiki JSON 格式不再自动导入，文件保留 - Skills 技能系统
无效技能不会覆盖有效版本；文件监听 CHOKIDAR_INTERVAL 配置；旧 .clawdbot元数据需要手动改名迁移；避免技能扫描误触发重启 - 原生客户端 Mac/iOS/Android
证书信任、录音、推送、数据库清理、连接切换缓存清理修复；安卓本地化翻译 - 模型 & 提供商
模型别名路由区分；Bedrock 凭证热更新；llama.cpp Windows 依赖修复；OpenRouter、Perplexity 请求 UA 头；工具调用失败重试限制；Codex 内存泄漏修复 - 自动化调度
定时任务状态持久化、邮件监听端口冲突、otel 链路追踪；任务中断状态处理 - 浏览器 / 电脑控制
Playwright Chromium ARM64 支持；Desktop 自动化 Peekaboo 4.7.0；SSR 私有网络配置 key 更名；清理逻辑优化 - 插件集成
插件重载等待、旧通知文件迁移；MCP 别名修复 - 安全权限
访客沙盒权限、审批审计日志、密钥掩码、Bun 运行时不再隐式安装包；共享会话权限校验；网关 CLI 与网关版本兼容性校验 - 其他底层
Linux 文件句柄耗尽保护；SQLite 并发死锁；NUL 字符命令拦截；管道、配置文件校验；资源释放优化
三、升级重要风险提示
-
部分历史数据（Workboard、Memory、渠道旧配置）必须先升级到指定中间版本并执行 doctor --fix，再升级 v2026.10.1，否则数据损坏。升级前完整备份。 -
Btrfs 数据库原地转换会关闭文件校验与压缩，必须先备份。 -
Sandbox 启用 GitHub 身份存在凭证泄露风险，默认关闭。 -
Agents API 旧 authFingerprint 会话绑定无法自动迁移，需要手动重建会话。 -
旧的 required参数废弃，子代理等待改用awaitResults:true。
四、总结
OpenClaw v2026.10.1 是面向 Agent 工具调用、MCP 插件生态、多端原生客户端与企业团队运维的大版本：解决 “技能库 Prompt 超限” 痛点，正式落地 MCP 应用面板，完善跨云 / 本地备份；强化自动化定时任务、子代理编排，同时大量补齐数据库、模型厂商、多 IM 渠道、权限审计、可观测性能力；适合自托管团队部署，但存在多处旧数据迁移前置依赖，升级操作需要分步执行并提前备份。