# v5.4.5

### 升级 openclaw 至 v2026.4.24

**Browser Extensions 重要变更（v2026.4.22 → v2026.4.24）：**

- **新增坐标点击动作**：`act kind="coordinateClick"` 支持通过 x/y 坐标点击，补充 aria ref 定位之外的场景
- **默认 act 超时预算**：修复了 act 操作的默认超时时间设定，避免长时间 act 任务意外被截断（与 patch 005 env var 支持互补）
- **per-profile headless 配置**：每个浏览器 profile 可独立配置 headless/有头模式，不再全局统一
- **稳定 tab 句柄 + 自动化技能**：新增 tab handle 机制，跨多步操作可稳定引用同一标签页；新增 `automation skill` 供 agent 调用
- **Doctor 诊断工具**：新增 `browser doctor` 命令，agent 可直接调用浏览器诊断，并向用户展示结构化诊断信息
- **已有 session 附加修复**：修复 existing-session 附加时的端口冲突、超时判定、WS 状态探测等多个问题（#57245）
- **Chrome profile 锁恢复**：自动检测并恢复 Chromium profile 锁文件异常，减少需手动清理的情况（#62935）
- **空闲 tab 自动关闭**：`/new`、`/reset` 或会话归档时自动关闭已跟踪的浏览器标签，防止跨 session 泄漏
- **Linux 可执行文件路径扩展**：新增 `/opt/google`、`/opt/brave.com`、`/usr/lib/chromium*` 等检测路径（#48563）
- **Browser Realtime Talk**：Talk/Voice Call/Google Meet 可通过 realtime voice loop 调用完整 agent 能力

**Google Meet 首次作为内置 plugin 发布**（bundled participant plugin，含个人 Google 认证、Chrome/Twilio 实时会话、会议记录/出席名单导出、已开启 Meet 标签的恢复工具）

**其他变更：**
- DeepSeek V4 Flash/Pro 加入内置 catalog，V4 Flash 成为新用户默认模型
- 多项安全修复（跨 bot token replay、sandbox browser SSRF、secrets BOM 清理等）
- Plugin 启动性能优化：静态 model catalog、按需加载 provider 依赖

**patch 状态：**
- patch 002、005 无需调整，直接通过
- patch 003（act-field-validation）因 `executeActAction` 函数签名新增 `onTabActivity` 参数导致上下文行号偏移，已重新生成



### 升级 openclaw 至 v2026.4.22

- 同步上游变更（2298 commits，含 telegram/discord 优化、thinking 模型默认级别修复、session 路由保持、wecom/azure openai 等改进）
- patch 001（suppress-stale-reply context）针对新版上下文行偏��重新生成，`--check` 直接通过

# v5.5

### 架构调整

- **patches 与 addon 分离**：将代码补丁（`patches/*.patch`）、插件（`patches/suppress-stale-reply`）和依赖覆盖（`patches/overrides.sh`）从 `addons/officials/` 迁移至项目根目录 `patches/`，作为 wiseflow 的共性基础能力，对所有 addon 生效。addon 不再支持 patches 层，仅提供额外全局技能和 Crew 模板。

- **默认全局技能重新划分**：`smart-search`、`browser-guide` 从 addon 专属技能迁移至 `skills/`（项目根目录），成为 wiseflow 所有 crew 默认可用的内置技能，无需依赖 official addon 即可生效。

- **`apply-addons.sh` 重构**：先应用 `patches/` 下的基础补丁和覆盖，再安装默认全局技能（`skills/`），最后逐 addon 安装额外技能和 Crew 模板。addon 加载流程简化为两层（skills → crew），移除原有的 overrides 和 patches 层。

### 升级 openclaw 至 v2026.4.15

- 同步上游变更（详见 openclaw release notes）
- patch 001（suppress-stale-reply context）针对 `deliver.ts` 重构（OutboundPayloadPlan 架构调整）重新生成
- patch 005（codex apiKey）已被上游原生集成，移除

# v5.4

### 新增

- **suppress-stale-reply 插件 + patch 001**：用户连续快速发送多条消息时，agent 对被超越消息的回复不再发送给用户，但仍写入对话历史供下一轮上下文使用，最终用户只看到对最新消息的回复。所有走标准 inbound/outbound 路径的 channel（feishu / awada / wecom / cli 等）自动获得该能力。`/`-前缀的指令型回复（如 `/kb`、`/cc`）放行，不参与抑制。可通过 `OPENCLAW_SUPPRESS_STALE_REPLY=0` 关闭

# v5.3

### 新增

- **新媒体运营 Crew 模板（selfmedia-operator）**：内置文生图（siliconflow-img-gen）、文生视频（siliconflow-video-gen）技能，提供完整的选题研究→图文输出、草稿扩写→完整文章两套工作流；配图优先策略（用户素材 > 免版权图片 > AI 生成 > 历史复用），素材统一归档至 `campaign_assets/`

- **smart-search 新增平台**：百度贴吧（全局搜索 + 指定吧搜索）、Amazon（含分类/排序过滤），YouTube 新增类型过滤（shorts/video/channel）及"最近1小时"时间过滤

### 改进

- **升级 OpenClaw 至 v2026.4.11**：同步上游安全加固（Browser/security SSRF 防御增强、exec 沙箱安全、媒体访问鉴权）、Dreaming/Active Memory 功能（内存子智能体、日记视图、REM 回���）、Ollama/vLLM/Feishu/Teams 若干 bug 修复；原 patch 004（web_fetch RFC2544 支持）已被上游原生集成，改为配置项并同步到 `config-templates/openclaw.json`

- **sales-cs 数据库访问重构**：将所有客户数据库操作改为命名脚本（`skills/customer-db/scripts/`），禁止直接执行 SQL，增强安全性和可维护性

- **sales-cs 消息防重**：修复工具调用轮次中输出面向客户文本导致重复消息的问题；统一 customerdb hook 与命令路径的 peer 规范化逻辑

- **smart-search 搜索引擎策略调整**：主推 Bing（国内网络稳定可用），百度降为 backup，Quark 降为 fallback，移除 Google（国内经常不可用）

- **系统配置**：修复 setup-crew 中所有 agent 的 reasoningDefault 未正确关闭的问题

### 文档

- `docs/quick_start.md` 新增"推荐上手三步走"：含招募对内/对外 crew、注入业务背景、IT Engineer 运维的完整对话示例

- README 完善：补充 openclaw clone 步骤；新增 opencli 致谢

# v5.2

- combine ofb and wiseflow
- publish sales-db and self-media operator

# v5.0

upgrage workflow to Agent!

# v4.32
- bug fix；

- import error\can not work when use rss souces only.

- update patchright to 1.57.2

- clean useless code

# v4.3.1

- 后端新增 info_stat 统计接口，并补齐 user_notify、user_prompt、ws_ping 等前端交互相关接口。

  Added info_stat statistics endpoint and completed frontend interaction endpoints such as user_notify, user_prompt, and ws_ping.

- read_info 参数与 task time_slots 枚举同步为当前实现。

  Synced read_info parameters and task time_slots enum with the current implementation.

- 后端接口文档更新，移除已弃用的 mc_backup_accounts CRUD 说明。

  Updated backend API docs and removed deprecated mc_backup_accounts CRUD descriptions.

# v4.30

- 升级为与 pro 版本一样的架构，同时具有一样的 api，可无缝共享 [wiseflow+](https://github.com/TeamWiseFlow/wiseflow-plus) 生态！

  Upgraded to the same architecture as the pro version, with the same api, seamlessly sharing the [wiseflow+](https://github.com/TeamWiseFlow/wiseflow-plus) ecosystem!

# v4.2

- 全新的网页爬取方案，使用 patchright 直连本地用户真实浏览器，从而实现更加强大的反爬虫伪装能力，以及提供用户数据持久化留存等特性；

  Brand new web crawling solution: uses patchright to directly connect to the user's real local browser, providing much stronger anti-crawling disguise capabilities and features like persistent user data storage.

- 配套提供预登录、清除、深度清除脚本

  Provided supporting scripts for pre-login, cleanup, and deep cleanup.

- 大幅简化 web crawler相关的 config

  Greatly simplified web crawler-related configuration.

- 新增了proxy方案（支持直连提供商服务器，动态获取，本地缓存）

  Added a new proxy solution (supports direct connection to provider servers, dynamic acquisition, and local caching).

- 整合 Crawler4ai script 方案，提供网页操作能力

  Integrated Crawler4ai script solution, enabling web page operation capabilities.

- 重构搜索引擎方案，适配新的爬取方案并修复一些累积问题

  Refactored search engine solution to adapt to the new crawling approach and fixed some accumulated issues.

- 升级 docker 部署方案，适配全新的打包 work flow。

  Upgraded Docker deployment solution to fit the brand new packaging workflow.


# v4.1

- 通用llm提取支持设定 role 和 purpose，从而实现更加精准的提取

  Universal LLM extraction supports setting role and purpose, enabling more precise extraction

- 社交平台信源增加查找创作者详情的功能

  Added functionality to search for creator details in social media platform sources

- 增加自定义精准搜索功能（自定义 info 提取字段）

  Added custom precision search functionality (custom info extraction fields)

- 可以为关注点指定搜索源，目前支持 bing、github、arxiv、ebay 四个源，并且全部使用平台原生接口，无需额外申请并配置第三方 key

  Can specify search sources for focus points, currently supporting four sources: bing, github, arxiv, ebay, all using platform native interfaces without requiring additional third-party key applications and configurations

- 优化的缓存以及缓存遗忘机制

  Optimized caching and cache forgetting mechanisms

- 修复快手平台搜索结果为空时的错误处理

  Fixed error handling when Kuaishou platform search results are empty

# v4.0

- 深度重构 Crawl4ai（0.6.3）和 MediaCrawler， 并整合引入 Nodriver，大幅提升获取能力，支持社交平台内容获取（4.0版本提供对微博和快手平台的支持）；

  Deeply refactored Crawl4ai (0.6.3) and MediaCrawler, integrated Nodriver, significantly enhanced content acquisition capabilities, supporting social media platform content retrieval (version 4.0 provides support for Weibo and Kuaishou platforms);

- 全新的架构，混合使用异步和线程池，大大提升处理效率（同时降低内存消耗）；

  New architecture utilizing a hybrid approach of async and thread pools, greatly improving processing efficiency (while reducing memory consumption);

- 继承了 Crawl4ai 0.6.3 版本的 dispacher 能力，提供更精细的内存管理能力；

  Inherited the dispatcher capabilities from Crawl4ai 0.6.3 version, providing more refined memory management capabilities;

- 深度整合了 3.9 版本中的 Pre-Process 和 Crawl4ai 的 Markdown Generation流程， 规避了重复处理；

  Deeply integrated the Pre-Process from version 3.9 and Crawl4ai's Markdown Generation process, avoiding duplicate processing;

- 放弃了通过 pocketbase 的api 进行数据库操作，改为直接读写 sqlite 数据库，因此无需用户在 .env 中提供pocketbase的账密，也规避了登录过期导致数据库无法读写，从而产生大量日志的隐患；

  Abandoned database operations through PocketBase API, switched to direct SQLite database read/write, eliminating the need for users to provide PocketBase credentials in .env, and avoiding the risk of database read/write failures due to login expiration that could generate excessive logs;

- 优化 llm 处理策略，更加符合思考模型的特性；

  Optimized LLM processing strategy to better align with the characteristics of thinking models;

- 优化了对 RSS 信源的支持；

  Enhanced support for RSS sources;

- 优化了代码仓文件结构，更加清晰且符合当代 python 项目规范；

  Optimized repository file structure, making it clearer and more compliant with contemporary Python project standards;

- 改为使用 uv 进行依赖管理，并优化了 requirement.txt 文件；

  Switched to using uv for dependency management and optimized the requirement.txt file;

- 优化了启动脚本（提供提供 windows 版本），真正做到"一键启动"；

  Optimized startup scripts (including Windows version), achieving true "one-click startup";

- 优化了日志输出，增加 recorder 总结，并提供更精细化的日志输出控制。

  Enhanced log output, added recorder summaries, and provided more granular log output control.


# v3.9-patch3

- 更改版本号命名规则

  Change version number naming rules

- 诸多累积修复

  Numerous cumulative fixes

# v0.3.9-patch2

- 定制更改 crawl4ai 0.4.30 版本，以取得更好的性能

  Modified crawl4ai version 0.4.30 for better performance

- 相应的更改 core/requirements.txt

  Corresponding changes to core/requirements.txt

- 更改 prompt，但未在 qwen2.5-14b 模型上发现改进

  Modified the prompt, but no improvements were found on the qwen2.5-14b model


# V0.3.9

- 适配 Crawl4ai 0.4.248 版本，优化了性能

  Adapt to Crawl4ai 0.4.248 version, optimized performance

- 累积 bug 修复

  Cumulative bug fixes

- 增加 docker 运行方案（感谢 @braumye 贡献）

  Added docker running solution (thanks to @braumye for contributing)


# V0.3.8

- 增加对 RSS 信源的支持

  add support for RSS source

- 支持为关注点指定信源，并且可以为每个关注点增加搜索引擎作为信源

  support to specify source for each focus point, and add search engine as source

- 进一步优化信息提取策略（每次只处理一个关注点）

  Further optimized information extraction strategy (processing one focus point at a time)

- 优化入口逻辑，简化并合并启动方案 （感谢 @c469591 贡献windows版本启动脚本）

  Optimized entry logic, simplified and merged startup solutions (thanks to @c469591 for contributing Windows startup script)


# V0.3.7

- 新增通过wxbot方案获取微信公众号订阅消息信源（不是很优雅，但已是目前能找到的最佳方案）
  
  Added WeChat Official Account subscription message source acquisition through wxbot solution (not very elegant, but currently the best solution available)

- 升级适配 Crawl4ai 0.4.247 版本，

  Upgraded to fit Crawl4ai 0.4.247 version,

- 通过新增预处理流程以及全新设计的推荐链接提取策略，大幅提升信息抓取效果，现在7b 这样的小模型也能比较好的完成复杂关注点（explanation中包含时间、指标限制这种）的提取了。

  Through the addition of a new pre-processing process and a completely redesigned recommended link extraction strategy, the information capture effect has been significantly improved, and now even small models like 7b can better complete the extraction of complex focus points (such as time and index limits in the explanation).

- 提供自定义提取器接口，方便用户根据实际需求进行定制。

  Provided a custom extractor interface to allow users to customize according to actual needs.

- bug 修复以及其他改进（crawl4ai浏览器生命周期管理，异步 llm wrapper 等）（感谢 @tusik 贡献）

  Bug fixes and other improvements (crawl4ai browser lifecycle management, asynchronous llm wrapper, etc.)

  Thanks to @tusik for contributing

# V0.3.6
- 改用 Crawl4ai 作为底层爬虫框架，其实Crawl4ai 和 Crawlee 的获取效果差别不大，二者也都是基于 Playwright ，但 Crawl4ai 的 html2markdown 功能很实用，而这对llm 信息提取作用很大，另外 Crawl4ai 的架构也更加符合我的思路；

  Switched to Crawl4ai as the underlying web crawling framework. Although Crawl4ai and Crawlee both rely on Playwright with similar fetching results, Crawl4ai's html2markdown feature is quite practical for LLM information extraction. Additionally, Crawl4ai's architecture better aligns with my design philosophy.

- 在 Crawl4ai 的 html2markdown 基础上，增加了 deep scraper，进一步把页面的独立链接与正文进行区分，便于后一步 llm 的精准提取。由于html2markdown和deep scraper已经将原始网页数据做了很好的清理，极大降低了llm所受的干扰和误导，保证了最终结果的质量，同时也减少了不必要的 token 消耗；

  Built upon Crawl4ai's html2markdown, we added a deep scraper to further differentiate standalone links from the main content, facilitating more precise LLM extraction. The preprocessing done by html2markdown and deep scraper significantly cleans up raw web data, minimizing interference and misleading information for LLMs, ensuring higher quality outcomes while reducing unnecessary token consumption.

   *列表页面和文章页面的区分是所有爬虫类项目都头痛的地方，尤其是现代网页往往习惯在文章页面的侧边栏和底部增加大量推荐阅读，使得二者几乎不存在文本统计上的特征差异。*
   *这一块我本来想用视觉大模型进行 layout 分析，但最终实现起来发现获取不受干扰的网页截图是一件会极大增加程序复杂度并降低处理效率的事情……*

  *Distinguishing between list pages and article pages is a common challenge in web scraping projects, especially when modern webpages often include extensive recommended readings in sidebars and footers of articles, making it difficult to differentiate them through text statistics.*

  *Initially, I considered using large visual models for layout analysis, but found that obtaining undistorted webpage screenshots greatly increases program complexity and reduces processing efficiency...*
  
- 重构了提取策略、llm 的 prompt 等；

  Restructured extraction strategies and LLM prompts;

  *有关 prompt 我想说的是，我理解好的 prompt 是清晰的工作流指导，每一步都足够明确，明确到很难犯错。但我不太相信过于复杂的 prompt 的价值，这个很难评估，如果你有更好的方案，欢迎提供 PR*

   *Regarding prompts, I believe that a good prompt serves as clear workflow guidance, with each step being explicit enough to minimize errors. However, I am skeptical about the value of overly complex prompts, which are hard to evaluate. If you have better solutions, feel free to submit a PR.*

- 引入视觉大模型，自动在提取前对高权重（目前由 Crawl4ai 评估权重）图片进行识别，并补充相关信息到页面文本中；

  Introduced large visual models to automatically recognize high-weight images (currently evaluated by Crawl4ai) before extraction and append relevant information to the page text;

- 继续减少 requirement.txt 的依赖项，目前不需要 json_repair了（实践中也发现让 llm 按 json 格式生成，还是会明显增加处理时间和失败率，因此我现在采用更简单的方式，同时增加对处理结果的后处理）

  Continued to reduce dependencies in requirement.txt; json_repair is no longer needed (in practice, having LLMs generate JSON format still noticeably increases processing time and failure rates, so I now adopt a simpler approach with additional post-processing of results)

- pb info 表单的结构做了小调整，增加了 web_title 和 reference 两项。

  Made minor adjustments to the pb info form structure, adding web_title and reference fields.

- @ourines 贡献了 install_pocketbase.sh 脚本

  @ourines contributed the install_pocketbase.sh script

- @ibaoger 贡献了 windows 下的pocketbase 安装脚本

  @ibaoger contributed the pocketbase installation script for Windows

- docker运行方案被暂时移除了，感觉大家用起来也不是很方便……

  Docker running solution has been temporarily removed as it wasn't very convenient for users...

# V0.3.5
- 引入 Crawlee(playwrigt模块)，大幅提升通用爬取能力，适配实际项目场景；
  
  Introduce Crawlee (playwright module), significantly enhancing general crawling capabilities and adapting to real-world task;

- 完全重写了信息提取模块，引入"爬-查一体"策略，你关注的才是你想要的；

  Completely rewrote the information extraction module, introducing an "integrated crawl-search" strategy, focusing on what you care about;

- 新策略下放弃了 gne、jieba 等模块，去除了安装包；

  Under the new strategy, modules such as gne and jieba have been abandoned, reducing the installation package size;

- 重写了 pocketbase 的表单结构；
  
  Rewrote the PocketBase form structure;

- llm wrapper引入异步架构、自定义页面提取器规范优化（含 微信公众号文章提取优化）；

  llm wrapper introduces asynchronous architecture, customized page extractor specifications optimization (including WeChat official account article extraction optimization);

- 进一步简化部署操作步骤。

  Further simplified deployment steps.
