text

Copy

openclaw commitments

List and manage inferred follow-up commitments.

Commitments are opt-in, short-lived follow-up memories created from conversation context. See Inferred commitments for the conceptual guide.

With no subcommand,

lists pending commitments.

Usage

bash
Copy
openclaw commitments [--all] [--agent <id>] [--status <status>] [--json]
openclaw commitments list [--all] [--agent <id>] [--status <status>] [--json]
openclaw commitments dismiss <id...> [--json]

Options

• text

  Copy

  --all
  : show all statuses instead of only pending commitments.
• text

  Copy

  --agent <id>
  : filter to one agent id.
• text

  Copy

  --status <status>
  : filter by status. Values:
  text

  Copy

  pending
  ,
  text

  Copy

  sent
  ,
  text

  Copy

  dismissed
  ,
  text

  Copy

  snoozed
  , or
  text

  Copy

  expired
  .
• text

  Copy

  --json
  : output machine-readable JSON.

Examples

List pending commitments:

bash
Copy
openclaw commitments

List every stored commitment:

bash
Copy
openclaw commitments --all

Filter to one agent:

bash
Copy
openclaw commitments --agent main

Find snoozed commitments:

bash
Copy
openclaw commitments --status snoozed

Dismiss one or more commitments:

bash
Copy
openclaw commitments dismiss cm_abc123 cm_def456

Export as JSON:

bash
Copy
openclaw commitments --all --json

Output

Text output includes:

• commitment id
• status
• kind
• earliest due time
• scope
• suggested check-in text

JSON output also includes the commitment store path and full stored records.

Related

• Inferred commitments
• Memory overview
• Heartbeat
• Scheduled tasks