메인 콘텐츠로 건너뛰기

​
에이전트 런타임 🤖

OpenClaw 는 pi-mono 에서 파생된 단일 임베디드 에이전트 런타임을 실행합니다.

​
워크스페이스 (필수)

OpenClaw 는 도구와 컨텍스트를 위한 에이전트의 유일한 작업 디렉토리로 단일 에이전트 워크스페이스 디렉토리 (agents.defaults.workspace) 를 사용합니다 (cwd). 권장 사항: openclaw setup 를 사용하여 누락된 경우 ~/.openclaw/openclaw.json 를 생성하고 워크스페이스 파일을 초기화하십시오. 전체 워크스페이스 레이아웃 + 백업 가이드: Agent workspace agents.defaults.sandbox 가 활성화된 경우, 메인 세션이 아닌 세션은 agents.defaults.sandbox.workspaceRoot 아래의 세션별 워크스페이스로 이를 재정의할 수 있습니다 (Gateway configuration 참조).

​
부트스트랩 파일 (주입됨)

agents.defaults.workspace 내부에서 OpenClaw 는 다음과 같은 사용자 편집 가능 파일을 기대합니다:
  • AGENTS.md — 운영 지침 + ‘메모리’
  • SOUL.md — 페르소나, 경계, 톤
  • TOOLS.md — 사용자가 유지 관리하는 도구 노트 (예: imsg, sag, 규칙)
  • BOOTSTRAP.md — 최초 실행 시 한 번만 수행하는 의식 (완료 후 삭제됨)
  • IDENTITY.md — 에이전트 이름/분위기/이모지
  • USER.md — 사용자 프로필 + 선호 호칭
새 세션의 첫 턴에서 OpenClaw 는 이 파일들의 내용을 에이전트 컨텍스트에 직접 주입합니다. 빈 파일은 건너뜁니다. 큰 파일은 프롬프트를 간결하게 유지하기 위해 마커와 함께 잘리고 절단됩니다 (전체 내용은 파일을 읽으십시오). 파일이 누락된 경우, OpenClaw 는 단일 ‘missing file’ 마커 라인을 주입합니다 (그리고 openclaw setup 는 안전한 기본 템플릿을 생성합니다). BOOTSTRAP.md 는 완전히 새로운 워크스페이스 (다른 부트스트랩 파일이 전혀 없음) 에서만 생성됩니다. 의식을 완료한 후 이를 삭제하면, 이후 재시작 시에는 다시 생성되지 않아야 합니다. 사전 시드된 워크스페이스를 위해 부트스트랩 파일 생성을 완전히 비활성화하려면 다음을 설정하십시오: 
{ agent: { skipBootstrap: true } }

​
내장 도구

핵심 도구 (read/exec/edit/write 및 관련 시스템 도구) 는 도구 정책에 따라 항상 사용 가능합니다. apply_patch 는 선택 사항이며 tools.exec.applyPatch 에 의해 게이팅됩니다. TOOLS.md 는 어떤 도구가 존재하는지를 제어하지 않으며, 도구를 어떻게 사용하길 원하는지에 대한 지침입니다.

​
기술

OpenClaw 는 세 위치에서 Skills 를 로드합니다 (이름 충돌 시 워크스페이스가 우선):
  • 번들 (설치와 함께 제공)
  • 관리됨/로컬: ~/.openclaw/skills
  • 워크스페이스: <workspace>/skills
Skills 는 구성/환경 변수로 게이팅될 수 있습니다 (Gateway configuration 의 skills 참조).

​
pi-mono 통합

OpenClaw 는 pi-mono 코드베이스의 일부 (모델/도구) 를 재사용하지만, 세션 관리, 디바이스 검색, 도구 와이어링은 OpenClaw 소유입니다.
  • pi-coding 에이전트 런타임은 없습니다.
  • ~/.pi/agent 또는 <workspace>/.pi 설정은 참조되지 않습니다.

​
세션

세션 트랜스크립트는 다음 위치에 JSONL 로 저장됩니다:
  • ~/.openclaw/agents/<agentId>/sessions/<SessionId>.jsonl
세션 ID 는 안정적이며 OpenClaw 가 선택합니다. 레거시 Pi/Tau 세션 폴더는 읽지 않습니다.

​
스트리밍 중 조향

큐 모드가 steer 인 경우, 인바운드 메시지는 현재 실행에 주입됩니다. 큐는 각 도구 호출 후 확인됩니다. 대기 중인 메시지가 있으면, 현재 어시스턴트 메시지의 남은 도구 호출은 건너뜁니다 (“Skipped due to queued user message.” 오류 도구 결과), 그런 다음 다음 어시스턴트 응답 전에 대기 중인 사용자 메시지가 주입됩니다. 큐 모드가 followup 또는 collect 인 경우, 인바운드 메시지는 현재 턴이 끝날 때까지 보류되며, 이후 대기 페이로드로 새로운 에이전트 턴이 시작됩니다. 모드 + 디바운스/캡 동작은 Queue 를 참조하십시오. 블록 스트리밍은 완료된 어시스턴트 블록을 완료 즉시 전송합니다. 기본값은 비활성화입니다 (agents.defaults.blockStreamingDefault: "off"). 경계는 agents.defaults.blockStreamingBreak 로 조정하십시오 (text_end vs message_end; 기본값은 text_end). 소프트 블록 청킹은 agents.defaults.blockStreamingChunk 로 제어합니다 (기본값 800–1200 자; 단락 구분을 선호하고, 다음으로 줄바꿈, 문장은 마지막). 스트리밍된 청크를 agents.defaults.blockStreamingCoalesce 로 병합하여 단일 라인 스팸을 줄이십시오 (전송 전 유휴 기반 병합). Telegram 이 아닌 채널은 블록 응답을 활성화하려면 명시적인 *.blockStreaming: true 가 필요합니다. 자세한 도구 요약은 도구 시작 시 방출됩니다 (디바운스 없음). Control UI 는 가능할 때 에이전트 이벤트를 통해 도구 출력을 스트리밍합니다. 자세한 내용: Streaming + chunking.

​
모델 참조

구성의 모델 참조 (예: agents.defaults.model 및 agents.defaults.models) 는 첫 번째 / 를 기준으로 분할하여 파싱됩니다.
  • 모델을 구성할 때는 provider/model 를 사용하십시오.
  • 모델 ID 자체에 / (OpenRouter 스타일) 가 포함된 경우, 프로바이더 접두사를 포함하십시오 (예: openrouter/moonshotai/kimi-k2).
  • 프로바이더를 생략하면, OpenClaw 는 입력을 별칭 또는 기본 프로바이더의 모델로 처리합니다 (모델 ID 에 / 가 없는 경우에만 작동).

​
구성 (최소)

최소한 다음을 설정하십시오:
  • agents.defaults.workspace
  • channels.whatsapp.allowFrom (강력히 권장)
다음: Group Chats 🦞