도구 샌드박스 (Sandbox)

보안과 시스템 안정성을 위해 에이전트가 어떤 도구를 어느 범위까지 사용할 수 있는지 제어하는 기능을 제공합니다.

🛡️ 도구 접근 제어

사용자는 각 에이전트별로 도구 사용 권한을 세밀하게 설정할 수 있습니다.

1. 허용/차단 목록 (allow / deny)

agents:
  junior-dev:
    tools:
      allow: ["read_file", "grep_search"]
      deny: ["run_command", "delete_file"]

위 설정은 'junior-dev' 에이전트가 파일 읽기와 검색은 할 수 있지만, 직접적인 명령어 실행이나 파일 삭제는 할 수 없도록 제한합니다.

---

🏗️ 실행 환경 격리 (Docker)

가장 강력한 보안 방법은 에이전트의 모든 도구 실행을 Docker 컨테이너 내부로 한정하는 것입니다.

설정 활성화

openclaw configure set sandbox.enabled true
openclaw configure set sandbox.provider "docker"

작동 원리

1. 에이전트가 '파일 생성' 도구를 호출합니다.
2. OpenClaw는 호스트 PC가 아닌, 즉석에서 생성된 Docker 컨테이너 내부에서 명령을 실행합니다.
3. 결과물만 호스트의 지정된 폴더(Workspace)로 동기화됩니다.

👥 사용자 정의 프로필

사용 목적에 따라 여러 에이전트에게 서로 다른 샌드박스 등급을 부여할 수 있습니다.

• Full Access: 신뢰하는 개인 프로젝트용 에이전트.
• Strict Sandbox: 인터넷에서 받은 코드를 분석하거나 외부 툴을 실행할 때 사용하는 보안 에이전트.