@@ -63,6 +63,37 @@ openclaw agent --agent ops --message "Run locally" --local
6363- When this command triggers `models.json` regeneration, SecretRef-managed provider credentials are persisted as non-secret markers (for example env var names, `secretref-env:ENV_VAR_NAME`, or `secretref-managed`), not resolved secret plaintext.
6464- Marker writes are source-authoritative: OpenClaw persists markers from the active source config snapshot, not from resolved runtime secret values.
656566+## JSON delivery status
67+68+When `--json --deliver` is used, the response may include `deliveryStatus` so scripts can distinguish delivered, suppressed, partial, and failed sends:
69+70+```json
71+{
72+"payloads": [{ "text": "Report ready", "mediaUrl": null }],
73+"meta": { "durationMs": 1200 },
74+"deliveryStatus": {
75+"requested": true,
76+"attempted": true,
77+"status": "sent",
78+"succeeded": true,
79+"resultCount": 1
80+ }
81+}
82+```
83+84+`deliveryStatus.status` is one of `sent`, `suppressed`, `partial_failed`, or `failed`. `suppressed` means delivery was intentionally not sent, for example a message-sending hook cancelled it or there was no visible result; it is still a terminal no-retry outcome. `partial_failed` means at least one payload was sent before a later payload failed. `failed` means no durable send completed or delivery preflight failed.
85+86+Common fields:
87+88+- `requested`: always `true` when the object is present.
89+- `attempted`: `true` after the durable send path ran; `false` for preflight failures or no visible payloads.
90+- `succeeded`: `true`, `false`, or `"partial"`; `"partial"` pairs with `status: "partial_failed"`.
91+- `reason`: a lowercase snake-case reason from durable delivery or preflight validation. Known reasons include `cancelled_by_message_sending_hook`, `no_visible_payload`, `no_visible_result`, `channel_resolved_to_internal`, `unknown_channel`, `invalid_delivery_target`, and `no_delivery_target`; failed durable sends may also report the failed stage. Treat unknown values as opaque because the set can expand.
92+- `resultCount`: number of channel send results when available.
93+- `sentBeforeError`: `true` when a partial failure sent at least one payload before the error.
94+- `error` and `errorMessage`: present for failed or partial-failed sends.
95+- `payloadOutcomes`: optional per-payload results with `index`, `status`, `reason`, `resultCount`, `error`, `stage`, `sentBeforeError`, or hook metadata when available.
96+6697## Related
67986899- [CLI reference](/cli)
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。