OpenClaw 데이터 저장 위치 및 안전한 백업 가이드

새로운 도구를 사용할 때 가장 먼저 드는 걱정은 “내 데이터가 정확히 어디에 저장되는 걸까?” 하는 점일 거예요. 특히 AI 에이전트를 다룰 때는 설정 파일, 대화 기록, 그리고 민감한 API 키가 어디에서 관리되는지 명확히 아는 것이 중요하죠. OpenClaw가 데이터를 어떻게 처리하고 어디에 보관하는지 핵심 내용을 정리해 드릴게요.

데이터 저장 위치

OpenClaw가 데이터를 어디에 저장하고, 어떻게 백업해야 하는지 이해해 보세요.

---

OpenClaw에서 사용하는 모든 데이터는 로컬에 저장되나요?

아니요. OpenClaw의 상태(state)는 로컬에 저장되지만, 외부 서비스는 여러분이 보낸 데이터를 확인하게 됩니다.

• 기본적으로 로컬 저장: 세션, 메모리 파일, 설정(config), 그리고 workspace는 Gateway 호스트(~/.openclaw + 사용자의 workspace 디렉토리)에 저장돼요.
• 필요에 따른 원격 저장: 모델 공급자(Anthropic, OpenAI 등)에게 보내는 메시지는 해당 API로 전송되며, 채팅 플랫폼(WhatsApp, Telegram, Slack 등)은 메시지 데이터를 해당 서버에 저장합니다.
• 사용자가 제어하는 범위: 로컬 모델을 사용하면 프롬프트를 자신의 머신에 유지할 수 있지만, 채널 트래픽은 여전히 해당 채널의 서버를 통과하게 됩니다.

---

OpenClaw는 데이터를 어디에 저장하나요?

모든 데이터는 $OPENCLAW_STATE_DIR (기본값: ~/.openclaw) 아래에 저장됩니다.

경로	용도
$OPENCLAW_STATE_DIR/openclaw.json	메인 설정 파일 (JSON5)
$OPENCLAW_STATE_DIR/credentials/oauth.json	레거시 OAuth 임포트
$OPENCLAW_STATE_DIR/agents/<agentId>/agent/auth-profiles.json	인증 프로필 (OAuth + API 키)
$OPENCLAW_STATE_DIR/agents/<agentId>/agent/auth.json	런타임 인증 캐시
$OPENCLAW_STATE_DIR/credentials/	공급자 상태 (예: whatsapp/<accountId>/creds.json)
$OPENCLAW_STATE_DIR/agents/	에이전트별 상태 (agentDir + 세션)
$OPENCLAW_STATE_DIR/agents/<agentId>/sessions/	대화 기록 및 상태

사용자의 workspace(AGENTS.md, 메모리 파일, 기술 등)는 별도로 분리되어 있으며, agents.defaults.workspace(기본값: ~/.openclaw/workspace)를 통해 설정할 수 있어요.

---

AGENTS.md / SOUL.md / USER.md / MEMORY.md 파일은 어디에 있어야 하나요?

이 파일들은 ~/.openclaw가 아니라 agent workspace에 위치해야 합니다.

• Workspace (에이전트별): AGENTS.md, SOUL.md, IDENTITY.md, USER.md, MEMORY.md, memory/YYYY-MM-DD.md, 선택 사항인 HEARTBEAT.md
• 상태 디렉토리 (~/.openclaw): 설정, 자격 증명, 인증 프로필, 세션, 로그

기본 workspace는 ~/.openclaw/workspace이며, 아래와 같이 설정할 수 있어요.

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } }
}

---

권장하는 백업 전략은 무엇인가요?

agent workspace를 private git repo에 넣고 안전한 곳에 백업하세요. 이렇게 하면 메모리와 AGENTS/SOUL/USER 파일을 보존할 수 있습니다.

~/.openclaw 아래에 있는 내용(자격 증명, 세션, 토큰 등)은 절대 커밋하지 마세요. 전체 복구가 필요한 경우에는 workspace와 상태 디렉토리를 각각 별도로 백업해야 합니다.

---

OpenClaw를 완전히 삭제하려면 어떻게 하나요?

전용 가이드를 참고해 주세요: Uninstall

---

에이전트가 workspace 외부에서도 작동할 수 있나요?

네, 가능해요. workspace는 기본 cwd(현재 작업 디렉토리)이자 메모리의 기준점일 뿐, 엄격한 샌드박스는 아니에요. 상대 경로는 workspace 내부에서 해결되지만, 샌드박스 설정이 활성화되어 있지 않다면 절대 경로를 통해 호스트의 다른 위치에 접근할 수 있습니다.

특정 repo를 기본 작업 디렉토리로 사용하고 싶다면, 해당 에이전트의 workspace를 repo 루트로 지정하세요.

{
  agents: {
    defaults: {
      workspace: "~/Projects/my-repo"
    }
  }
}

---

remote mode를 사용 중인데, session 저장소는 어디에 있나요?

세션 상태는 gateway host가 소유합니다. remote mode를 사용 중이라면, 관리해야 할 session 저장소는 로컬 노트북이 아니라 원격 머신에 있습니다.

AI Setup Assistant

다음 단계

• 설치 가이드
• 에이전트 설정하기