OpenClaw System Prompt 이해하기

AI 에이전트를 개발하다 보면 시스템 프롬프트가 너무 비대해져서 모델이 핵심 지시사항을 놓치는 경우가 자주 생겨요. 프롬프트가 일관되지 않으면 에이전트의 행동을 예측하기 어렵고, 매번 수동으로 컨텍스트를 주입하는 것도 번거로운 일이죠.

OpenClaw는 이런 문제를 해결하기 위해 에이전트 실행 시마다 최적화된 전용 System Prompt를 직접 빌드해서 주입해 줍니다.

필요한 것

• OpenClaw 설치 및 실행 환경
• 프로젝트 루트의 설정 파일 (AGENTS.md, SOUL.md 등)
• Node.js 환경

빠른 시작

OpenClaw의 시스템 프롬프트는 자동으로 구성되지만, 다음 4가지 단계를 통해 현재 상태를 확인하고 제어할 수 있어요.

1. 컨텍스트 확인하기: 터미널에서 /context list 명령어를 입력하세요. 주입된 파일들의 크기와 툴 스키마 오버헤드를 바로 확인할 수 있어요.
2. 상세 내용 점검: /context detail을 사용하면 각 파일이 어떻게 잘리고 주입되었는지 구체적으로 보여줍니다.
3. 시간대 설정: agents.defaults.userTimezone을 설정하세요. 시스템 프롬프트에 해당 타임존 정보가 포함되어 에이전트가 시간을 인식하게 됩니다.
4. 파일 준비: AGENTS.md나 SOUL.md 파일을 워크스페이스에 만드세요. OpenClaw가 이 파일들을 읽어 Project Context 섹션에 자동으로 넣어줍니다.

주요 특징

Prompt Modes

OpenClaw는 상황에 따라 세 가지 모드로 프롬프트를 렌더링해요.

• full: 모든 섹션을 포함하는 기본 모드예요.
• minimal: 서브 에이전트용이며, Skills나 Memory Recall 같은 무거운 섹션을 제외해요.
• none: 기본 ID 라인만 반환해요.

Bootstrap Injection

워크스페이스의 주요 파일들은 Project Context 아래에 자동으로 추가돼요. 모델이 별도로 파일을 읽지 않아도 자신의 정체성과 프로필을 알 수 있게 해줍니다.

• AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md 등이 대상이에요.
• 각 파일은 기본적으로 최대 20,000자(agents.defaults.bootstrapMaxChars)까지 포함되며, 초과하면 잘리게 돼요.
• agent:bootstrap 훅을 사용하면 이 과정을 가로채서 내용을 수정하거나 교체할 수 있어요.

Skills 및 Documentation

사용 가능한 Skill이 있다면 프롬프트에 <available_skills> 리스트가 포함돼요. 모델은 이 리스트의 경로를 보고 필요할 때 read 툴로 상세 지시사항을 읽어옵니다. 또한, 로컬 OpenClaw 문서 위치도 프롬프트에 포함되어 에이전트가 스스로 설정을 참조할 수 있어요.

문제 해결

• 보안 정책이 적용되지 않나요?: 시스템 프롬프트의 Safety 가이드라인은 권고 사항일 뿐이에요. 강제적인 정책 적용이 필요하다면 Tool policy, 실행 승인(exec approvals), Sandbox 기능을 사용해야 합니다.
• 시간 정보가 부정확한가요?: 프롬프트 캐시 효율을 위해 OpenClaw는 동적 시계 대신 타임존 정보만 프롬프트에 넣어요. 정확한 현재 시간이 필요하다면 에이전트가 session_status를 확인하도록 하세요.

---

도움이 필요하신가요? AI Setup Assistant에게 물어보세요.

다음 단계

• Context 관련 개념 보기
• 날짜 및 시간 설정 상세 가이드