OpenClaw 세션 관리 및 대화 초기화 가이드

개발을 하다 보면 대화 기록이 꼬이거나 Context 제한 때문에 에이전트가 멍청해지는 상황을 자주 겪게 되죠. 특히 여러 사용자가 동시에 접속하거나 다양한 채널을 관리해야 할 때 세션 관리는 정말 까다로운 숙제입니다.

OpenClaw에서 세션과 멀티 채팅을 어떻게 효율적으로 관리하고 제어할 수 있는지 핵심적인 방법들을 정리해 드릴게요.

새로운 대화를 어떻게 시작하나요?

단독 메시지로 /new 또는 /reset을 보내면 돼요.

`/new`를 보내지 않아도 세션이 자동으로 리셋되나요?

네, 세션은 session.idleMinutes (기본값 60) 이후에 만료돼요. 그 다음 메시지를 보내면 해당 채팅 키에 대해 새로운 세션 ID가 시작됩니다. 대화 기록(transcripts)이 삭제되는 것은 아니며, 단지 새 세션을 시작하는 것뿐이에요.

{
  session: { idleMinutes: 240 }
}

OpenClaw 인스턴스 여러 개로 팀을 만들 수 있나요 (CEO 한 명과 여러 에이전트)?

네, multi-agent routing과 sub-agents를 통해 가능해요. 코디네이터 에이전트 하나와 각자의 Workspace 및 모델을 가진 여러 워커 에이전트를 만들 수 있습니다.

다만, 이건 재미있는 실험 정도로 보는 게 좋아요. Token 소모가 많고, 세션을 분리한 봇 하나를 사용하는 것보다 효율이 떨어지는 경우가 많거든요.

작업 중간에 Context가 왜 잘리나요? 어떻게 방지하죠?

세션 Context는 모델의 Window 크기에 제한을 받아요. 대화가 길어지거나, Tool 출력 결과가 크거나, 파일이 많으면 압축(compaction)이나 잘림(truncation) 현상이 발생할 수 있습니다.

도움이 되는 방법들:

에이전트에게 현재 상태를 요약해서 파일로 저장해달라고 요청하세요.
긴 작업을 하기 전에 /compact를 사용하고, 주제를 바꿀 때는 /new를 쓰세요.
중요한 Context는 Workspace에 보관하고 에이전트에게 다시 읽어달라고 하세요.
길거나 병렬적인 작업에는 sub-agents를 활용하세요.
Context Window가 더 큰 모델을 선택하세요.

설치는 유지하면서 OpenClaw를 완전히 리셋하려면 어떻게 하나요?

openclaw reset

대화형이 아닌 완전 리셋 방법은 다음과 같아요:

openclaw reset --scope full --yes --non-interactive

그 다음 온보딩을 다시 실행하세요:

openclaw onboard --install-daemon

“context too large” 에러가 나요. 어떻게 리셋하거나 압축하나요?

Compact (대화는 유지하되 이전 대화 내용들을 요약합니다):

/compact

Reset (같은 채팅 키에 대해 새로운 세션 ID를 부여합니다):

/new
/reset

문제가 계속된다면 다음을 시도해 보세요:

세션 프루닝(agents.defaults.contextPruning) 기능을 켜거나 조정하세요.
Context Window가 더 큰 모델을 사용하세요.

왜 30분마다 Heartbeat 메시지가 오나요?

Heartbeat는 기본적으로 30분마다 실행돼요. 이 주기를 조정하거나 끌 수 있습니다:

{
  agents: {
    defaults: {
      heartbeat: {
        every: "2h"  // or "0m" to disable
      }
    }
  }
}

WhatsApp 그룹에 “봇 계정”을 추가해야 하나요?

아니요. OpenClaw는 본인의 계정에서 실행되므로, 본인이 그룹에 참여하고 있다면 OpenClaw도 해당 그룹을 볼 수 있어요. 기본적으로 그룹 답장은 사용자가 발신자를 허용(groupPolicy: "allowlist")하기 전까지는 차단됩니다.

WhatsApp 그룹의 JID는 어떻게 확인하나요?

방법 1 (가장 빠름): 로그를 실시간으로 확인하면서 그룹에 테스트 메시지를 보내보세요:

openclaw logs --follow --json

@g.us로 끝나는 chatId (또는 from)를 찾으면 됩니다.

방법 2: 설정에서 그룹 목록을 확인하세요:

openclaw directory groups list --channel whatsapp

OpenClaw가 왜 그룹에서 답장을 안 하나요?

두 가지 흔한 원인이 있어요:

Mention 기능이 켜져 있는 경우(기본값). 봇을 @mention 해야만 답장합니다.
channels.whatsapp.groups 설정에 "*"를 포함하지 않았고, 해당 그룹이 허용 리스트(allowlist)에 없는 경우입니다.

그룹이나 Thread가 DM과 Context를 공유하나요?

다이렉트 채팅(DM)은 기본적으로 메인 세션으로 통합돼요. 반면 그룹이나 채널은 고유한 세션 키를 가지며, Telegram 토픽이나 Discord 스레드도 각각 별도의 세션으로 분리됩니다.

Workspace와 Agent는 몇 개까지 만들 수 있나요?

딱히 정해진 제한은 없어요. 수십 개나 수백 개도 괜찮지만 다음 사항들을 주의해야 합니다:

디스크 용량 증가: 세션과 대화 기록은 ~/.openclaw/agents/<agentId>/sessions/ 아래에 저장돼요.
Token 비용: 에이전트가 많아질수록 동시 모델 사용량이 늘어납니다.
운영 오버헤드: 에이전트별 인증 프로필, Workspace, 채널 라우팅 관리가 복잡해질 수 있어요.

여러 봇이나 채팅을 동시에 실행할 수 있나요 (Slack)? 어떻게 설정하죠?

네, 가능해요. Multi-Agent Routing을 사용하여 여러 개의 독립된 에이전트를 실행하고, 채널/계정/상대방에 따라 들어오는 메시지를 라우팅하면 됩니다.

권장 설정 방식:

상시 가동되는 Gateway 호스트 (VPS 또는 Mac mini)
역할별 에이전트 1개씩 할당 (bindings)
해당 에이전트들에 연결된 Slack 채널들
필요한 경우 extension relay를 통한 로컬 브라우저 연결

다음 단계

궁금한 점이 더 있다면 AI Setup Assistant에게 물어보세요!

OpenClaw Expert

아직 막혀 있나요?

이 문서에서 답을 못 찾았다면 OpenClaw Expert에게 바로 물어보세요.