> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenClaw 세션 캡처

> 팀의 로컬 OpenClaw 세션을 AgentEye로 가져와 일반 세션 및 이벤트로 활용하세요 — OpenClaw 실행 방식은 그대로 유지됩니다.

팀이 [OpenClaw](https://docs.openclaw.ai)를 사용하고 있다면, OpenClaw 세션 캡처를 통해 해당 세션을 AgentEye의 일반 세션 및 이벤트로 가져올 수 있습니다. 이를 통해 다른 모든 관측 데이터와 함께 검색, 재생, 평가가 가능합니다. 이 기능은 [Python SDK](/ko/agenteye/python-sdk)를 보완합니다. SDK는 직접 작성한 에이전트를 계측하는 반면, 이 기능은 팀이 이미 사용 중인 OpenClaw 작업을 캡처합니다 — 실행 방식을 변경할 필요가 없습니다.

소형 백그라운드 수집기가 OpenClaw의 로컬 세션 트랜스크립트를 작성되는 즉시 읽어 AgentEye로 전송합니다. [Codex 캡처](/ko/agenteye/codex-capture)와 동일한 방식으로 동작하며, 하나의 수집기로 두 가지를 동시에 캡처할 수 있습니다.

***

## 캡처 대상

머신의 OpenClaw 설정에 구성된 모든 에이전트는 해당 머신의 수집기에 의해 캡처됩니다 — 에이전트별 별도 설정은 필요하지 않습니다.

각 OpenClaw 세션은 AgentEye [세션](/ko/agenteye/sessions)으로 변환되며, 사용자 및 어시스턴트 메시지, 도구 호출, 도구 결과는 해당하는 [이벤트](/ko/agenteye/event-stream)로 변환됩니다.

***

## 활성화 방법

캡처는 기본적으로 비활성화되어 있습니다. `events:add` 권한이 있는 API 키([API 키](/ko/agenteye/api-keys) 참조)로 수집기를 설치하고 OpenClaw 캡처를 활성화하세요:

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \
  | sh -s -- --key <YOUR_API_KEY> --openclaw-enabled
```

이 명령은 수집기를 설치하고, 백그라운드 서비스로 등록한 뒤 캡처를 시작합니다. 정상 실행 여부를 확인하려면:

```bash theme={null}
agenteye-collector health
```

동일한 머신에서 여러 에이전트를 캡처하려면? 각 에이전트의 플래그를 같은 명령에 추가하면 됩니다 — 예: `--openclaw-enabled --codex-enabled`.

최초 실행 시 기존 OpenClaw 세션이 한 번 백필되고, 이후 새로운 활동은 몇 초 내에 스트리밍됩니다. OpenClaw의 파일은 읽기 전용으로만 접근되며 — 수정, 이동, 삭제는 절대 발생하지 않습니다 — 각 세션은 재시작이 발생해도 정확히 한 번만 전송됩니다.

***

## 표시 위치

캡처된 세션은 **Sessions**에, 해당 이벤트는 **Events** 스트림에 표시됩니다. 다른 에이전트와 동일하게 관측되므로 [세션 재생](/ko/agenteye/sessions), [검색](/ko/agenteye/queries), [평가](/ko/agenteye/evaluations), [알림](/ko/agenteye/alerts) 모두 적용됩니다. OpenClaw 에이전트를 필터링하면 해당 세션만 별도로 볼 수 있습니다.

***

## 개인정보 보호

OpenClaw 트랜스크립트에는 명령 출력, 파일 내용, 에이전트가 읽거나 쓴 모든 내용 등 전체 세션 데이터가 포함되며 시크릿이 담길 수 있습니다. 캡처된 세션은 있는 그대로 전송되므로, 해당 콘텐츠를 AgentEye에 중앙 집중화하는 것이 적절한 머신과 팀에 한해서만 캡처를 활성화하고, 수집기 키는 `events:add` 권한으로만 범위를 제한하세요. 데이터 격리 방식에 대한 자세한 내용은 [보안](/ko/agenteye/security)을 참조하세요.