Communitygithub.com

deltamaster/hansen-openclaw-config

로컬 SQLite 데이터베이스에 저장된 Hansen의 투자 포트폴리오를 관리합니다.

hansen-openclaw-config란 무엇인가요?

이 스킬은 SQLite 데이터베이스(`~/.openclaw/workspace/data/portfolio.db`)를 기반으로 Hansen의 개인 투자 포트폴리오를 관리하는 AI 에이전트 도구입니다. 사용자가 포트폴리오 스크린샷을 공유하면 AI가 이미지 인식 도구를 사용하여 보유 종목을 추출하고 데이터베이스를 업데이트합니다. 현재 포지션 조회, 히스토리 스냅샷 확인, 수익률 분석, 신규 포지션 추가 등 다양한 작업을 명령어 기반으로 수행할 수 있습니다. Python 스크립트(`portfolio.py`)를 통해 요약 보기, 스냅샷 생성, 전체 테이블 조회 등의 기능을 제공하며, 최대 28개 필드로 구성된 상세한 스키마를 지원합니다. 이 도구는 Claude Code, Cursor, Codex 등 터미널 기반 AI 에이전트와 호환되며, 사용자가 포트폴리오 관련 질문을 하거나 스크린샷을 제공할 때 자동으로 작업을 수행합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/deltamaster/hansen-openclaw-config/tree/HEAD/skills/portfolio

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

포트폴리오 스킬

Hansen은 ~/.openclaw/workspace/data/portfolio.db(SQLite)에 투자 포트폴리오를 저장합니다.

빠른 명령어

# 요약 보기
python3 ~/.openclaw/workspace/skills/portfolio/scripts/portfolio.py summary

# 스냅샷 생성 (오늘 날짜 기준 기록)
python3 ~/.openclaw/workspace/skills/portfolio/scripts/portfolio.py snapshot

# 과거 스냅샷 조회
python3 ~/.openclaw/workspace/skills/portfolio/scripts/portfolio.py history

# 전체 테이블 보기 (28개 필드 전체)
python3 ~/.openclaw/workspace/skills/portfolio/scripts/portfolio.py full

# 모든 스냅샷 보기
python3 ~/.openclaw/workspace/skills/portfolio/scripts/portfolio.py history

워크플로우: 스크린샷으로 업데이트

  1. 사용자가 포트폴리오 스크린샷 전송 → image 도구를 사용하여 모든 포지션 추출
  2. 각 포지션에 대해 기존 데이터 존재 여부 확인 (name 또는 name_en으로 매칭)
    • 기존: 새 값으로 UPDATE (current_value, unrealized_pnl, unrealized_pct, cash_dividend, total_return, total_return_pct)
    • 신규: 전체 행 INSERT
  3. DB 업데이트 후 portfolio.py snapshot 실행하여 오늘 날짜 스냅샷 기록
  4. 사용자에게 업데이트 내용 요약과 함께 확인 메시지 전달

워크플로우: 새 포지션 추가

python3 portfolio.py add "펀드명" "영문명" "티커" "fund" "발행기관" "은행" 위험등급 "CNY" 수량 매입NAV 현재NAV 매입금액 현재시장가 미실현손익 미실현% 배당금 총수익 총수익% [표면금리] [knockin] [autocall] [행사가] [만기일] [매입일자] "비고"

스키마 (28개 필드)

필드타입비고
idINTEGERPK
nameTEXT종목명 (한국어) (필수)
name_enTEXT영문명
tickerTEXT펀드 코드 / 티커
asset_typeTEXTfund / stock / structured_deposit / bond / etf
issuerTEXT펀드 하우스 / 발행사
bankTEXT매입 채널 (필수)
risk_levelINTEGER1-5 수준 위험 척도
currencyTEXTCNY / HKD / USD
quantityREAL주식 수 / 단위
purchase_navREAL매입 기준가 (NAV)
current_navREAL현재 기준가 (NAV)
purchase_amountREAL총 매입 금액
current_valueREAL현재 시장 가치 (필수)
unrealized_pnlREAL미실현 손익
unrealized_pctREAL미실현 수익률 (%)
cash_dividendREAL수령 현금 배당금
total_returnREAL총 수익 (손익 + 배당)
total_return_pctREAL총 수익률 (%)
coupon_rateREAL구조화 예금용
knockin_levelREAL구조화 예금용
autocall_levelREAL구조화 예금용
strike_levelREAL구조화 예금용
maturityTEXT만기일
purchase_dateTEXT매입일자
notesTEXT자유 텍스트 메모
created_atTEXT자동 생성
updated_atTEXT자동 갱신

또한 snapshots 테이블은 포트폴리오 가치의 과거 스냅샷을 추적합니다.

팁

  • 업데이트 시 항상 name으로 매칭하세요. 중복 레코드를 생성하지 마십시오.
  • snapshot 명령은 자동으로 snapshots 테이블에 오늘 날짜를 추가합니다.
  • NULL 필드(ticker, purchase_*, maturity, coupon 관련 필드)는 사용자가 나중에 제공하면 업데이트할 수 있습니다.

관련 스킬