openclaw memory

시맨틱 메모리 인덱싱 및 검색을 관리합니다. 활성 메모리 플러그인이 제공합니다 (기본값: memory-core; plugins.slots.memory = "none"으로 비활성화 가능).

관련 문서:

사용 예시

openclaw memory status
openclaw memory status --deep
openclaw memory index --force
openclaw memory search "meeting notes"
openclaw memory search --query "deployment" --max-results 20
openclaw memory status --json
openclaw memory status --deep --index
openclaw memory status --deep --index --verbose
openclaw memory status --agent main
openclaw memory index --agent main --verbose

옵션

memory statusmemory index:

  • --agent <id>: 단일 에이전트로 범위를 제한합니다. 지정하지 않으면 구성된 모든 에이전트에 대해 실행되며, 에이전트 목록이 설정되어 있지 않으면 기본 에이전트로 대체됩니다.
  • --verbose: 프로브 및 인덱싱 중 상세 로그를 출력합니다.

memory status:

  • --deep: 벡터 및 임베딩 가용성을 프로브합니다.
  • --index: 스토어가 dirty 상태일 때 리인덱스를 실행합니다 (--deep을 포함).
  • --json: JSON 형식으로 출력합니다.

memory index:

  • --force: 전체 리인덱스를 강제 실행합니다.

memory search:

  • 쿼리 입력: 위치 인자 [query] 또는 --query <text>로 전달합니다.
  • 둘 다 제공된 경우 --query가 우선합니다.
  • 둘 다 제공되지 않으면 오류와 함께 종료됩니다.
  • --agent <id>: 단일 에이전트로 범위를 제한합니다 (기본값: 기본 에이전트).
  • --max-results <n>: 반환되는 결과 수를 제한합니다.
  • --min-score <n>: 낮은 점수의 매치를 필터링합니다.
  • --json: JSON 형식으로 결과를 출력합니다.

참고사항:

  • memory index --verbose는 단계별 세부 정보를 출력합니다 (프로바이더, 모델, 소스, 배치 활동).
  • memory status에는 memorySearch.extraPaths로 구성된 추가 경로가 포함됩니다.
  • 활성 메모리 원격 API 키 필드가 SecretRef로 구성된 경우, 활성 게이트웨이 스냅샷에서 해당 값을 확인합니다. 게이트웨이를 사용할 수 없으면 즉시 실패합니다.
  • 게이트웨이 버전 불일치 참고: 이 명령 경로는 secrets.resolve를 지원하는 게이트웨이가 필요합니다. 이전 버전의 게이트웨이는 unknown-method 오류를 반환합니다.