에이전트 워크스페이스

개요

에이전트 워크스페이스는 에이전트의 주 작업 디렉토리이다. 에이전트의 지시사항, 페르소나, 메모리, 도구 설정 등 모든 부트스트랩 파일이 이 디렉토리에 위치한다.

기본 경로: ~/.openclaw/workspace

부트스트랩 파일

워크스페이스에 배치하는 핵심 파일들이다.

AGENTS.md

에이전트의 핵심 지시사항 파일이다. 에이전트의 행동 규칙, 응답 스타일, 작업 범위 등을 정의한다.

# 에이전트 지시사항

## 역할
고객 지원 담당 AI 에이전트

## 규칙
- 한국어로 응답
- 기술 용어는 영어 병기
- 모르는 질문은 솔직히 모른다고 답변

SOUL.md

에이전트의 성격과 페르소나를 정의한다.

# 페르소나
- 이름: 클로
- 성격: 친절하고 전문적
- 말투: 존댓말, 간결한 문장

메모리 구조

워크스페이스 내 memory/ 디렉토리에 메모리 파일을 저장한다.

workspace/
├── AGENTS.md
├── SOUL.md
├── MEMORY.md              ← 장기 기억 (핵심 요약)
└── memory/
    ├── 2026-03-30.md      ← 일별 메모리
    ├── 2026-03-31.md
    └── 2026-04-01.md

에이전트는 대화 중 중요한 정보를 발견하면 이 파일들에 기록하고, 다음 세션에서 참조한다.

경로 해석 규칙

워크스페이스는 하드 샌드박스가 아니다.

샌드박싱이 활성화되지 않은 상태에서는 에이전트가 절대 경로를 통해 시스템의 다른 디렉토리에 접근할 수 있다. 보안이 필요한 환경에서는 반드시 샌드박싱 설정을 함께 사용해야 한다.

워크스페이스 관리 권장 사항

Git 연동

워크스페이스를 비공개 Git 저장소로 관리하는 것을 권장한다.

cd ~/.openclaw/workspace
git init
git remote add origin git@github.com:user/openclaw-workspace.git

장점:

• 지시사항 변경 이력 추적
• 메모리 파일 백업
• 여러 환경 간 동기화

디렉토리 구조 예시

workspace/
├── AGENTS.md
├── SOUL.md
├── IDENTITY.md
├── USER.md
├── TOOLS.md
├── HEARTBEAT.md
├── BOOT.md
├── MEMORY.md
├── memory/
│   └── *.md
├── skills/
│   └── custom-skill/
├── hooks/
│   └── custom-hook/
└── data/
    └── (에이전트가 생성한 데이터)