Sessions and memory
추론된 약속 사항
커밋먼트는 단기간 유지되는 후속 확인 메모리입니다. 이 기능을 활성화하면 OpenClaw은 대화에서 나중에 다시 확인할 기회가 생겼음을 감지하고, 이를 기억했다가 추후 다시 꺼낼 수 있습니다.
예:
- 내일 면접이 있다고 언급하면 OpenClaw이 면접 후에 상황을 확인할 수 있습니다.
- 지쳤다고 말하면 OpenClaw이 나중에 잠을 잤는지 물어볼 수 있습니다.
- 에이전트가 상황이 바뀐 후 다시 확인하겠다고 말하면 OpenClaw이 아직 끝나지 않은 해당 사항을 추적할 수 있습니다.
커밋먼트는 MEMORY.md 같은 영구적인 사실도 아니고, 정확한
리마인더도 아닙니다. 메모리와 자동화의 중간에 해당합니다. OpenClaw이
대화에 연결된 의무를 기억한 다음, 기한이 되면 Heartbeat가 이를 전달합니다.
커밋먼트 활성화
커밋먼트는 기본적으로 비활성화되어 있습니다(commitments.enabled: false). 구성에서 활성화하세요.
openclaw config set commitments.enabled trueopenclaw config set commitments.maxPerDay 3동일한 openclaw.json 구성:
{ "commitments": { "enabled": true, "maxPerDay": 3 }}commitments.maxPerDay는 하루 단위의 이동 구간 내에서 에이전트 세션당 전달할 수 있는
추론된 후속 확인의 수를 제한합니다. 기본값은 3입니다.
작동 방식
에이전트가 응답한 후 OpenClaw은 도구가 비활성화된 별도의 컨텍스트에서 숨겨진 백그라운드 추출 단계를 실행할 수 있습니다. 이 단계에서는 추론된 후속 확인 커밋먼트만 찾습니다. 표시되는 대화에는 내용을 기록하지 않으며, 기본 에이전트에게 추출에 대해 추론하도록 요청하지도 않습니다.
신뢰도가 높은 후보를 찾으면 OpenClaw은 다음 정보와 함께 커밋먼트를 저장합니다.
- 에이전트 ID
- 세션 키
- 원래 채널 및 전달 대상
- 기한 범위
- 간단한 권장 확인 메시지
- Heartbeat가 전송 여부를 결정하는 데 사용하는 비지시적 메타데이터
전달은 Heartbeat를 통해 이루어집니다. 커밋먼트 기한이 되면 Heartbeat는
동일한 에이전트 및 채널 범위의 Heartbeat 턴에 해당 커밋먼트를 추가합니다.
프롬프트는 커밋먼트 메타데이터를 신뢰할 수 없다고 명시적으로 경고하고, 모델이
그 안의 지시를 따르거나 그로 인해 도구를 사용하지 않도록 지시합니다.
모델은 자연스러운 확인 메시지 하나를 보내거나 HEARTBEAT_OK로 응답하여 이를 해제할 수 있습니다.
Heartbeat가 target: "none"으로 구성되어 있으면 기한이 된 커밋먼트는
내부에만 유지되며 외부 확인 메시지를 전송하지 않습니다. 커밋먼트 전달 프롬프트는
원래 대화 텍스트를 재현하지 않고 권장 확인 메시지와 메타데이터만 포함하며,
기한이 된 커밋먼트를 처리하는 Heartbeat 턴은 OpenClaw 도구 없이 실행됩니다.
OpenClaw은 추론된 커밋먼트를 기록한 직후에는 절대 전달하지 않습니다. 기한은 커밋먼트가 생성된 시점에서 최소 한 번의 Heartbeat 간격 이후로 제한되므로, 후속 확인이 추론된 바로 그 순간에 되풀이되어 나타나지 않습니다.
범위
커밋먼트는 생성된 정확한 에이전트 및 채널 컨텍스트로 범위가 제한됩니다. Discord에서 한 에이전트와 대화하는 동안 추론된 후속 확인은 다른 에이전트, 다른 채널 또는 관련 없는 세션에서 전달되지 않습니다.
이 범위 제한은 기능의 일부입니다. 자연스러운 확인 메시지는 전역 리마인더 시스템이 아니라 동일한 대화가 이어지는 것처럼 느껴져야 합니다.
커밋먼트와 리마인더 비교
| 필요 사항 | 사용할 기능 |
|---|---|
| "오후 3시에 알려 줘" | 예약 작업 |
| "20분 후에 알려 줘" | 예약 작업 |
| "평일마다 이 보고서를 실행해 줘" | 예약 작업 |
| "내일 면접이 있어" | 커밋먼트 |
| "밤을 꼬박 새웠어" | 커밋먼트 |
| "이 열린 스레드에 내가 답하지 않으면 확인해 줘" | 커밋먼트 |
사용자가 명시적으로 요청한 사항은 이미 스케줄러 경로에서 처리됩니다. 커밋먼트는 추론된 후속 확인에만 사용됩니다. 즉, 사용자가 리마인더를 요청하지 않았지만 대화에서 나중에 확인하면 유용할 상황이 분명히 생긴 경우입니다.
커밋먼트 관리
CLI를 사용하여 저장된 커밋먼트를 확인하고 삭제할 수 있습니다.
openclaw commitmentsopenclaw commitments --allopenclaw commitments --agent mainopenclaw commitments --status snoozedopenclaw commitments dismiss cm_abc123전체 명령어 참조는 openclaw commitments를 참조하세요.
개인정보 보호 및 비용
커밋먼트 추출에는 LLM 단계가 사용되므로, 이 기능을 활성화하면 대상이 되는 턴 이후에 백그라운드 모델 사용량이 추가됩니다. 이 단계는 사용자가 볼 수 있는 대화에는 표시되지 않지만, 후속 확인이 필요한지 판단하는 데 필요한 최근 대화를 읽을 수 있습니다.
저장된 커밋먼트는 OpenClaw의 로컬 상태입니다. 장기 메모리가 아닌 운영 메모리입니다. 다음 명령으로 기능을 비활성화할 수 있습니다.
openclaw config set commitments.enabled false문제 해결
예상한 후속 확인이 나타나지 않는 경우:
commitments.enabled가true인지 확인합니다.openclaw commitments --all을 사용하여 대기 중, 해제됨, 다시 알림 또는 만료된 레코드가 있는지 확인합니다.- 해당 에이전트에서 Heartbeat가 실행 중인지 확인합니다.
- 해당 에이전트 세션에서
commitments.maxPerDay에 이미 도달했는지 확인합니다. - 정확한 리마인더는 커밋먼트 추출에서 제외되며 대신 예약 작업에 표시되어야 한다는 점을 기억하세요.
