---
read_when:
    - 추론된 후속 조치 약속을 검토하려고 합니다
    - 대기 중인 체크인을 해제하려고 합니다
    - Heartbeat가 전달할 수 있는 내용을 감사하고 있습니다
summary: '`openclaw commitments`에 대한 CLI 참조(추론된 후속 작업 검사 및 해제)'
title: '`openclaw commitments`'
x-i18n:
    generated_at: "2026-07-16T12:27:47Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: db8a7d8f5756ccb18ed0990fcedf50d1072bb67e775c29eefdbd1a7dd795b7b0
    source_path: cli/commitments.md
    workflow: 16
---

추론된 후속 약속을 나열하고 관리합니다.

약속은 옵트인 방식이며(`commitments.enabled`), 대화 맥락에서 생성되어 Heartbeat를 통해 전달되는 단기 후속 기억입니다.
개념 가이드와 구성은 [추론된 약속](/ko/concepts/commitments)을 참조하십시오.

하위 명령이 없으면 `openclaw commitments`은(는) 보류 중인 약속을 나열합니다.

## 사용법

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

## 옵션

- `--all`: 보류 중인 약속만 표시하는 대신 모든 상태를 표시합니다.
- `--agent <id>`: 하나의 에이전트 ID로 필터링합니다.
- `--status <status>`: 상태별로 필터링합니다. 값: `pending`, `sent`,
  `dismissed`, `snoozed` 또는 `expired`. 알 수 없는 값을 지정하면 오류와 함께 종료됩니다.
- `--json`: 머신 판독 가능 JSON을 출력합니다.

`dismiss`은(는) 지정된 약속 ID를 `dismissed`(으)로 표시하여 Heartbeat가
해당 약속을 전달하지 않도록 합니다.

## 예시

보류 중인 약속을 나열합니다.

```bash
openclaw commitments
```

저장된 모든 약속을 나열합니다.

```bash
openclaw commitments --all
```

하나의 에이전트로 필터링합니다.

```bash
openclaw commitments --agent main
```

다시 알림으로 설정된 약속을 찾습니다.

```bash
openclaw commitments --status snoozed
```

하나 이상의 약속을 해제합니다.

```bash
openclaw commitments dismiss cm_abc123 cm_def456
```

JSON으로 내보냅니다.

```bash
openclaw commitments --all --json
```

## 출력

텍스트 출력에는 약속 수, 공유 SQLite 데이터베이스 경로, 활성 필터 및
약속별 행 하나가 표시됩니다.

- 약속 ID
- 상태
- 종류(`event_check_in`, `deadline_check`, `care_check_in` 또는 `open_loop`)
- 가장 이른 기한
- 범위(에이전트/채널/대상)
- 제안된 확인 메시지

JSON 출력에는 개수, 활성 상태 및 에이전트 필터,
공유 SQLite 데이터베이스 경로와 저장된 전체 레코드가 포함됩니다.

## 관련 항목

- [추론된 약속](/ko/concepts/commitments)
- [메모리 개요](/ko/concepts/memory)
- [Heartbeat](/ko/gateway/heartbeat)
- [예약된 작업](/ko/automation/cron-job