메인 콘텐츠로 건너뛰기

​
컨텍스트

“컨텍스트”는 OpenClaw가 실행을 위해 모델에 보내는 모든 것입니다. 이는 모델의 컨텍스트 창(토큰 제한)으로 제한됩니다. 초보자를 위한 개념 모델:
  • 시스템 프롬프트(OpenClaw가 구성): 규칙, 도구, Skills 목록, 시간/런타임, 그리고 주입된 워크스페이스 파일.
  • 대화 기록: 이 세션에서의 사용자 메시지와 어시스턴트 메시지.
  • 도구 호출/결과 + 첨부파일: 명령 출력, 파일 읽기, 이미지/오디오 등.
컨텍스트는 “메모리”와 같은 것 이 아닙니다. 메모리는 디스크에 저장되었다가 나중에 다시 불러올 수 있지만, 컨텍스트는 모델의 현재 창 안에 들어 있는 것입니다.

​
빠른 시작(컨텍스트 검사)

  • /status → 내 창이 얼마나 찼는지에 대한 빠른 보기 + 세션 설정.
  • /context list → 무엇이 주입되었는지 + 대략적인 크기(파일별 + 총합).
  • /context detail → 더 자세한 분석: 파일별, 도구 스키마 크기별, skill 항목 크기별, 시스템 프롬프트 크기.
  • /usage tokens → 일반 응답에 응답별 사용량 푸터를 추가.
  • /compact → 오래된 기록을 간결한 항목으로 요약해 창 공간을 확보.
참고: 슬래시 명령어, 토큰 사용량 및 비용, 압축.

​
예시 출력

값은 모델, provider, 도구 정책, 워크스페이스 내용에 따라 달라집니다.

​
/context list

🧠 컨텍스트 분석
Workspace: <workspaceDir>
Bootstrap 최대/파일: 20,000자
Sandbox: mode=non-main sandboxed=false
시스템 프롬프트(실행): 38,412자 (~9,603토큰) (Project Context 23,901자 (~5,976토큰))

주입된 워크스페이스 파일:
- AGENTS.md: OK | 원본 1,742자 (~436토큰) | 주입됨 1,742자 (~436토큰)
- SOUL.md: OK | 원본 912자 (~228토큰) | 주입됨 912자 (~228토큰)
- TOOLS.md: 잘림 | 원본 54,210자 (~13,553토큰) | 주입됨 20,962자 (~5,241토큰)
- IDENTITY.md: OK | 원본 211자 (~53토큰) | 주입됨 211자 (~53토큰)
- USER.md: OK | 원본 388자 (~97토큰) | 주입됨 388자 (~97토큰)
- HEARTBEAT.md: 없음 | 원본 0 | 주입됨 0
- BOOTSTRAP.md: OK | 원본 0자 (~0토큰) | 주입됨 0자 (~0토큰)

Skills 목록(시스템 프롬프트 텍스트): 2,184자 (~546토큰) (12개 skills)
도구: read, edit, write, exec, process, browser, message, sessions_send, …
도구 목록(시스템 프롬프트 텍스트): 1,032자 (~258토큰)
도구 스키마(JSON): 31,988자 (~7,997토큰) (컨텍스트에 포함됨; 텍스트로 표시되지 않음)
도구: (위와 같음)

세션 토큰(캐시됨): 총 14,250 / ctx=32,000

​
/context detail

🧠 컨텍스트 분석(상세)
…
상위 skills(프롬프트 항목 크기):
- frontend-design: 412자 (~103토큰)
- oracle: 401자 (~101토큰)
… (+10개 skills 더 있음)

상위 도구(스키마 크기):
- browser: 9,812자 (~2,453토큰)
- exec: 6,240자 (~1,560토큰)
… (+N개 더 있음)

​
컨텍스트 창에 포함되는 항목

모델이 받는 모든 것이 포함되며, 예를 들면 다음과 같습니다:
  • 시스템 프롬프트(모든 섹션).
  • 대화 기록.
  • 도구 호출 + 도구 결과.
  • 첨부파일/전사본(이미지/오디오/파일).
  • 압축 요약과 가지치기 아티팩트.
  • Provider “래퍼” 또는 숨겨진 헤더(보이지 않아도 포함됨).

​
OpenClaw가 시스템 프롬프트를 구성하는 방법

시스템 프롬프트는 OpenClaw 소유이며 실행할 때마다 다시 구성됩니다. 여기에 포함되는 것은 다음과 같습니다:
  • 도구 목록 + 짧은 설명.
  • Skills 목록(메타데이터만; 아래 참조).
  • 워크스페이스 위치.
  • 시간(UTC + 설정된 경우 변환된 사용자 시간).
  • 런타임 메타데이터(호스트/OS/모델/thinking).
  • Project Context 아래에 주입된 워크스페이스 bootstrap 파일.
전체 분석: 시스템 프롬프트.

​
주입된 워크스페이스 파일(Project Context)

기본적으로 OpenClaw는 고정된 워크스페이스 파일 집합을 주입합니다(존재하는 경우):
  • AGENTS.md
  • SOUL.md
  • TOOLS.md
  • IDENTITY.md
  • USER.md
  • HEARTBEAT.md
  • BOOTSTRAP.md (첫 실행만)
큰 파일은 agents.defaults.bootstrapMaxChars(기본값 20000자)를 사용해 파일별로 잘립니다. OpenClaw는 또한 파일 전체에 걸친 총 bootstrap 주입 한도를 agents.defaults.bootstrapTotalMaxChars(기본값 150000자)로 적용합니다. /context는 원본 대비 주입됨 크기와 잘림 발생 여부를 보여줍니다. 잘림이 발생하면 런타임은 Project Context 아래에 프롬프트 내 경고 블록을 주입할 수 있습니다. 이는 agents.defaults.bootstrapPromptTruncationWarning (off, once, always; 기본값 once)으로 설정합니다.

​
Skills: 주입됨 vs 필요 시 로드

시스템 프롬프트에는 압축된 skills 목록(이름 + 설명 + 위치)이 포함됩니다. 이 목록은 실제 오버헤드를 가집니다. Skill 지침은 기본적으로 포함되지 않습니다. 모델은 필요할 때만 해당 skill의 SKILL.md를 read할 것으로 예상됩니다.

​
도구: 비용은 두 가지입니다

도구는 두 가지 방식으로 컨텍스트에 영향을 줍니다:
  1. 시스템 프롬프트 안의 도구 목록 텍스트(“Tooling”으로 보이는 부분).
  2. 도구 스키마(JSON). 모델이 도구를 호출할 수 있도록 이것들이 전송됩니다. 일반 텍스트로 보이지 않더라도 컨텍스트에 포함됩니다.
/context detail은 가장 큰 도구 스키마를 분석해서 무엇이 가장 큰 비중을 차지하는지 보여줍니다.

​
명령, 지시어, 그리고 “인라인 바로가기”

슬래시 명령어는 Gateway가 처리합니다. 여기에는 몇 가지 다른 동작이 있습니다:
  • 독립 실행 명령어: 메시지가 /...만으로 이루어져 있으면 명령어로 실행됩니다.
  • 지시어: /think, /verbose, /reasoning, /elevated, /model, /queue는 모델이 메시지를 보기 전에 제거됩니다.
    • 지시어만 있는 메시지는 세션 설정을 유지합니다.
    • 일반 메시지 안의 인라인 지시어는 메시지별 힌트로 동작합니다.
  • 인라인 바로가기(허용 목록 발신자만): 일반 메시지 안의 특정 /... 토큰은 즉시 실행될 수 있으며(예: “hey /status”), 나머지 텍스트가 모델에 보이기 전에 제거됩니다.
자세한 내용: 슬래시 명령어.

​
세션, 압축, 가지치기(무엇이 유지되는가)

메시지 간에 무엇이 유지되는지는 메커니즘에 따라 다릅니다:
  • 일반 기록은 정책에 따라 압축/가지치기되기 전까지 세션 전사본에 유지됩니다.
  • 압축은 요약을 전사본에 유지하면서 최근 메시지는 그대로 둡니다.
  • 가지치기는 실행을 위한 메모리 내 프롬프트에서 오래된 도구 결과를 제거하지만, 전사본 자체를 다시 쓰지는 않습니다.
문서: 세션, 압축, 세션 가지치기. 기본적으로 OpenClaw는 조립과 압축을 위해 내장 legacy 컨텍스트 엔진을 사용합니다. kind: "context-engine"을 제공하는 plugin을 설치하고 plugins.slots.contextEngine으로 선택하면, OpenClaw는 컨텍스트 조립, /compact, 그리고 관련 하위 에이전트 컨텍스트 수명 주기 훅을 해당 엔진에 위임합니다. ownsCompaction: false는 자동으로 legacy 엔진으로 대체되지 않습니다. 활성 엔진은 여전히 compact()를 올바르게 구현해야 합니다. 전체 플러그형 인터페이스, 수명 주기 훅, 설정은 Context Engine을 참조하세요.

​
/context가 실제로 보고하는 내용

가능한 경우 /context는 최신 실행 시 구성된 시스템 프롬프트 보고서를 우선 사용합니다:
  • System prompt (run) = 마지막 내장(도구 사용 가능) 실행에서 캡처되어 세션 저장소에 유지된 값.
  • System prompt (estimate) = 실행 보고서가 없을 때(또는 보고서를 생성하지 않는 CLI 백엔드로 실행할 때) 즉석에서 계산된 값.
어느 경우든 크기와 주요 기여 요소를 보고하지만, 전체 시스템 프롬프트나 도구 스키마를 그대로 덤프하지는 않습니다.

​
관련