메인 콘텐츠로 건너뛰기

​
openclaw memory

시맨틱 memory의 인덱싱과 검색을 관리합니다. 이 기능은 활성화된 memory plugin이 제공하며, 기본값은 memory-core입니다. 비활성화하려면 plugins.slots.memory = "none"을 설정하세요. Related:

​
사용 예시

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

​
Options

memory status 및 memory index:
  • --agent <id>: 단일 agent로 범위를 제한합니다. 지정하지 않으면 구성된 각 agent에 대해 실행되고, agent 목록이 없으면 기본 agent로 fallback합니다.
  • --verbose: probe 및 indexing 과정의 상세 로그를 출력합니다.
memory status:
  • --deep: vector + embedding 가용성을 실제로 probe합니다.
  • --index: store가 dirty 상태면 재인덱싱을 실행합니다. (--deep 포함)
  • --json: JSON 형식으로 출력합니다.
memory index:
  • --force: 전체 reindex를 강제로 수행합니다.
memory search:
  • Query 입력은 위치 인자 [query] 또는 --query <text> 둘 중 하나를 사용합니다.
  • 둘 다 제공하면 --query가 우선합니다.
  • 둘 다 없으면 명령이 오류와 함께 종료됩니다.
  • --agent <id>: 단일 agent로 범위를 제한합니다. 기본값은 default agent입니다.
  • --max-results <n>: 반환할 결과 수를 제한합니다.
  • --min-score <n>: score가 낮은 결과를 필터링합니다.
  • --json: 결과를 JSON으로 출력합니다.
Notes:
  • memory index --verbose는 provider, model, source, batch activity 등 단계별 상세 정보를 출력합니다.
  • memory status에는 memorySearch.extraPaths로 설정한 추가 경로도 포함됩니다.
  • 활성 memory의 remote API key가 SecretRef로 설정된 경우, 이 명령은 active gateway snapshot에서 값을 resolve합니다. gateway에 연결할 수 없으면 즉시 실패합니다.
  • 이 경로는 secrets.resolve를 지원하는 gateway가 필요합니다. 구버전 gateway는 unknown-method 오류를 반환합니다.