Agent Workspace 개요

기준일: 2026-07-13 난이도: 초급 공식 기준: Agent workspace, Agent runtime

Agent workspace는 OpenClaw agent의 기본 working directory입니다. 지침, identity, memory와 workspace-local Skills를 담으며, 일반적인 공유 파일 저장소처럼 취급해서는 안 됩니다.

핵심 개념

• Workspace path는 agent 설정의 agents.defaults.workspace 또는 agent별 설정으로 결정됩니다.
• workspace 안의 bootstrap·identity·memory 파일은 agent behavior와 context에 영향을 줄 수 있습니다.
• <workspace>/skills는 해당 workspace agent에 가장 높은 precedence로 로드됩니다.
• workspace가 container sandbox 자체를 뜻하지는 않습니다. filesystem boundary는 sandbox 설정에서 별도로 정합니다.

선택 기준

• 개인 agent의 memory와 identity는 private workspace에 둡니다.
• 여러 agent가 필요하면 각 agent에 별도 workspace를 사용합니다.
• 동기화·공유 전에 secret, transcript, 개인 memory가 포함되는지 검토합니다.
• workspace path 변경은 config schema와 backup 범위를 함께 확인합니다.

실습

현재 설정과 schema를 확인합니다.

openclaw config get agents.defaults.workspace
openclaw config schema
openclaw backup create --dry-run --json

backup dry-run 결과에서 어떤 workspace가 포함되는지 확인한 뒤 실제 backup을 결정합니다.

도구에 입력할 프롬프트

현재 OpenClaw workspace를 읽기 전용으로 점검해줘.
agent별 workspace path, identity·memory·Skills 파일,
backup 포함 범위, 공유하면 안 되는 민감 항목을 구분해줘.
workspace와 sandbox를 같은 개념으로 설명하지 마.

체크리스트

• 실제 workspace path를 config에서 확인했다.
• agent별 workspace를 분리했다.
• workspace와 sandbox 경계를 구분했다.
• 공유·동기화 전에 private memory와 secret을 검토했다.
• backup dry-run으로 포함 범위를 확인했다.

다음 단계

• Workspace 설정에서 주요 파일의 역할을 확인합니다.
• 메모리 시스템에서 장기 memory를 다룹니다.
• 보안에서 filesystem과 secret 경계를 점검합니다.