# OpenClaw

사전 예방적 리콜을 위한 선택적 컴패니언 Skill 안내와 함께 ClawHub의 네이티브 메모리 플러그인을 통해 OpenClaw를 연결합니다.

- Canonical: https://docs.xmemo.dev/ko/docs/connect/openclaw
- Locale: ko-KR
- Content-Locale: ko-KR
- Canonical-Content-Digest: c1ce97e0231b187bac1701fceb894f880bb49f8d6d6dc391398e5decdaf4ff3f
- Edition-Digest: e7edc69ab774ba122e0f7a03477ba1b4ccd00e7736a52761d5e3bc7dbd30b48f
- Source-Revision: sha256:8f465eb1d6ca0b120934289273aff9d3c032c43de12f628d3bf82b19ef4657b5

## 대상 및 구체적인 인터페이스

이 가이드는 OpenClaw 에이전트를 XMemo 영구 메모리에 연결합니다. OpenClaw는 2계층 아키텍처를 통해 작동합니다. ClawHub의 네이티브 OpenClaw 메모리 플러그인은 런타임 도구 바인딩을 제공하고, 컴패니언 Skill은 사전 예방적 리콜 안내 및 세션 체크포인트를 제공합니다.

## 사전 요구 사항

연결하기 전에 다음 런타임 종속 항목 및 도구가 있는지 확인하세요:

- OpenClaw 에이전트 런타임이 설치되어 작동 가능한 상태여야 합니다.
- ClawHub 패키지 접근이 활성화되어 있어야 합니다.
- https://xmemo.dev 의 유효한 XMemo 계정.
- 컴패니언 Skill 설치 시 Node.js 런타임 버전 22.22.0 이상이어야 합니다.

## 권장 경로: 네이티브 플러그인과 컴패니언 Skill

권장 경로는 ClawHub에서 네이티브 OpenClaw 메모리 플러그인을 설치하고 OpenClaw 패키지 관리를 통해 컴패니언 Skill을 직접 설치하는 것입니다:

```bash
openclaw plugins install clawhub:@xmemo/openclaw-memory
openclaw skills install @xmemo/xmemo
```

## 인증 및 자격 증명 옵션

환경 변수 또는 대화형 기기 로그인을 통해 자격 증명을 구성합니다. 자격 증명 저장 경로를 먼저 선택하지 않고 bare login 을 사용하지 마세요:

- 환경 자격 증명(권장): OpenClaw를 실행하는 셸 또는 서비스 환경에서 XMEMO_KEY 를 설정합니다.
- 대화형 로그인: 컴패니언 Skill을 사용하는 경우 secret-store XMEMO_KEY 를 사용할 수 없을 때만 --allow-plaintext 옵션으로 login 을 실행합니다(--allow-plaintext 는 이 컴퓨터에 암호화되지 않은 자격 증명을 저장함에 유의하세요).
- 자격 증명 확인: openclaw plugins list 를 실행하여 플러그인 활성화를 확인하고 컴패니언 Skill로 인증 상태를 확인합니다.

## 대체 경로: 헤드리스 서비스 러너

헤드리스 OpenClaw 러너 또는 자동화된 CI 파이프라인의 경우 대화형 프롬프트 없이 환경 변수를 통해 XMEMO_KEY 를 플러그인에 직접 전달합니다.

```bash
export XMEMO_KEY='<your-xmemo-token>'
openclaw run --plugin @xmemo/openclaw-memory
```

## 연결 확인(읽기 전용)

데이터를 쓰기 전에 항상 읽기 전용 요청으로 연결을 확인하세요. 이 검사는 메모리 상태를 수정하지 않습니다.

- 확인: 테스트 OpenClaw 세션을 시작하고 기존 프로젝트 컨텍스트에 대한 활성 리콜 쿼리를 실행합니다.
- 성공 신호: OpenClaw가 승인된 작업 공간의 유효한 Reference 및 Location 필드가 포함된 구조화된 메모리 결과를 반환합니다.

## 첫 번째 유용한 작업: 합성 메모리 수명 주기

메모리 지속성, 상태 비저장 세션 전환, 출처 기반 리콜 및 수정을 확인합니다:

- 1. 합성 사실 저장: 프로젝트 규칙("Demo project timestamps use UTC.")을 "projects/demo-onboarding/conventions" 에 저장합니다.
- 2. 상태 비저장 전환: 현재 OpenClaw 대화를 종료하고 새 세션을 시작합니다.
- 3. 출처 귀속 리콜: "demo project timestamp format" 을 쿼리합니다. 반환된 Reference 및 Location 을 확인합니다.
- 4. 메모리 수정: ISO 8601 서식을 적용하여 기억된 규칙을 업데이트합니다.
- 5. 선택적 정리: 온보딩 확인이 완료되면 데모 규칙을 논리적으로 삭제합니다.

## 기능 및 메모리 워크플로

OpenClaw 워크플로는 에이전트 세션 전반에서 결과별로 작업을 그룹화합니다:

- 사전 예방적 활성 리콜: 계획을 세우기 전에 관련 지속성 메모리를 활성 컨텍스트에 자동으로 주입합니다.
- 세션 연속성: 다시 시작 스냅샷을 저장 및 복원하고, 결정을 추적하며, 핸드오프 전반에서 TODO를 유지 관리합니다.
- 복원력 계층: 수명이 짧은 리콜 캐시 및 일시적인 쓰기 보낼 편지함이 짧은 네트워크 중단을 처리합니다.

## 제한 사항 및 경계

OpenClaw 연동에 대한 운영상의 제약 조건:

- 작업 공간 격리: 모든 작업은 인증된 사용자의 작업 공간으로 엄격히 제한됩니다.
- ClawHub 가용성: 테스트되지 않은 서드파티 레지스트리 또는 플러그인의 비공식 포크는 테스트되지 않음으로 표시됩니다.
- 원장 범위: 원장 월간 요약 및 재무 감사 도구에는 전용 상용 범위가 필요합니다.

## 복구, 업데이트 및 제거

OpenClaw 문제 해결 및 유지 관리 절차:

- 복구(플러그인이 로드되지 않음): openclaw plugins list 를 실행하고 OpenClaw 로그에서 초기화 오류를 확인합니다.
- 복구(인증 만료): 유효한 XMEMO_KEY 를 다시 내보내거나 컴패니언 Skill을 통해 다시 인증합니다.
- 업데이트: 설치된 플러그인 및 스킬을 업데이트하려면 OpenClaw의 플러그인 관리 설명서를 참조하세요.
- 제거: 설치된 플러그인 및 스킬을 제거하거나 비활성화하려면 OpenClaw의 플러그인 관리 설명서를 참조하세요.

## OpenClaw

Direct client: configure in ~/.openclaw/openclaw.json with XMEMO_KEY in the environment. Run npx @xmemo/client mcp add openclaw to install automatically.

```
{
  "mcpServers": {
    "XMemo": {
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:XMEMO_KEY}",
        "X-Memory-OS-Agent-ID": "openclaw",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}
```