OpenClaw를 쓰다 보면 AGENTS.md, SOUL.md, USER.md, MEMORY.md처럼 이름이 비슷한 파일을 만나게 됩니다. 이 파일들은 단순한 메모 모음이 아니라, 에이전트가 작업할 기본 폴더와 매 세션에 참고할 운영 맥락을 나누는 구조입니다.
이 글은 OpenClaw 공식 Agent workspace와 Memory overview 문서를 바탕으로, 각 파일을 어떤 역할로 나누면 좋은지 정리합니다. 설정 파일이나 인증 정보가 들어 있는 ~/.openclaw/와 작업공간은 같은 장소가 아니라는 점도 먼저 기억해 두세요.
1. 워크스페이스는 에이전트의 작업 폴더
OpenClaw에서 워크스페이스는 파일 도구의 기본 작업 위치이자 에이전트가 참고하는 문서의 집입니다. 기본 경로는 일반적으로 ~/.openclaw/workspace이지만, 프로필·상태 디렉터리·에이전트별 설정에 따라 달라질 수 있습니다.
중요한 점은 워크스페이스가 자동으로 완전한 보안 격리가 되는 것은 아니라는 것입니다. 상대 경로는 이 폴더를 기준으로 해석되지만, 샌드박스 설정이 없다면 도구가 절대 경로로 다른 위치에 접근할 수 있습니다. 민감한 파일을 다룬다면 별도 샌드박스와 접근 권한 설정을 검토해야 합니다.
2. AGENTS.md에는 작업 규칙을 둡니다
AGENTS.md는 에이전트가 매 세션에 읽는 운영 지침 파일입니다. 프로젝트의 작업 방식, 금지할 행동, 기록 방법, 로컬 도구 이름처럼 “어떻게 일할지”에 해당하는 내용을 둡니다.
- 프로젝트별 우선순위와 검토 기준
- 파일·배포·외부 전송 전에 지켜야 할 규칙
- 로컬 서비스나 장비의 별칭
- 메모를 남기는 방식
비밀번호·토큰·개인식별정보를 이 파일에 적는 것은 피해야 합니다. 지침과 비밀값의 역할을 섞으면 백업이나 공유 과정에서 노출 위험이 커집니다.
3. SOUL.md와 IDENTITY.md는 말투와 정체성을 나눕니다
SOUL.md는 에이전트의 톤, 경계, 판단 기준처럼 일관된 태도를 담는 파일입니다. 반면 IDENTITY.md는 이름·분위기·이모지처럼 표시되는 정체성 정보를 위한 파일입니다.
업무 절차를 바꿔야 할 때는 AGENTS.md, 말투와 경계를 다듬을 때는 SOUL.md, 표시 정보를 정할 때는 IDENTITY.md처럼 목적에 맞게 나누면 수정 이유를 추적하기 쉽습니다.
4. USER.md는 바뀔 수 있는 사용자 지침용
USER.md에는 안정적인 선호, 소통 방식, 관계 맥락, 진행 중인 프로젝트처럼 사용자를 돕기 위해 지속적으로 참고할 내용을 둡니다. 공식 문서는 항목을 명령형으로 쓰고 관찰 날짜와 활성·대체 상태를 함께 기록하는 방식을 안내합니다.
예를 들어 “항상 배포 전에 테스트 결과를 먼저 요약한다”처럼 행동으로 확인 가능한 문장이 좋습니다. 선호가 바뀌면 예전 항목을 지우기보다 대체 상태를 표시해 충돌하는 지침이 남지 않게 관리합니다.
5. MEMORY.md와 날짜별 메모는 깊이가 다릅니다
MEMORY.md는 오래 유지할 결정과 요약을 위한 짧은 장기 메모입니다. 반면 memory/YYYY-MM-DD.md는 그날의 관찰, 작업 맥락, 아직 정리되지 않은 세부 기록을 남기는 일지입니다.
- USER.md: 사용자에 관한 안정적 지침
- MEMORY.md: 오래 유지할 비사용자 사실과 결정
- memory/YYYY-MM-DD.md: 날짜가 있는 작업 기록과 관찰
- DREAMS.md: 선택적으로 검토할 드리밍 요약
장기 메모에 원본 대화나 상세 로그를 전부 넣으면 시작할 때 읽을 내용이 길어집니다. 일지에 세부를 남기고, 시간이 지나도 필요한 결론만 MEMORY.md로 옮기는 편이 관리하기 쉽습니다.
6. 설정·세션·자격 증명은 작업공간과 분리합니다
OpenClaw 공식 문서는 설정, 세션, 자격 증명이 들어 있는 ~/.openclaw/ 아래 파일을 워크스페이스 저장소에 넣지 말라고 안내합니다. 워크스페이스를 Git으로 백업한다면 비공개 저장소를 사용하고, API 키·OAuth 토큰·비밀번호·개인 파일은 커밋 대상에서 제외합니다.
워크스페이스를 다른 컴퓨터로 옮길 때도 작업 파일만 복사했다고 설정과 세션이 함께 옮겨지는 것은 아닙니다. 필요한 설정과 세션은 별도로, 그리고 안전한 방법으로 이전해야 합니다.
빠른 정리
- 작업 규칙은 AGENTS.md
- 말투와 경계는 SOUL.md
- 사용자 선호는 USER.md
- 오래 남길 결정은 MEMORY.md
- 작업 일지는 memory/YYYY-MM-DD.md
- 자격 증명과 설정은 워크스페이스 밖에서 관리
공식 문서
업데이트 기준: 2026-09-12. 이 글은 OpenClaw 공식 문서를 한국어 독자에게 맞게 재구성한 설명이며, 개인 사용 경험이나 보안 보장을 주장하지 않습니다.
'OpenClaw 자동화' 카테고리의 다른 글
| OpenClaw 페어링이란? 낯선 DM·새 기기를 승인하기 전에 확인할 점 (0) | 2026.09.15 |
|---|---|
| OpenClaw 채널은 어떻게 고를까｜텔레그램·카톡·디스코드 연결 전 확인할 점 (0) | 2026.09.13 |
| OpenClaw 처음 설정하기｜Quick start로 게이트웨이·대시보드까지 확인하는 순서 (0) | 2026.09.11 |
| OpenClaw는 대화를 어떻게 기억할까?｜메모리 구조와 드리밍 쉽게 이해하기 (1) | 2026.09.06 |
| OpenClaw 2026.9.1 업데이트에서 달라진 것들｜다이어그램·원클릭 설치·안전한 자동 업데이트 (0) | 2026.09.06 |