English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

CLI commands

메모리

openclaw memory

시맨틱 메모리 인덱싱과 검색을 관리합니다. Active Memory Plugin에서 제공합니다(기본값: memory-core; 비활성화하려면 plugins.slots.memory = "none" 설정).

관련 항목:

예시

openclaw memory status
openclaw memory status --deep
openclaw memory status --fix
openclaw memory index --force
openclaw memory search "meeting notes"
openclaw memory search --query "deployment" --max-results 20
openclaw memory promote --limit 10 --min-score 0.75
openclaw memory promote --apply
openclaw memory promote --json --min-recall-count 0 --min-unique-queries 0
openclaw memory promote-explain "router vlan"
openclaw memory promote-explain "router vlan" --json
openclaw memory rem-harness
openclaw memory rem-harness --json
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 status 및 memory index:

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

memory status:

  • --deep: 로컬 벡터 저장소 준비 상태, 임베딩 제공자 준비 상태, 시맨틱 벡터 검색 준비 상태를 프로브합니다. 일반 memory status는 빠르게 유지되며 라이브 임베딩 또는 제공자 검색 작업을 실행하지 않습니다. 알 수 없는 벡터 저장소 또는 시맨틱 벡터 상태는 해당 명령에서 프로브되지 않았다는 의미입니다. QMD 어휘 searchMode: "search"는 --deep을 사용하더라도 시맨틱 벡터 프로브와 임베딩 유지 관리를 건너뜁니다.
  • --index: 저장소가 더티 상태이면 재인덱싱을 실행합니다(--deep을 내포).
  • --fix: 오래된 회상 잠금을 복구하고 승격 메타데이터를 정규화합니다.
  • --json: JSON 출력을 표시합니다.

memory status에 Dreaming status: blocked가 표시되면 관리형 Dreaming Cron이 활성화되어 있지만, 이를 구동하는 Heartbeat가 기본 에이전트에서 실행되고 있지 않은 것입니다. 두 가지 일반적인 원인은 Dreaming이 실행되지 않음을 참조하세요.

memory index:

  • --force: 전체 재인덱싱을 강제합니다.

memory search:

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

memory promote:

단기 메모리 승격을 미리 보고 적용합니다.

openclaw memory promote [--apply] [--limit <n>] [--include-promoted]
  • --apply -- 승격 항목을 MEMORY.md에 씁니다(기본값: 미리 보기만).
  • --limit <n> -- 표시할 후보 수를 제한합니다.
  • --include-promoted -- 이전 주기에 이미 승격된 항목을 포함합니다.

전체 옵션:

  • 가중 승격 신호(frequency, relevance, query diversity, recency, consolidation, conceptual richness)를 사용하여 memory/YYYY-MM-DD.md의 단기 후보 순위를 매깁니다.
  • 메모리 회상과 일일 수집 패스의 단기 신호, 그리고 light/REM 단계 강화 신호를 사용합니다.
  • Dreaming이 활성화되면 memory-core가 백그라운드에서 전체 스윕(light -> REM -> deep)을 실행하는 Cron 작업 하나를 자동 관리합니다(수동 openclaw cron add 필요 없음).
  • --agent <id>: 단일 에이전트로 범위를 제한합니다(기본값: 기본 에이전트).
  • --limit <n>: 반환/적용할 최대 후보 수입니다.
  • --min-score <n>: 최소 가중 승격 점수입니다.
  • --min-recall-count <n>: 후보에 필요한 최소 회상 수입니다.
  • --min-unique-queries <n>: 후보에 필요한 최소 고유 쿼리 수입니다.
  • --apply: 선택된 후보를 MEMORY.md에 추가하고 승격됨으로 표시합니다.
  • --include-promoted: 이미 승격된 후보를 출력에 포함합니다.
  • --json: JSON 출력을 표시합니다.

memory promote-explain:

특정 승격 후보와 그 점수 세부 내역을 설명합니다.

openclaw memory promote-explain <selector> [--agent <id>] [--include-promoted] [--json]
  • <selector>: 조회할 후보 키, 경로 조각 또는 스니펫 조각입니다.
  • --agent <id>: 단일 에이전트로 범위를 제한합니다(기본값: 기본 에이전트).
  • --include-promoted: 이미 승격된 후보를 포함합니다.
  • --json: JSON 출력을 표시합니다.

memory rem-harness:

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

openclaw memory rem-harness [--agent <id>] [--include-promoted] [--json]
  • --agent <id>: 단일 에이전트로 범위를 제한합니다(기본값: 기본 에이전트).
  • --include-promoted: 이미 승격된 deep 후보를 포함합니다.
  • --json: JSON 출력을 표시합니다.

Dreaming

Dreaming은 세 가지 협력 단계로 이루어진 백그라운드 메모리 통합 시스템입니다. 단계는 light(단기 자료 정렬/스테이징), deep(지속 가능한 사실을 MEMORY.md로 승격), REM(성찰 및 주제 표면화)입니다.

  • plugins.entries.memory-core.config.dreaming.enabled: true로 활성화합니다.
  • 채팅에서 /dreaming on|off로 전환합니다(또는 /dreaming status로 확인).
  • Dreaming은 하나의 관리형 스윕 일정(dreaming.frequency)에서 실행되며 light, REM, deep 순서로 단계를 실행합니다.
  • deep 단계만 지속 메모리를 MEMORY.md에 씁니다.
  • 사람이 읽을 수 있는 단계 출력과 일기 항목은 DREAMS.md(또는 기존 dreams.md)에 작성되며, 선택적으로 단계별 보고서가 memory/dreaming/<phase>/YYYY-MM-DD.md에 작성됩니다.
  • 순위 매기기는 회상 빈도, 검색 관련성, 쿼리 다양성, 시간적 최신성, 여러 날에 걸친 통합, 파생 개념 풍부도라는 가중 신호를 사용합니다.
  • 승격은 MEMORY.md에 쓰기 전에 라이브 일일 노트를 다시 읽으므로, 편집되었거나 삭제된 단기 스니펫이 오래된 회상 저장소 스냅샷에서 승격되지 않습니다.
  • 예약 실행과 수동 memory promote 실행은 CLI 임계값 재정의를 전달하지 않는 한 동일한 deep 단계 기본값을 공유합니다.
  • 자동 실행은 구성된 메모리 워크스페이스 전체로 확장됩니다.

기본 일정:

  • 스윕 주기: dreaming.frequency = 0 3 * * *
  • Deep 임계값: minScore=0.8, minRecallCount=3, minUniqueQueries=3, recencyHalfLifeDays=14, maxAgeDays=30

예시:

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

참고:

  • memory index --verbose는 단계별 세부 정보(제공자, 모델, 소스, 배치 활동)를 출력합니다.
  • memory status는 memorySearch.extraPaths를 통해 구성된 추가 경로를 포함합니다.
  • 사실상 활성 상태인 메모리 원격 API 키 필드가 SecretRefs로 구성되어 있으면 명령은 활성 Gateway 스냅샷에서 해당 값을 해석합니다. Gateway를 사용할 수 없으면 명령은 빠르게 실패합니다.
  • Gateway 버전 차이 참고: 이 명령 경로에는 secrets.resolve를 지원하는 Gateway가 필요합니다. 이전 Gateway는 알 수 없는 메서드 오류를 반환합니다.
  • 예약 스윕 주기는 dreaming.frequency로 조정합니다. Deep 승격 정책은 그 외에는 내부적으로 관리됩니다. 일회성 수동 재정의가 필요하면 memory promote에서 CLI 플래그를 사용하세요.
  • memory rem-harness --path <file-or-dir> --grounded는 아무것도 쓰지 않고 과거 일일 노트에서 근거 기반 What Happened, Reflections, Possible Lasting Updates를 미리 봅니다.
  • memory rem-backfill --path <file-or-dir>는 UI 검토를 위해 되돌릴 수 있는 근거 기반 일기 항목을 DREAMS.md에 씁니다.
  • memory rem-backfill --path <file-or-dir> --stage-short-term는 일반 deep 단계가 순위를 매길 수 있도록 근거 기반 지속 후보를 라이브 단기 승격 저장소에도 시드합니다.
  • memory rem-backfill --rollback은 이전에 작성된 근거 기반 일기 항목을 제거하고, memory rem-backfill --rollback-short-term은 이전에 스테이징된 근거 기반 단기 후보를 제거합니다.
  • 전체 단계 설명과 구성 참조는 Dreaming을 참조하세요.

관련 항목