Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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, 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, or expired.
  • --json: output machine-readable JSON.

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 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.