개요

OpenClaw는 에이전트 실행마다 맞춤형 시스템 프롬프트를 구성한다. 단순히 고정된 프롬프트를 사용하는 것이 아니라, 에이전트의 도구, 스킬, 작업 환경, 보안 정책 등을 종합하여 매 턴마다 동적으로 프롬프트를 조립한다.

프롬프트 구성 섹션

시스템 프롬프트는 다음 섹션들로 구성된다.

섹션설명
Tooling사용 가능한 도구 목록 및 사용 방법
Safety안전 가드레일 및 제한 사항
Skills활성화된 스킬 정보
Workspace작업 디렉토리 구조 및 파일 목록
Docs주입된 문서 (AGENTS.md, SOUL.md 등)
Injected Files추가 주입 파일
Sandbox샌드박스 환경 정보
Date/Time현재 날짜 및 시간대
Runtime Specs런타임 사양 (모델, 토큰 제한 등)

프롬프트 모드

에이전트 실행 컨텍스트에 따라 세 가지 모드를 지원한다.

full (전체)

기본 모드. 모든 섹션을 포함하여 완전한 시스템 프롬프트를 구성한다.

  • 주 에이전트 실행 시 사용
  • 도구, 스킬, 워크스페이스, 문서 등 전체 정보 포함
  • 최대 크기의 컨텍스트 활용

minimal (최소)

서브 에이전트 실행 시 사용한다.

  • 필수 도구 정보만 포함
  • 워크스페이스 및 스킬 정보 축소
  • 토큰 사용량 절감

none (없음)

아이덴티티 정보만 포함하는 최소 모드.

  • 에이전트 이름과 기본 정체성만 전달
  • 특수 목적 실행에 사용

부트스트랩 파일 주입

매 턴마다 다음 부트스트랩 파일이 시스템 프롬프트에 주입된다.

파일역할
AGENTS.md에이전트 지시사항 및 메모리
SOUL.md에이전트 페르소나 정의
MEMORY.md장기 기억 데이터

이 파일들은 워크스페이스 디렉토리에 위치하며, 에이전트가 실행될 때마다 최신 내용이 반영된다.

크기 제한

항목제한
파일당 최대 크기20,000자
전체 주입 총량150,000자

주입 파일이 크기 제한을 초과하면 잘려서 포함된다. 중요한 정보는 파일 상단에 배치하는 것을 권장한다.

안전 가드레일

시스템 프롬프트에 포함되는 Safety 섹션은 권고(advisory) 수준이다. 모델에게 “이렇게 행동하라"는 지시를 제공하지만 강제력은 없다.

실제 강제 적용은 다음 메커니즘으로 이루어진다.

메커니즘설명
도구 정책 (Tool Policies)특정 도구의 사용 허용/차단
실행 승인 (Exec Approvals)셸 명령 실행 전 허용 목록 검증
샌드박싱격리된 환경에서의 도구 실행

프롬프트 수준의 가드레일은 모델의 행동을 안내하고, 하드 레벨의 메커니즘이 실제 보안을 담당하는 이중 구조이다.

프롬프트 구성 예시

┌─────────────────────────────────────┐
│          System Prompt              │
├─────────────────────────────────────┤
│ [Runtime Specs]                     │
│   model: claude-sonnet-4-20250514        │
│   maxTokens: 8192                   │
├─────────────────────────────────────┤
│ [Date/Time]                         │
│   2026-04-01T09:00:00+09:00         │
├─────────────────────────────────────┤
│ [Safety]                            │
│   advisory guardrails...            │
├─────────────────────────────────────┤
│ [Tooling]                           │
│   exec, read, write, edit, browser  │
├─────────────────────────────────────┤
│ [Skills]                            │
│   web-search, image-gen...          │
├─────────────────────────────────────┤
│ [Workspace]                         │
│   ~/.openclaw/workspace/            │
├─────────────────────────────────────┤
│ [Docs] AGENTS.md, SOUL.md, MEMORY  │
├─────────────────────────────────────┤
│ [Sandbox]                           │
│   mode: docker, network: off        │
└─────────────────────────────────────┘