OpenClaw 2026.4.14 升级后 ~.openclaw 目录变更记录

OpenClaw 2026.4.14 升级后 ~/.openclaw 目录变更记录

一、版本升级自动产生的新增目录与文件

本文讨论的升级版本是2026.3.23-2 → 2026.4.14

本次更新引入了以下新功能模块，对应在 ~/.openclaw 下新建了数据库与数据目录：

新增路径	说明
`flows/registry.sqlite`	工作流（Flows）系统的注册表数据库，用于编排和管理可复用的工作流管线。
`tasks/runs.sqlite`	任务运行器（Tasks Runner）的执行记录数据库，用于跟踪异步任务的运行状态。
`qqbot/data/`	QQ Bot 渠道的数据目录，新版增加了对 QQ Bot 的内置支持或插件占位。
`logs/config-health.json`	新增的健康检查/配置审计日志，用于记录 Gateway 启动时的配置校验结果。
`openclaw.json.bak.2`	升级前自动生成的配置备份。OpenClaw 更新机制默认保留最近 3 份备份（`.bak`、`.bak.1`、`.bak.2`）。
`gateway.cmd`	服务启动脚本已更新：版本注释变为 `v2026.4.14`，内部环境变量（`OPENCLAW_SERVICE_VERSION` 等）同步刷新。
`update-check.json`	更新时间戳和版本号已刷新为 2026.4.14。

注意：升级完成后，日志提示 Run "openclaw doctor --fix" to apply changes.，原因通常是旧版 openclaw.json 缺少 flows、tasks 等新子系统的默认配置键，需要 doctor 执行迁移补全。

由于此前将飞书渠道从单账号模式重构为 accounts 多账号模式（main + march），OpenClaw 自动为每个 account 生成了隔离的凭证与去重缓存文件：

新增路径	说明
`credentials/feishu-main-allowFrom.json`	`main` 飞书 Bot 的 allowlist / pairing 凭证隔离文件。
`credentials/feishu-march-allowFrom.json`	`march` 飞书 Bot 的 allowlist / pairing 凭证隔离文件。
`feishu/dedup/main.json`	`main` 账号的消息去重缓存，防止重复处理同一条飞书事件。
`feishu/dedup/march.json`	`march` 账号的消息去重缓存。

在 openclaw update 自动重启服务阶段，报错：

Gateway install failed: Error: schtasks create failed: 错误: 拒绝访问。

原因：更新程序尝试刷新 Windows 计划任务（schtasks create）以匹配新版本二进制路径，但当前 shell 为普通用户权限，创建/修改计划任务需要管理员权限。

影响：

·openclaw 二进制和 gateway.cmd 已成功更新到 2026.4.14。

·计划任务未刷新，导致 openclaw gateway restart 调度启动时，Gateway 进程拉起后可能因配置未完全迁移而挂起（RPC probe: failed）。

修复建议：以管理员身份运行以下命令：

openclaw doctor --fix

openclaw gateway install

openclaw gateway restart

·OpenClaw 中文文档：https://docs.openclaw.ai/zh-CN

·OpenClaw Gateway 运行手册：https://docs.openclaw.ai/zh-CN/gateway