---
title: OpenClaw 세션 관리
updated: 2026-03-18
---

## dmScope (DM 격리 방식)

| 값 | 동작 |
|----|------|
| `main` (기본) | 모든 DM 주 세션 공유 |
| `per-peer` | 발신자 ID로 격리 |
| `per-channel-peer` | 채널+발신자로 격리 (다중 사용자 필수) |
| `per-account-channel-peer` | 계정+채널+발신자로 격리 |

## 세션 키 체계

- DM: `agent:<agentId>:main` 또는 `agent:<agentId>:direct:<peerId>`
- 그룹: `agent:<agentId>:<channel>:group:<id>`
- Telegram 토픽: `...group:<id>:topic:<threadId>`
- Cron: `cron:<job.id>`, 웹훅: `hook:<uuid>`

## 리셋 정책

- `daily` (기본, atHour:4) 또는 `idle` (idleMinutes)
- `/new`, `/reset` 명령으로 즉시 리셋
- `resetByType`으로 direct/group/thread별, `resetByChannel`로 채널별 재정의

## 유지보수

pruneAfter:30d, maxEntries:500, maxDiskBytes:500mb (mode: warn|enforce)

## 저장소

`~/.openclaw/agents/<agentId>/sessions/sessions.json`