세션 관리

OpenClaw는 대화를 세션으로 구성합니다. 각 메시지는 어디서 왔는지에 따라 세션으로 라우팅됩니다 -- DM, 그룹 채팅, cron 작업 등.

메시지 라우팅 방법

기본적으로 모든 DM은 연속성을 위해 하나의 세션을 공유합니다. 이는 단일 사용자 설정에 적합합니다.

WARNING

여러 사람이 에이전트에게 메시지를 보낼 수 있는 경우, DM 격리를 활성화하십시오. 이 없이는 모든 사용자가 동일한 대화 컨텍스트를 공유합니다 -- Alice의 개인 메시지가 Bob에게 표시됩니다.

해결 방법:

json5

{
  session: {
    dmScope: "per-channel-peer", // 채널 + 발신자별 격리
  },
}

기타 옵션:

TIP

동일한 사람이 여러 채널에서 연락하는 경우, session.identityLinks를 사용하여 자격을 연결하면 하나의 세션을 공유합니다.

openclaw security audit으로 설정을 확인하십시오.

세션은 만료될 때까지 재사용됩니다:

일별 및 유휴 재설정 모두 구성된 경우, 먼저 만료되는 것이 우선합니다.

모든 세션 상태는 게이트웨이가 소유합니다. UI 클라이언트는 게이트웨이에 세션 데이터를 쿼리합니다.

OpenClaw는 시간이 지남에 따라 세션 저장소를 자동으로 제한합니다. 기본적으로 warn 모드로 실행됩니다 (정리될 것을 보고). 자동 정리를 위해 session.maintenance.mode를 "enforce"로 설정하십시오:

json5

{
  session: {
    maintenance: {
      mode: "enforce",
      pruneAfter: "30d",
      maxEntries: 500,
    },
  },
}

openclaw sessions cleanup --dry-run으로 미리 볼 수 있습니다.