KNOWLEDGE BASE · AI动态

OpenClaw 发布 Path 3 live SQLite E2E harness：升级会话存储体验

OpenClaw 近日推出了全新的 Path 3 live SQLite E2E harness，这是一款专为验证 Gateway 网关而设计的工具。它标志着 OpenClaw 在会话和转录存储方面迈出了重要一步，将 SQLite 作为主要的存储方案，取代了旧版的 JSONL 文件。这一变化不仅提升了数据处理的效率，还为用户带来了更稳定的操作体验。

Path 3 live SQLite E2E harness 主要用于证明 Gateway 网关在处理迁移后的流量时，能够正确地将数据存储到 SQLite 数据库中。值得注意的是，迁移后的 SQLite 转录行数可能与旧版 JSONL 文件的计数不同，因为新系统只会推进 SQLite 数据库，而不会继续使用旧版文件。这一特性确保了数据的一致性和完整性。

对于开发者而言，Path 3 live SQLite E2E harness 是一个强大的验证工具，而非普通的用户诊断工具。它通过每一步测量 Gateway 网关的行为、SQLite 行变动、旧版文件的状态以及日志健康状况，来确保整个系统的稳定运行。开发者可以通过运行特定的命令来连接正在运行的 Gateway 网关，并进行实时验证。

该工具的命令形式简洁明了，例如：bash Copy code node scripts/path3-live-sqlite-e2e.mjs --url http://127.0.0.1:18789 --agent main --session-key agent:main:path3-live-e2e: --json。这个命令将连接到指定的 Gateway 网关，并开始验证过程。除非以后添加显式迁移模式，否则它不会启动、停止、导入或重新运行迁移。

在隔离的构建版 CLI 验证中，验证器会植入隔离的旧版会话存储，启动重新构建的 Gateway 网关，并证明启动过程会在运行时读取开始前将活跃的旧版会话导入 SQLite。开发者应避免在首次启动 Gateway 网关前运行 openclaw doctor --fix，以确保验证的是用户在切换后首次启动时获得的升级路径，而不是手动迁移路径。

预检功能是 Path 3 live SQLite E2E harness 的另一个重要特性。它会在发送验证轮次前收集基线，如果 Gateway 网关不可用，则会失败。预检会检查 GET /health 和 Gateway 网关深度状态，确保网关 网关正在运行且可访问。同时，CLI 和 Gateway 网关版本必须与正在测试的分支匹配，harness 还会记录活动 Gateway 网关文件日志的日志游标。

此外，Path 3 live SQLite E2E harness 还会记录每 Agent SQLite 中 sessions、session_entries、transcript_events、transcript_event_identities 和 session_route 等关键数据。这些数据对于后续的诊断和故障排除至关重要，确保了系统的可靠性和可维护性。

总的来说，Path 3 live SQLite E2E harness 的推出，标志着 OpenClaw 在提升用户体验和系统稳定性方面又迈出了坚实的一步。它不仅简化了数据存储过程，还为开发者提供了更强大的工具来验证和优化他们的应用程序。

📖 原文链接：https://studyopenclaw.cn/?p=2614

OpenClaw 知识库 · AI动态