--- title: "OpenClaw workspace bootstrap files: 경로 및 형식 · DotsAgent" description: "~/.openclaw/workspace/AGENTS.md의 위치와 형식, frontmatter, 전역 및 중첩 파일의 병합 방식, 이 파일을 읽는 도구를 확인하세요. 2026-10-01에 확인했습니다." url: https://dotsagent.io/ko/instructions/files/openclaw-workspace --- ~/.openclaw/workspace/AGENTS.md # 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자로 제한됩니다. 더 긴 파일은 생략 표시와 함께 잘립니다. `~/.openclaw/workspace/AGENTS.md` ``` # 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으로 제어하세요. 양식 하나로 다섯 가지 도구에 사용할 AGENTS.md와 규칙 파일을 생성하세요. [AGENTS.md 생성기 열기 →](https://dotsagent.io/ko/instructions) ## 기타 지침 파일 [AGENTS.md](https://dotsagent.io/ko/instructions/files/agents-md) [CLAUDE.md](https://dotsagent.io/ko/instructions/files/claude-md) [GEMINI.md](https://dotsagent.io/ko/instructions/files/gemini-md) [.cursor/rules/*.mdc](https://dotsagent.io/ko/instructions/files/cursor-rules) [.github/copilot-instructions.md](https://dotsagent.io/ko/instructions/files/github-copilot-instructions) [.devin/rules/*.md](https://dotsagent.io/ko/instructions/files/windsurf-rules) [.clinerules/](https://dotsagent.io/ko/instructions/files/cline-rules) ## 출처 1. [docs.openclaw.ai](https://docs.openclaw.ai/concepts/agent)/concepts/agent 2. [docs.openclaw.ai](https://docs.openclaw.ai/concepts/agent-workspace)/concepts/agent-workspace 3. [docs.openclaw.ai](https://docs.openclaw.ai/start/bootstrapping)/start/bootstrapping 4. [docs.openclaw.ai](https://docs.openclaw.ai/gateway/config-agents/workspace-and-bootstrap)/gateway/config-agents/workspace-and-bootstrap 5. [docs.openclaw.ai](https://docs.openclaw.ai/reference/templates/AGENTS.md)/reference/templates/AGENTS.md AI 에이전트를 만드는 개발자를 위한 독립적인 참고 자료입니다. 여기에 언급된 어떤 업체와도 제휴 관계가 없습니다. © 2026 DotsAgent · 정보 확인일: 2026년 10월 1일