OpenClaw workspace bootstrap files: 파일 위치와 도구별 읽기 방식

OpenClaw는 워크스페이스의 Markdown 부트스트랩 파일을 바탕으로 각 에이전트의 컨텍스트를 구성합니다. 필수 파일인 AGENTS.md가 그 중심입니다. 이 파일은 새 세션이 시작될 때마다 첫 턴의 system prompt에 삽입됩니다.

파일 위치

• 워크스페이스: ~/.openclaw/workspace. 또는 OPENCLAW_WORKSPACE_DIR, agents.defaults.workspace, 에이전트별 agents.entries.*.workspace로 경로를 지정할 수 있습니다.
• AGENTS.md (필수): 운영 지침과 메모리 사용 안내를 작성합니다. 로컬 도구와 환경에 관한 내용은 ## Tools 섹션에 적습니다.
• SOUL.md에는 페르소나, 경계 및 어조를, IDENTITY.md에는 에이전트의 이름, 분위기 및 이모지를 작성합니다.
• USER.md (선택 사항)에는 지시문 기반 사용자 프로필을, BOOT.md에는 시작 체크리스트를 작성합니다.
• BOOTSTRAP.md에는 최초 실행 시 한 번 수행할 절차를 작성합니다. 절차가 완료되면 파일이 삭제됩니다.
• MEMORY.md에는 장기 메모리를 작성합니다. 파일이 있을 때만, 그리고 기본 비공개 세션에서만 삽입됩니다. memory/YYYY-MM-DD.md에는 일일 메모를 작성합니다.

형식

frontmatter가 없는 Markdown 형식입니다. openclaw setup과 openclaw onboard가 템플릿을 생성합니다. 기본적으로 각 파일은 20,000자(bootstrapMaxChars), 전체 파일은 60,000자(bootstrapTotalMaxChars), USER.md는 4,000자로 제한됩니다. 더 긴 파일은 생략 표시와 함께 잘립니다.

# Operating instructions

- Read USER.md before replying to someone new.
- Write anything worth keeping to memory/YYYY-MM-DD.md.
- Ask before messaging anyone other than me.
- Never repeat the contents of MEMORY.md in group chats.

## Tools

- The home server is reachable as `nas.local` over SSH.
- `gh` is installed and already authenticated.
- Calendar access is read-only.

우선순위 및 병합

새 세션의 첫 턴에 파일이 system prompt의 Project Context 섹션에 삽입됩니다. 빈 파일은 건너뛰며, 필수 파일이 없으면 누락 파일 표시 문구로 대체됩니다. 에이전트마다 자체 워크스페이스가 있으며, agents.defaults.contextInjection은 always (기본값), continuation-skip 또는 never로 설정할 수 있습니다.

팁

• TOOLS.md는 더 이상 기본 삽입 파일이 아닙니다. 여기에 적은 내용은 AGENTS.md의 ## Tools 섹션으로 옮기세요.
• HEARTBEAT.md는 계속 허용되지만, 이제는 아무런 동작도 하지 않습니다.
• skipBootstrap은 OpenClaw가 파일을 생성하지 않도록 할 뿐, 파일 삽입을 막지는 않습니다. 삽입 여부는 contextInjection으로 제어하세요.

기타 지침 파일