Workspace 파일과 운영
기준일: 2026-07-13 난이도: 초급 공식 기준: Agent workspace, Workspace templates
Workspace의 파일명과 역할은 공식 agent workspace와 template 문서에서 확인해야 합니다. 임의 폴더 트리, 자동 정리 key, 파일 크기 제한을 제품 기본값처럼 문서화하지 않습니다.
핵심 개념
공식 문서가 설명하는 workspace 파일에는 AGENTS.md, BOOT.md, BOOTSTRAP.md, HEARTBEAT.md, IDENTITY.md, SOUL.md, TOOLS.md, USER.md와 memory 관련 파일이 포함될 수 있습니다. 모든 파일이 항상 필요한 것은 아니며 onboarding과 agent 구성에 따라 달라집니다.
| 파일군 | 목적 |
|---|---|
| AGENTS·BOOT 계열 | agent 지침과 startup behavior |
| IDENTITY·SOUL·USER | identity와 사용자 context |
| TOOLS | 환경별 tool 사용 메모 |
| HEARTBEAT | heartbeat 관련 지침 |
| memory | 지속 context와 회상 자료 |
| skills | workspace-local SKILL.md |
선택 기준
- 기존 파일을 덮어쓰기 전에 현재 내용을 읽고 목적을 확인합니다.
- secret과 credential은 workspace 지침 파일에 넣지 않습니다.
- 자동 정리나 retention은 추측한 key가 아니라 live schema와 해당 공식 reference로 설정합니다.
- workspace backup은
openclaw backup의 source plan을 기준으로 합니다.
실습
openclaw config get agents.defaults.workspace
openclaw backup create --dry-run --json
openclaw config validate --json
Workspace 파일을 변경한 뒤에는 다음 agent turn 또는 새 session에서 실제로 로드됐는지 확인합니다.
도구에 입력할 프롬프트
이 OpenClaw workspace 파일을 공식 template 기준으로 검토해줘.
각 파일의 목적, 중복 지침, secret 노출, memory에 부적합한 내용을 찾고
근거가 없는 새 config key나 폴더 구조는 만들지 마.
체크리스트
- 공식 template이 설명하는 파일만 제품 기능으로 다뤘다.
- identity, instructions, memory의 역할을 구분했다.
- secret을 workspace Markdown에 저장하지 않았다.
- backup dry-run으로 실제 포함 경로를 확인했다.
- 변경 뒤 실제 agent context에서 로딩을 확인했다.
다음 단계
- Agent Workspace 개요에서 privacy 경계를 확인합니다.
- 메모리 시스템에서 memory 저장 기준을 정합니다.
- Skills 로딩과 실행에서 workspace Skills 우선순위를 봅니다.