实践openclaw-concepts
Message lifecycle refactor · OpenClaw — 一次消息生命周期重构,解决重启丢消息的可靠性难题
一次消息生命周期重构,解决重启丢消息的可靠性难题
2026-07-27原文
本文为要点摘要,完整细节以原文为准。
🧭 一图看懂
由原文自动提炼 · 以原文为准点击任一分支,查看这一点的一句话解读
OpenClaw 消息生命周期重构
发送意图先持久化再调平台,回执成功后提交,实现至少一次恢复
- 持久化与平台调用分离
- 崩溃后可恢复发送状态
⚙️ 流程拆解
STEP 1决定消息应存在
STEP 2持久化发送意图
STEP 3调用平台发送
STEP 4平台回执成功后提交
STEP 5按结果重试或降级
🔗 涉及的概念与玩家
- OpenClaw产品
- sendDurableMessageBatch方法
- ack()方法
- nack(error)方法
- after_durable_send概念
- agent harness概念
- OpenClaw—引入→sendDurableMessageBatch
- sendDurableMessageBatch—服务于→agent harness
- ack()—配合→after_durable_send
- nack(error)—配合→after_durable_send
- 核心不变式:核心决定消息应存在后,发送意图必须先持久化再调用平台,平台回执必须在成功后提交,实现至少一次恢复。
- 对 agent harness 设计含义:消息发送的持久化与平台调用分离,确保崩溃后能恢复发送状态。
- 引入
sendDurableMessageBatch封装渲染、发送、提交/失败步骤,返回sent/suppressed/partial_failed/failed四种结果。- 对 agent harness 设计含义:标准化发送结果枚举,让上层逻辑能根据结果决定重试或降级。
- 接收上下文通过
ack()/nack(error)和可配置的确认策略(如after_durable_send),控制何时确认事件已处理。- 对 agent harness 设计含义:将确认时机与下游发送绑定,避免确认后崩溃导致回复丢失。
🕸 顺着图谱继续读
- openclaw v2026.9.4 — 一次发布暴露了发布链路本身的脆弱点2026-09-11 · 共同涉及 OpenClaw、agent harness
- openclaw v2026.7.1-2 — npm 插件更新兼容性修复,影响官方插件安装2026-08-04 · 共同涉及 OpenClaw、agent harness
- Codex from 0 to 10M Users: Building ChatGPT Work — — Codex从代码工具演变为知识工作平台,用户数10个月增长10倍,非开发者增速是2026-07-28 · 共同涉及 OpenClaw、agent harness
- openclaw v2026.7.1 — Control UI 大改版,GPT2026-07-13 · 共同涉及 OpenClaw、agent harness