튜토리얼 카테고리 Skills 소개
ZH EN JA KO
🔎

Elasticsearch

검색 엔진 데이터베이스 및 스토리지

설치 명령어

npx clawhub@latest install elasticsearch

설치 안내

1
환경 확인

Node.js 22 이상과 OpenClaw가 설치되어 있는지 확인하세요. 터미널에서 openclaw --version을 실행하여 확인할 수 있습니다.

2
설치 실행

위의 설치 명령어를 터미널에서 실행하세요. ClawHub가 자동으로 Elasticsearch을(를) ~/.openclaw/skills/ 디렉토리에 다운로드하고 설치합니다.

3
설치 확인

openclaw skills list를 실행하여 설치된 스킬 목록을 확인하고, Elasticsearch이(가) 목록에 표시되는지 확인하세요.

4
매개변수 설정 (선택사항)

아래 소개의 설정 안내에 따라 ~/.config/openclaw/openclaw.json5에 스킬 설정 항목을 추가하세요.

수동 설치 방법: Skill 폴더를 ~/.openclaw/skills/ 또는 프로젝트의 skills/ 디렉토리에 복사하세요. 폴더에 SKILL.md 파일이 포함되어 있어야 합니다.
전문 검색 로그 분석 데이터 집계

상세 소개

Elasticsearch 스킬은 OpenClaw를 Elasticsearch 클러스터에 연결하여 대화 방식으로 복잡한 검색과 분석을 수행합니다.

핵심 기능

  • 전문 검색: 자연어로 검색 조건을 설명하면 자동으로 ES 쿼리 DSL로 변환
  • 로그 분석: 애플리케이션 로그를 검색하고 분석하여 문제를 빠르게 파악
  • 집계 분석: 다양한 통계 차트와 데이터 집계 보고서 생성
  • 인덱스 관리: 인덱스 목록, Mapping, 클러스터 건강 상태 확인
  • Kibana 통합: Kibana 시각화 쿼리 링크 생성

설정 방법

{
  skills: {
    elasticsearch: {
      nodes: ["http://localhost:9200"],
      auth: { username: "elastic", password: "xxx" },
      defaultIndex: "logs-*"
    }
  }
}

사용 시나리오

  • 「최근 1시간 내 error가 포함된 로그를 검색해 줘」
  • 「서비스명별로 오늘의 500 에러 수를 통계 내줘」
  • 「클러스터 건강 상태가 어때? unassigned shards가 있어?」
  • 「logs-2026.03 인덱스의 Mapping이 어떻게 되어 있어?」