메인 콘텐츠로 건너뛰기

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.

커밋먼트는 수명이 짧은 후속 기억입니다. 활성화하면 OpenClaw는 대화가 향후 확인할 기회를 만들었다는 점을 감지하고 나중에 다시 꺼내도록 기억할 수 있습니다. 예시:
  • 내일 면접이 있다고 언급합니다. OpenClaw가 이후에 확인할 수 있습니다.
  • 지쳤다고 말합니다. OpenClaw가 나중에 잠을 잤는지 물어볼 수 있습니다.
  • 에이전트가 무언가가 바뀐 뒤 후속 확인을 하겠다고 말합니다. OpenClaw가 그 열린 루프를 추적할 수 있습니다.
커밋먼트는 MEMORY.md 같은 지속적인 사실이 아니며, 정확한 리마인더도 아닙니다. 메모리와 자동화 사이에 있습니다. OpenClaw는 대화에 묶인 의무를 기억하고, Heartbeat가 기한이 되었을 때 이를 전달합니다.

커밋먼트 활성화

커밋먼트는 기본적으로 꺼져 있습니다. 구성에서 활성화하세요.
openclaw config set commitments.enabled true
openclaw config set commitments.maxPerDay 3
동등한 openclaw.json:
{
  "commitments": {
    "enabled": true,
    "maxPerDay": 3
  }
}
commitments.maxPerDay는 이동 1일 기간 동안 에이전트 세션별로 전달될 수 있는 추론된 후속 확인 수를 제한합니다. 기본값은 3입니다.

작동 방식

에이전트가 응답한 뒤, OpenClaw는 별도 컨텍스트에서 숨겨진 백그라운드 추출 단계를 실행할 수 있습니다. 이 단계는 추론된 후속 커밋먼트만 찾습니다. 보이는 대화에 쓰지 않으며, 메인 에이전트에게 추출에 대해 추론하도록 요청하지도 않습니다. 신뢰도 높은 후보를 찾으면 OpenClaw는 다음 정보와 함께 커밋먼트를 저장합니다.
  • 에이전트 ID
  • 세션 키
  • 원래 채널과 전달 대상
  • 기한 범위
  • 짧게 제안된 확인 문구
  • Heartbeat가 전송 여부를 결정하기에 충분한 원본 컨텍스트
전달은 Heartbeat를 통해 이루어집니다. 커밋먼트의 기한이 되면 Heartbeat는 동일한 에이전트 및 채널 범위의 Heartbeat 턴에 커밋먼트를 추가합니다. 모델은 자연스러운 확인 메시지 하나를 보내거나 HEARTBEAT_OK로 응답해 이를 해제할 수 있습니다. OpenClaw는 추론된 커밋먼트를 기록한 직후 즉시 전달하지 않습니다. 기한은 커밋먼트가 생성된 뒤 최소 한 번의 Heartbeat 간격 이후로 제한되므로, 후속 확인이 추론된 바로 그 순간에 되돌아와 반복되지 않습니다.

범위

커밋먼트는 생성된 정확한 에이전트 및 채널 컨텍스트로 범위가 제한됩니다. Discord에서 한 에이전트와 대화하는 동안 추론된 후속 확인은 다른 에이전트, 다른 채널, 또는 관련 없는 세션에서 전달되지 않습니다. 이 범위 지정은 기능의 일부입니다. 자연스러운 확인은 전역 리마인더 시스템처럼 느껴지는 것이 아니라, 같은 대화가 이어지는 것처럼 느껴져야 합니다.

커밋먼트와 리마인더 비교

필요사용할 것
”오후 3시에 알려줘”예약된 작업
”20분 뒤에 핑해줘”예약된 작업
”이 보고서를 평일마다 실행해줘”예약된 작업
”내일 면접이 있어”커밋먼트
”밤을 꼬박 새웠어”커밋먼트
”이 열린 스레드에 내가 답하지 않으면 후속 확인해줘”커밋먼트
명확한 사용자 요청은 이미 스케줄러 경로에 속합니다. 커밋먼트는 추론된 후속 확인에만 사용됩니다. 즉 사용자가 리마인더를 요청하지는 않았지만, 대화가 유용한 향후 확인을 분명히 만든 순간에 사용됩니다.

커밋먼트 관리

저장된 커밋먼트를 검사하고 지우려면 CLI를 사용하세요.
openclaw commitments
openclaw commitments --all
openclaw commitments --agent main
openclaw commitments --status snoozed
openclaw commitments dismiss cm_abc123
명령 참조는 openclaw commitments를 참고하세요.

개인정보 보호 및 비용

커밋먼트 추출은 LLM 단계를 사용하므로, 이를 활성화하면 대상 턴 이후에 백그라운드 모델 사용량이 추가됩니다. 이 단계는 사용자에게 보이는 대화에서는 숨겨져 있지만, 후속 확인이 있는지 판단하는 데 필요한 최근 대화는 읽을 수 있습니다. 저장된 커밋먼트는 로컬 OpenClaw 상태입니다. 이는 운영 메모리이지 장기 메모리가 아닙니다. 다음으로 기능을 비활성화하세요.
openclaw config set commitments.enabled false

문제 해결

예상한 후속 확인이 나타나지 않는 경우:
  • commitments.enabledtrue인지 확인하세요.
  • 보류 중, 해제됨, 다시 알림, 또는 만료된 레코드를 확인하려면 openclaw commitments --all을 확인하세요.
  • 에이전트에 대해 Heartbeat가 실행 중인지 확인하세요.
  • 해당 에이전트 세션에서 commitments.maxPerDay에 이미 도달했는지 확인하세요.
  • 정확한 리마인더는 커밋먼트 추출에서 건너뛰며, 대신 예약된 작업에 표시되어야 한다는 점을 기억하세요.

관련 항목