OpenClaw Hyperspell 플러그인: AI 에이전트를 위한 통합 메모리 및 컨텍스트 확장

섹션별 상세

CLI 기반의 대화형 설정 위자드를 통해 플러그인 설치와 외부 서비스 연동을 수행한다. openclaw-hyperspell setup 명령어로 API 키 설정부터 Notion, Slack 등 주요 앱의 권한 연결까지 단계별로 진행 가능하다.

bash

openclaw plugins install @hyperspell/openclaw-hyperspell
openclaw openclaw-hyperspell setup

플러그인 설치 및 대화형 설정 위자드 실행 명령어

json

{
  "plugins": {
    "entries": {
      "openclaw-hyperspell": {
        "enabled": true,
        "config": {
          "apiKey": "${HYPERSPELL_API_KEY}",
          "userId": "your-email",
          "autoContext": true,
          "syncMemories": true,
          "sources": "vault,notion,slack"
        }
      }
    }
  }
}

openclaw.json 파일의 플러그인 상세 설정 예시

로컬 마크다운 파일과 클라우드 메모리 간의 양방향 동기화 시스템을 구축한다. workspace/memory/ 폴더 내의 파일들을 감시하여 변경 사항을 Hyperspell에 반영하며, YAML 프론트매터에 고유 ID를 기록하여 데이터 중복을 방지한다.

사용자 메시지 입력 시 관련 컨텍스트를 자동으로 검색하여 주입하는 Auto-Context 메커니즘이 작동한다. AI 모델이 응답하기 전 Hyperspell 저장소에서 가장 유사한 메모리를 추출하여 프롬프트의 컨텍스트 영역에 포함시킨다.

에이전트가 자율적으로 사용할 수 있는 전용 도구인 hyperspell_search와 hyperspell_remember를 등록한다. 이를 통해 에이전트는 대화 도중 필요한 정보를 직접 검색하거나 새로운 지식을 메모리에 저장하는 능력을 갖춘다.

용어 해설

검색 증강 생성(RAG): — 외부 지식 저장소에서 관련 정보를 검색하여 LLM의 응답 생성에 활용하는 기법이다. 모델의 학습 데이터에 없는 최신 정보나 특정 도메인 지식을 보완하여 할루시네이션을 줄이는 역할을 한다.
멀티 테넌트(Multi-tenant): — 하나의 소프트웨어 인스턴스가 여러 사용자나 조직에게 서비스를 제공하는 아키텍처이다. 각 사용자의 데이터와 설정이 논리적으로 격리되어 보안과 효율성을 동시에 확보한다.
프론트매터(Frontmatter): — 마크다운 파일의 최상단에 위치하며 문서의 메타데이터를 정의하는 섹션이다. 주로 YAML 형식을 사용하며 제목, 고유 ID 등을 저장하여 프로그램이 문서를 처리하는 데 필요한 정보를 제공한다.
컨텍스트 주입(Context Injection): — AI 모델에 프롬프트를 전달하기 전, 관련 있는 외부 정보를 프롬프트 내에 삽입하는 과정이다. 이를 통해 모델은 사전에 학습되지 않은 특정 맥락을 파악하고 더 정확한 답변을 생성한다.

기술

OpenClaw
Hyperspell
Notion API
Slack API
Markdown

활용 사례

개인용 AI 비서
사내 지식 베이스 기반 챗봇
자동 회의록 정리 및 검색

언급된 리소스

API DocsHyperspell Connect