본문으로 건너뛰기
Mervin Praison

OpenClaw 커스텀 스킬 제작 가이드: 주식 조회부터 송장 추출까지

OpenClaw 에이전트에 파이썬 스크립트와 Upstage API를 연동하여 주식 가격 조회 및 대량 송장 데이터 추출을 자동화하는 커스텀 스킬 구현 방법을 다룬다.

챕터별 상세

00:00

OpenClaw 스킬의 중요성과 개요

OpenClaw 에이전트의 강력함은 부여된 스킬에 의해 결정된다. 스킬이 없는 에이전트는 실행할 수 있는 작업이 없으므로 무용지물이다. 본 튜토리얼은 스킬의 파일 구조부터 실제 도구 연결, 검증 과정까지의 전체 패턴을 다룬다.
01:02

OpenClaw 설치 및 초기 설정

CLI 명령어를 통해 OpenClaw를 설치하고 기본 설정을 진행한다. OpenAI API 키를 입력하여 GPT-4 기반 모델을 연동하고 텔레그램 등 통신 채널을 구성한다. 설치 완료 후 게이트웨이를 재시작하여 모든 설정이 활성화되었음을 확인했다.
bash
curl -fsSL https://openclaw.ai/install.sh | bash

OpenClaw를 시스템에 설치하는 한 줄 명령어

02:22

커스텀 워크스페이스 설정

에이전트가 작업하는 파일과 스킬을 한곳에서 관리하기 위해 기본 워크스페이스 경로를 변경했다. `openclaw config set agents.defaults.workspace` 명령어를 사용하여 특정 폴더를 지정했다. 이를 통해 모든 스크립트와 결과물에 대한 가시성과 제어권을 확보했다.
03:28

첫 번째 스킬 제작: 주식 가격 조회

수동으로 스킬을 생성하는 기본 패턴을 학습한다. `skills` 폴더 내에 `stock-price` 디렉토리를 만들고 `SKILL.md`와 파이썬 스크립트인 `tools.py`를 작성했다. `SKILL.md`에는 에이전트가 이 도구를 언제 사용해야 하는지에 대한 지침을 포함했다.
python
import json, sys, yfinance as yf

def get_stock_price(symbol: str) -> dict:
    last = yf.Ticker(symbol).fast_info.last_price
    return {"price": round(last, 2), "currency": "USD"}

if __name__ == "__main__":
    sym = sys.argv[1].upper()
    print(json.dumps({"symbol": sym, **get_stock_price(sym)}))

yfinance 라이브러리를 사용하여 실시간 주식 가격을 가져오는 파이썬 스크립트

05:27

스킬 검증 및 실시간 테스트

`openclaw skills list` 명령어를 실행하여 새로 추가한 `stock-price` 스킬이 'ready' 상태인지 확인했다. 웹 UI 채팅창에서 구글 주가를 묻는 질의를 던졌을 때 에이전트가 해당 스킬을 호출하여 정확한 수치를 반환했다. 이는 에이전트가 자연어 의도를 파악해 적절한 파이썬 코드를 실행했음을 의미한다.
06:12

실전 활용: Upstage Studio 연동

비정형 PDF 송장에서 데이터를 추출하기 위해 Upstage Studio를 활용했다. Upstage Studio에서 파싱 및 추출 워크플로를 구성하고 API 엔드포인트를 생성했다. 이 서비스는 PDF 내의 송장 번호, 날짜, 금액 등을 정확하게 식별하여 구조화된 JSON 데이터를 반환한다.
08:16

에이전트를 통한 스킬 자동 생성

개발자가 직접 코드를 짜는 대신 에이전트에게 API 문서를 주고 스킬을 만들라고 지시했다. 에이전트는 제공된 정보를 바탕으로 워크스페이스 내에 필요한 폴더와 파일을 자동으로 생성했다. 이는 복잡한 API 연동 작업을 에이전트가 스스로 수행할 수 있음을 보여준다.
09:06

대량 송장 자동 처리 데모

특정 폴더에 있는 모든 송장 파일을 처리하라는 단일 명령을 수행했다. 에이전트는 자동으로 셸 스크립트를 생성하여 폴더 내 10개의 PDF를 순차적으로 Upstage API에 전송했다. 최종적으로 모든 송장 정보를 취합하여 채팅창에 깔끔한 테이블 형태로 요약 보고했다.

용어 해설

오픈클로(OpenClaw)
— 사용자의 이메일 관리, 일정 예약 등을 수행하는 오픈소스 AI 에이전트 프레임워크이다. 파이썬 스크립트나 API를 '스킬' 형태로 추가하여 에이전트의 기능을 무한히 확장할 수 있는 구조를 가진다.
에이전트 스킬(Agent Skill)
— AI 에이전트가 특정 도구나 API를 사용하여 외부 작업을 수행할 수 있도록 정의된 기능 단위이다. 실행 가능한 코드와 에이전트가 이를 언제 어떻게 사용할지 정의한 지침 파일로 구성된다.
문서 지능(Document Intelligence)
— PDF나 이미지 같은 비정형 문서에서 텍스트, 표, 구조적 정보를 추출하여 기계가 읽을 수 있는 데이터로 변환하는 AI 기술이다. 송장 처리나 계약서 분석 자동화의 핵심 기술이다.

언급된 리소스

AI 분석 전체 내용 보기

AI 요약 · 북마크 · 개인 피드 설정 — 무료

출처 · 인용 안내

원문 발행 2026. 04. 03.수집 2026. 04. 03.출처 타입 YOUTUBE

인용 시 "요약 출처: AI Trends (aitrends.kr)"를 표기하고, 사실 확인은 원문 보기 기준으로 진행해 주세요. 자세한 기준은 운영 정책을 참고해 주세요.