1a34950d9c
* fix(commitments): migrate store to sqlite Replace steady-state JSON persistence with typed shared-state rows and a doctor-only verified import for shipped legacy data. Co-authored-by: morluto <76467478+morluto@users.noreply.github.com> * fix(commitments): satisfy migration gates * fix(commitments): type sqlite counts defensively --------- Co-authored-by: Peter Steinberger <steipete@gmail.com>
2.3 KiB
summary, read_when, title
| summary | read_when | title | |||
|---|---|---|---|---|---|
| CLI reference for `openclaw commitments` (inspect and dismiss inferred follow-ups) |
|
`openclaw commitments` |
List and manage inferred follow-up commitments.
Commitments are opt-in (commitments.enabled), short-lived follow-up memories
created from conversation context and delivered by heartbeat. See
Inferred commitments for the conceptual guide and config.
With no subcommand, openclaw commitments lists pending commitments.
Usage
openclaw commitments [--all] [--agent <id>] [--status <status>] [--json]
openclaw commitments list [--all] [--agent <id>] [--status <status>] [--json]
openclaw commitments dismiss <id...> [--json]
Options
--all: show all statuses instead of only pending commitments.--agent <id>: filter to one agent id.--status <status>: filter by status. Values:pending,sent,dismissed,snoozed, orexpired. Unknown values exit with an error.--json: output machine-readable JSON.
dismiss marks the given commitment ids as dismissed so heartbeat will not
deliver them.
Examples
List pending commitments:
openclaw commitments
List every stored commitment:
openclaw commitments --all
Filter to one agent:
openclaw commitments --agent main
Find snoozed commitments:
openclaw commitments --status snoozed
Dismiss one or more commitments:
openclaw commitments dismiss cm_abc123 cm_def456
Export as JSON:
openclaw commitments --all --json
Output
Text output prints the commitment count, the shared SQLite database path, any active filters, and one row per commitment:
- commitment id
- status
- kind (
event_check_in,deadline_check,care_check_in, oropen_loop) - earliest due time
- scope (agent/channel/target)
- suggested check-in text
JSON output includes the count, the active status and agent filters, the shared SQLite database path, and the full stored records.