연결연결OpenClaw

MCP Client

OpenClaw

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

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

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

사전 요구 사항

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

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

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

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 를 플러그인에 직접 전달합니다.

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 MCP 설정

구성 파일: ~/.openclaw/openclaw.json

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}"
      }
    }
  }
}

클라이언트 준비 상태

  • Evidence required
  • Planned
  • See /product/docs#client-capability-matrix; this matches the authoritative config installed by @xmemo/client.

출처: OpenClaw 연동