openclaw memory

의미 기반 메모리 인덱싱, 검색 및 MEMORY.md로의 승격을 관리합니다. 번들로 제공되는 memory-core Plugin이 제공하며, plugins.slots.memory에서 memory-core를 선택한 경우(기본값) 사용할 수 있습니다. 다른 메모리 Plugin은 자체 CLI 네임스페이스를 제공합니다.

관련 문서: 메모리 개념, Dreaming, 메모리 구성 참조, 메모리 위키, 위키, Plugin.

memory status

openclaw memory status [--agent <id>] [--deep] [--index] [--fix] [--json] [--verbose]

--agent를 지정하지 않으면 agents.list의 모든 에이전트에 대해 실행합니다. 에이전트 목록이 구성되어 있지 않으면 기본 에이전트를 사용합니다.

dreaming.enabled: true인데도 Dreaming 행이 계속 off로 표시되거나 예약된 스윕이 전혀 실행되지 않는 것처럼 보인다면, 관리형 Dreaming Cron은 조정을 트리거하기 위해 기본 에이전트의 Heartbeat가 발생해야 합니다. 예약 세부 정보는 Dreaming을 참조하세요.

상태에는 agents.defaults.memorySearch.extraPaths의 추가 검색 경로도 모두 표시됩니다.

memory index

openclaw memory index [--agent <id>] [--force] [--verbose]

status와 동일하게 에이전트별 범위가 적용됩니다. --force는 증분 재인덱싱 대신 전체 재인덱싱을 실행합니다. --verbose는 인덱싱 진행 상황을 표시하기 전에 에이전트별 제공자, 모델, 소스 및 추가 경로 세부 정보를 출력합니다.

memory search

openclaw memory search [query] [--query <text>] [--agent <id>] [--max-results <n>] [--min-score <n>] [--json]

• 쿼리: 위치 인수 [query] 또는 --query <text>입니다. 둘 다 설정하면 --query가 우선합니다. 둘 다 설정하지 않으면 명령에서 오류가 발생합니다.
• --agent <id>: 전체 에이전트 목록이 아닌 기본 에이전트를 기본값으로 사용합니다.
• --max-results <n>: 결과 수를 제한합니다(양의 정수).
• --min-score <n>: 이 점수보다 낮은 일치 항목을 제외합니다.

memory promote

memory/YYYY-MM-DD.md의 단기 후보 순위를 매기고 선택적으로 상위 항목을 MEMORY.md에 추가합니다.

openclaw memory promote [--agent <id>] [--limit <n>] [--min-score <n>] \  [--min-recall-count <n>] [--min-unique-queries <n>] [--apply] [--include-promoted] [--json]

이러한 CLI 기본값은 예약된 Dreaming 스윕의 심층 단계 임계값과 다릅니다(아래 Dreaming 참조). 일회성 수동 실행을 스윕 동작과 일치시키려면 플래그를 명시적으로 전달하세요.

순위 지정 신호는 회상 빈도, 검색 관련성, 쿼리 다양성, 시간적 최신성, 날짜 간 통합, 파생된 개념의 풍부함이며, 메모리 회상과 일일 수집 과정 모두에서 가져옵니다. 또한 Dreaming에서 반복적으로 재검토된 항목에는 얕은/REM 단계 강화 보너스가 적용됩니다. 쓰기 전에 승격 과정에서 실시간 일일 노트를 다시 읽으므로, 순위 지정 이후 단기 스니펫을 수정하거나 삭제한 내용이 오래된 스냅샷에서 승격되는 대신 반영됩니다.

memory promote-explain

승격 후보 하나의 점수 분석을 설명합니다.

openclaw memory promote-explain <selector> [--agent <id>] [--include-promoted] [--json]

<selector>는 후보의 키(정확히 일치하거나 부분 문자열), 경로 또는 스니펫 텍스트와 일치합니다.

memory rem-harness

아무것도 쓰지 않고 REM 성찰, 진실 후보 및 심층 단계 승격 출력을 미리 봅니다.

openclaw memory rem-harness [--agent <id>] [--path <file-or-dir>] [--grounded] [--include-promoted] [--json]

• --path <file-or-dir>: 실시간 작업 공간 대신 과거 YYYY-MM-DD.md 일일 파일에서 하네스를 초기화합니다.
• --grounded: 과거 노트에서 근거를 둔 발생한 일 / 성찰 / 지속 가능한 업데이트 후보 미리 보기도 렌더링합니다.

memory rem-backfill

UI 검토를 위해 근거를 둔 과거 REM 요약을 DREAMS.md에 씁니다. 되돌릴 수 있습니다.

openclaw memory rem-backfill --path <file-or-dir> [--agent <id>] [--stage-short-term] [--json]openclaw memory rem-backfill --rollback [--rollback-short-term] [--json]

• --path <file-or-dir>: --rollback/--rollback-short-term을 설정하지 않은 경우 필수입니다. 백필에 사용할 과거 일일 메모리 파일 또는 디렉터리입니다.
• --stage-short-term: 근거를 둔 영구 후보를 실시간 단기 승격 저장소에도 초기화하여 일반 심층 단계에서 순위를 매길 수 있도록 합니다.
• --rollback: 이전에 작성한 근거 기반 일기 항목을 DREAMS.md에서 제거합니다.
• --rollback-short-term: 이전에 준비한 근거 기반 단기 후보를 제거합니다.

Dreaming

Dreaming은 하나의 일정에 따라 순서대로 실행되는 세 가지 협력 단계로 구성된 백그라운드 메모리 통합 시스템입니다. 단계는 얕은 단계(단기 자료 정렬/준비), REM(성찰 및 주제 도출), 심층 단계(영구 사실을 MEMORY.md로 승격)입니다. 심층 단계만 MEMORY.md에 씁니다.

• plugins.entries.memory-core.config.dreaming.enabled: true로 활성화합니다 (기본값 false). memory-core가 스윕 Cron 작업을 자동으로 관리하므로 수동으로 openclaw cron add를 실행할 필요가 없습니다.
• 채팅에서 /dreaming on|off로 전환하고 /dreaming status로 확인합니다 (/dreaming//dreaming help도 가능). on/off에는 채널 소유자 상태 또는 Gateway operator.admin이 필요합니다. status와 도움말은 명령을 호출할 수 있는 누구에게나 계속 제공됩니다.
• 사람이 읽을 수 있는 단계별 출력은 DREAMS.md(또는 기존 dreams.md)에 기록됩니다. 기본적으로(dreaming.storage.mode: "separate") 각 단계는 memory/dreaming/<phase>/YYYY-MM-DD.md에도 독립 실행형 보고서를 작성합니다. 보고서를 일일 메모리 파일에 통합하려면 mode: "inline"으로 설정하고, 두 위치 모두에 기록하려면 "both"로 설정합니다.
• 예약 실행과 수동 memory promote 실행은 동일한 심층 단계 순위 지정 신호를 공유하며 기본 임계값만 다릅니다(위 표와 아래의 예약 기본값 참조).
• 예약 실행은 구성된 모든 에이전트의 메모리 작업 공간에서 병렬로 수행됩니다.

예약 기본값(plugins.entries.memory-core.config.dreaming):

{  "plugins": {    "entries": {      "memory-core": {        "config": {          "dreaming": {            "enabled": true          }        }      }    }  }}

전체 키 목록과 단계 세부 정보: Dreaming, 메모리 구성 참조.

SecretRef Gateway 종속성

활성 메모리 원격 API 키 필드가 SecretRef로 구성된 경우 memory 명령은 활성 Gateway 스냅샷에서 이를 확인합니다. Gateway를 사용할 수 없으면 명령이 즉시 실패합니다. 이 기능에는 secrets.resolve 메서드를 지원하는 Gateway가 필요합니다. 이전 Gateway에서는 알 수 없는 메서드 오류가 반환됩니다.

관련 문서

• CLI 참조
• 메모리 개요