秀秀 3.225 - OpenClaw执行配置单一权威与自动同步

记录日期：中国时间 2026-08-22；不可覆盖快照 ID：b15c5a244a6e47f3260545aee3d09d464d074a7a5e5a9a1430ddd51916768db3

记录完整性：九项详细记录完整

## 秀秀 3.225 - OpenClaw执行配置单一权威与自动同步

- 建立时间：2026-08-22 CST。
- 详细记录标准：v1。
- 父版本：秀秀 3.224；固定严重故障回滚基准仍为秀秀 3.2。
- 修改目的：彻底修复新建或修改BOT后，秀秀数据库和OpenClaw主配置已经存在Agent，但18791生产执行网关仍返回“Unknown agent id”的配置不同步问题；把“全网证据调研BOT”和“工作交流记录员bot”纳入真实生产执行链路，并将相同保护同步到全部秀秀业务节点。
- 原因判断：3.218为降低回复延迟建立了18790主网关和18791专用执行网关。执行配置 `openclaw-executor.json` 原先只是部署时由脚本生成的静态快照，后续BOT创建只更新SQLite和 `openclaw.json`，没有重新生成执行视图，也没有让18791重新加载；搜索插件工程也只安装在主状态目录，执行状态目录可能缺少依赖。影团AI数据库还同时保存本机与远端镜像节点，不能依赖“只有一个local server_id”的自动推断。
- 修改逻辑：固定 `/root/.openclaw/openclaw.json` 为唯一Agent权威注册表，`openclaw-executor.json` 仅作为从主配置和本机启用BOT实时派生的无通道执行视图。BOT创建、更新、启停、软删/硬删、启动Bootstrap和每次回复前均检查目标Agent；缺失时在文件锁下原子重建执行视图。18791每次启动前再次同步插件依赖并重建配置。各双网关节点显式绑定真实稳定server_id，禁止根据显示名称改写；任何本机启用Agent未出现在主注册表时立即失败，禁止用空目录或残缺目录覆盖工作配置。
- 采用方法：新增带 `fcntl.flock` 的构建器，按SQLite本机启用BOT筛选主注册表并使用临时文件原子替换，内容无变化时不重复写盘；新增插件依赖同步器，按工程清单增量复制主状态目录中的已批准插件到执行状态目录，不删除执行端独有工程；systemd `ExecStartPre` 在每次18791启动前执行两项同步。回复前自愈失败时返回可重试错误，不再把底层Unknown Agent直接暴露给真人。秀秀替身为单网关节点，不创建第二套配置，共享代码检测不到执行视图时安全跳过。
- 数据/调用链路：创建/修改BOT -> SQLite与 `openclaw.json` 落库 -> 同步钩子获取跨进程锁 -> 从主注册表和本机BOT生成 `openclaw-executor.json` -> 18791加载；普通回复 -> 检查目标Agent是否在执行视图 -> 已存在则直接执行，缺失则只重建一次并复查 -> 18791调用Agent。服务重启 -> 插件依赖增量同步 -> 配置完整性校验与原子生成 -> 执行网关启动。单网关节点始终由主配置直接执行。
- 兼容保护：未修改数据库结构、账号、群组、聊天、Session、BOT人设、四大法、Step 4.5、Loop、Q军团、206/EasyTier、跨服授权、域名、安装包或客户端。没有把两个配置改成两个权威源，也没有让普通回复每次重写配置；目标Agent已存在时只读取缓存。守一替身保留另一窗口的X军团/BOT创建专属改动，使用窄补丁合并，未覆盖其独立源码差异。各节点数据库、server_id、密钥、工作区和业务资料保持隔离。
- 改动文件：五节点 `/opt/xiuxiu3-open-source/xiuxiu3_core/standalone.py`；五节点 `/opt/xiuxiu3-open-source/deploy/build_openclaw_executor_config.py` 与 `sync_openclaw_executor_dependencies.py`；立志教育、影团AI、守一、守一替身的 `/etc/systemd/system/openclaw-xiuxiu3-executor-gateway.service.d/97-executor-config-authority.conf`；`VERSION_RECORDS.md`、`VERSION_LOCK.md`、每日修改日志和长期功能进度网站。
- 验证结果：本地构建器单元测试5/5通过；四个双网关节点的主网关、18791执行网关、Web和Bridge均恢复active，五节点SQLite quick_check=ok。立志教育与守一替身的调研BOT、五节点记录员BOT在各自权威注册表中存在；双网关节点对应Agent同时进入执行视图。立志教育真实18791隔离Session测试中，记录员返回“工作交流记录员执行Agent正常”；调研BOT真实调用web_search，provider为parallel-free，返回真实链接，工具调用1次、失败0次。测试没有向业务群写入消息。影团AI多local镜像歧义和守一替身历史server_id误配均在验收中被发现并修复；新增完整性闸门可阻止同类空配置启动。
- 同步与回滚：立志教育 `/var/backups/xiuxiu3/executor-registry-authority-20260822-1318-lidazhi`；影团AI `/var/backups/xiuxiu3/executor-registry-authority-20260822-1325-yingtuan`；守一 `/var/backups/xiuxiu3/executor-registry-authority-20260822-1330-shouyi`；守一替身 `/var/backups/xiuxiu3/executor-registry-authority-20260822-1305-shouyitishen`；秀秀替身 `/var/backups/xiuxiu3/executor-registry-authority-20260822-1340-xiuxiutishen`。回滚只恢复故障节点自己的standalone、执行配置和systemd drop-in并重启对应Web/Bridge/网关，禁止跨节点恢复数据库、身份、密钥或工作区。
- 源码哈希：四个标准节点及秀秀替身 `standalone.py` 为 `2d81c9b0b77030450634674634b2b349a59607ea4228ddd2758bbd5d5f0be1f0`；守一替身合并核心为 `c858a31729f5ac74ba7289847ca24048ec6f4bb3a398bd1d8925a356322a034b`；执行配置构建器为 `aed9fdc07d7ee2158679d8133a614f2fc18d971b2a690e6b4307adae073e3276`；依赖同步器为 `2834b399d809dfcd594388be38f0b4f6f6444f32f3997ddbfdabdc6cdc44441d`。