OpenClaw 작업 공간 구성: 두 달 사용 후 얻은 교훈

OpenClaw 사용자가 AI 코딩 에이전트를 두 달간 사용한 후 상세한 교훈을 공유하며, 작업 공간 구성이 도구 자체보다 더 중요하다고 강조했습니다. 이 개발자는 잘 구축된 작업 공간이 표준 설정에 비해 경험을 5-10배 향상시킨다는 사실을 발견했습니다.

SOUL.md 구성

"도움이 되고 전문적으로 행동하라"와 같은 일반적인 지침은 최소한의 영향만 미칩니다. 효과적인 SOUL.md 파일은 다음과 같아야 합니다:

• "답변을 먼저 제시하고, 그 다음에 맥락을 설명하라" 또는 "모르면 모른다고 말하고, 지어내지 마라"와 같은 구체적인 행동 방침 포함
• 모든 줄이 컨텍스트 창 토큰을 소비하므로 최대 50-150줄로 유지
• 일반적인 시나리오보다 예외 상황에 집중: 에이전트가 무언가를 모를 때, 요청이 범위를 벗어났을 때, 우선순위가 충돌할 때 어떻게 행동해야 하는지
• 모든 줄을 테스트: 삭제했을 때 에이전트 행동이 변하는가? 변하지 않으면 제거

표준 운영 절차로서의 AGENTS.md

이 파일은 "당신은 누구인가"(SOUL.md의 역할)보다 "어떻게 일하는가"에 답해야 합니다. 주요 통찰:

• 추가된 가장 가치 있는 규칙: "중요하지 않은 작업 전에 항상 memory_search를 먼저 실행하라"(추측 방지)
• 에이전트가 실수할 때 재발 방지 규칙 추가, 긍정적 지시보다 부정적 지시("Y를 확인하지 않고 X를 절대 하지 마라")가 더 효과적인 경우 많음
• 부트스트랩 파일의 규칙은 권고 사항일 뿐—모델이 강제되는 것이 아니라 요청받았기 때문에 따름
• 정말로 어겨서는 안 되는 규칙의 경우 강력한 마크다운 표현에 의존하기보다 도구 정책과 샌드박스 구성 사용

MEMORY.md 관리

이 파일은 모든 세션에 로드되므로 영구적으로 보존해야 하는 정보만 포함해야 합니다:

• 주요 결정, 사용자 선호도, 운영 교훈, 실수로부터 배운 규칙 포함
• 일일 정보는 memory/YYYY-MM-DD.md 파일에 저장하며, 에이전트가 필요할 때 검색
• 하드 제한: 파일당 20,000자, 모든 부트스트랩 파일 전체 150,000자—초과 시 자동 잘림 발생
• 채팅에 입력한 지침은 컨텍스트 압축 발생 후 지속되지 않음
• 작업 공간을 git에 연결하여 실수로 덮어쓴 MEMORY 파일을 커밋 기록에서 복구

USER.md 및 스킬 최적화

USER.md 파일은 과소평가됩니다—배경, 선호도, 시간대, 작업 맥락을 포함하면 반복이 줄고 토큰이 절약됩니다. 스킬의 경우:

• 30개의 스킬이 설치되어 있다고 해서 모든 프롬프트에 30개의 전체 스킬 파일이 주입되는 것은 아니지만, 스킬 목록 자체가 컨텍스트를 소비함
• 15개 이상의 스킬에서 5개로 줄이면 출력 품질이 눈에 띄게 향상됨
• 테스트: 만약 내일 스킬이 사라진다면, 알아차릴 것인가? 아니라면 제거

불량 설정의 일반적인 문제

페르소나 설정이 견고하지 않을 때, 이러한 문제들이 빠르게 나타납니다:

• 에이전트가 계속 표류하여 끝없는 루프에서 지속적인 수정 필요
• 스크립트로 가능한 작업에 브라우저를 여는 등 비효율적인 행동으로 토큰 낭비
• 너무 많은 스킬 로드로 컨텍스트가 부풀어 올라 적절한 기능 방해
• 동일한 작업에 대해 다른 세션 간 일관되지 않은 출력

전자상거래 분야에서 일하는 이 개발자는 대부분의 기존 페르소나가 부적절하다는 사실을 발견한 후 제품 조달 및 Shopify 운영 페르소나를 만들었습니다. 모든 산업에는 페르소나로 패키징될 수 있는 워크플로우가 있지만, 좋은 자료들은 유료 플랫폼, GitHub, 무작위 블로그, 오래된 게시물에 흩어져 있으며, 많은 "페르소나"가 단순히 바로 사용할 수 없는 단일 SOUL 파일에 불과하다고 언급했습니다.