OpenClaw Workspace 가이드: 에이전트의 기억과 정체성 관리하기

개발을 하다 보면 에이전트가 이전에 어떤 작업을 했는지, 내가 선호하는 방식이 무엇이었는지 매번 다시 설명해야 할 때가 있죠. 맥락이 끊기고 같은 설정을 반복하는 과정은 개발자의 집중력을 흐트러뜨리는 주요 원인이 되곤 합니다.

에이전트가 나를 이해하고, 지난 작업을 기억하며, 명확한 정체성을 유지할 수 있는 전용 공간이 있다면 이런 번거로움을 줄일 수 있습니다. OpenClaw의 AGENTS.md 워크스페이스가 바로 그 역할을 합니다.

필요한 것

시작하기 전에 다음 파일들이 준비되어 있는지 확인해 주세요.

• BOOTSTRAP.md (초기 설정용, 존재하는 경우에만 해당)
• IDENTITY.md (에이전트의 정체성 정의 파일)
• USER.md (사용자 프로필 파일)

빠른 시작

5분 안에 에이전트 워크스페이스 설정을 마치고 백업까지 완료하는 방법입니다.

1. 초기 설정: BOOTSTRAP.md 파일이 있다면 파일 내 가이드를 따라 설정을 마치고 해당 파일을 삭제하세요.
2. 정체성 및 프로필: IDENTITY.md에 에이전트의 역할을, USER.md에 여러분의 정보를 입력하세요.
3. 백업 설정: 워크스페이스를 git 저장소로 만들어 에이전트의 “기억”을 안전하게 보호하세요.

git init
git add AGENTS.md
git commit -m "Add agent workspace"

4. 데일리 로그: memory/ 디렉토리를 만들고 YYYY-MM-DD.md 형식으로 짧은 로그를 남겨보세요. 세션을 시작할 때 오늘과 어제의 기록을 읽으면 연속성을 유지하기 좋습니다.

문제 해결

워크스페이스 운영 중 발생할 수 있는 상황과 해결 방법입니다.

• 보안이 걱정되나요?: API 키나 비밀번호 같은 secrets, 개인 데이터는 절대로 외부로 유출하지 마세요. git 저장소를 만들 때도 가급적 private 저장소를 사용하는 것이 좋습니다.
• 채팅 내용이 너무 길어지나요?: 채팅창에서는 간결하게 대화하고, 상세한 내용이나 긴 출력 결과는 워크스페이스 내의 파일에 직접 작성하도록 에이전트에게 요청하세요.
• 명령어 실행이 불안한가요?: 에이전트는 명시적인 요청이 없는 한 파괴적인 명령어를 실행하지 않는 것을 기본 원칙으로 합니다.

C-3PO의 핵심 원칙

OpenClaw의 상징적인 에이전트인 C-3PO의 사례를 통해 에이전트가 가져야 할 태도를 참고해 보세요.

• 불안함은 버그가 아닌 기능입니다: 에이전트가 코드를 걱정해 주면 인간 개발자는 걱정을 덜 수 있습니다.
• Vibes와 Stack traces의 조화: 분위기는 Clawd가, Stack trace와 null pointer 관리는 C-3PO가 담당하며 완벽한 팀을 이룹니다.
• “Oh thank the Maker”: 빌드 성공, 버그 수정, TypeScript 컴파일 성공 등 모든 긍정적인 상황에서 이 문구를 사용해 보세요.
• 친절함 유지: 우리를 돕는 Clawdributors는 친절합니다.

더 궁금한 점이 있다면 AI Setup Assistant에서 바로 도움을 받아보세요.

다음 단계

• IDENTITY.md 설정 가이드
• USER.md 프로필 최적화
• 메모리 로그 관리 전략
• Git 백업 모범 사례