The main session

기준일: 2026-07-26
공식 기준: The main session

The main session 문서는 OpenClaw 공식 문서(concepts/main-session)를 한국어로 정리한 가이드입니다. One rolling conversation across all your channels: the personal-agent default 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

One rolling conversation across all your channels: the personal-agent default

한국어 가이드 범위: concepts/main-session 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• Home
• What flows into the main session
• Memory across resets and conversations
• A rolling session with durable history
• When you want isolation instead
• 관련 문서

상세 내용

본문

OpenClaw is a personal agent first. Out of the box, every direct message you send it — from Telegram, WhatsApp, iMessage, Slack DMs, the web app, anywhere — lands in one rolling conversation: the main session. Ask something on your phone, follow up from your laptop, and the agent has the same context in both places. There is one brain, and this is where it thinks.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Home

In the web app, the main session is the Home page — the first entry in the sidebar. The identity row at the top is your agent (click it for the agent menu); Home is where you talk to it. Sessions that fork off the main conversation appear under Threads, group chats under Groups, and coding/CLI sessions under Coding.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

What flows into the main session

The main session is not just a chat log; it is the place where your agent's world converges:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• Group activity. Group and room sessions stay isolated (see below), but
• Background work. Sub-agents and spawned sessions announce their results
• Heartbeats. Scheduled heartbeats target the main session, which is what

Memory across resets and conversations

The rolling conversation is bounded by the model's context window, so continuity comes from layers around it:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• MEMORY.md, the agent's curated long-term memory, is loaded into every
• Memory recall across conversations lets the agent recall content from

A rolling session with durable history

The main session rolls forward through resets and compaction rather than making the model carry its entire history at once:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• By default there is no automatic reset; compaction keeps the active context
• When the conversation approaches the context window, compaction summarizes
• Session lists show the current live conversation, not every historical
• When the per-agent store's physical database, WAL, and session artifacts

When you want isolation instead

The shared main session is the right default for an agent that only you talk to. If several people can message your agent, isolate DMs:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

{
  session: {
    dmScope: "per-channel-peer",
  },
}

관련 문서

주요 항목:

• Session management — routing, scopes, resets
• Channel routing — how agents and sessions are selected
• Memory — durable memory layers
• Multi-agent — running several isolated agents

실습 체크리스트

1. 공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/concepts/main-session
2. 관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
3. 설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
4. Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

{
  session: {
    dmScope: "per-channel-peer",
  },
}

관련 링크

• 공식 원문: concepts/main-session
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.