mirror of
https://github.com/openclaw/openclaw.git
synced 2026-05-03 06:57:09 +02:00
91 lines
1.9 KiB
Markdown
91 lines
1.9 KiB
Markdown
---
|
|
summary: "CLI reference for `openclaw commitments` (inspect and dismiss inferred follow-ups)"
|
|
read_when:
|
|
- You want to inspect inferred follow-up commitments
|
|
- You want to dismiss pending check-ins
|
|
- You are auditing what heartbeat may deliver
|
|
title: "`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](/concepts/commitments) for the
|
|
conceptual guide.
|
|
|
|
With no subcommand, `openclaw commitments` lists pending commitments.
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
openclaw commitments
|
|
```
|
|
|
|
List every stored commitment:
|
|
|
|
```bash
|
|
openclaw commitments --all
|
|
```
|
|
|
|
Filter to one agent:
|
|
|
|
```bash
|
|
openclaw commitments --agent main
|
|
```
|
|
|
|
Find snoozed commitments:
|
|
|
|
```bash
|
|
openclaw commitments --status snoozed
|
|
```
|
|
|
|
Dismiss one or more commitments:
|
|
|
|
```bash
|
|
openclaw commitments dismiss cm_abc123 cm_def456
|
|
```
|
|
|
|
Export as JSON:
|
|
|
|
```bash
|
|
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](/concepts/commitments)
|
|
- [Memory overview](/concepts/memory)
|
|
- [Heartbeat](/gateway/heartbeat)
|
|
- [Scheduled tasks](/automation/cron-jobs)
|