포트폴리오 스킬
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
워크플로우: 스크린샷으로 업데이트
- 사용자가 포트폴리오 스크린샷 전송 →
image도구를 사용하여 모든 포지션 추출 - 각 포지션에 대해 기존 데이터 존재 여부 확인 (
name또는name_en으로 매칭)- 기존: 새 값으로 UPDATE (current_value, unrealized_pnl, unrealized_pct, cash_dividend, total_return, total_return_pct)
- 신규: 전체 행 INSERT
- DB 업데이트 후
portfolio.py snapshot실행하여 오늘 날짜 스냅샷 기록 - 사용자에게 업데이트 내용 요약과 함께 확인 메시지 전달
워크플로우: 새 포지션 추가
python3 portfolio.py add "펀드명" "영문명" "티커" "fund" "발행기관" "은행" 위험등급 "CNY" 수량 매입NAV 현재NAV 매입금액 현재시장가 미실현손익 미실현% 배당금 총수익 총수익% [표면금리] [knockin] [autocall] [행사가] [만기일] [매입일자] "비고"
스키마 (28개 필드)
| 필드 | 타입 | 비고 |
|---|---|---|
| id | INTEGER | PK |
| name | TEXT | 종목명 (한국어) (필수) |
| name_en | TEXT | 영문명 |
| ticker | TEXT | 펀드 코드 / 티커 |
| asset_type | TEXT | fund / stock / structured_deposit / bond / etf |
| issuer | TEXT | 펀드 하우스 / 발행사 |
| bank | TEXT | 매입 채널 (필수) |
| risk_level | INTEGER | 1-5 수준 위험 척도 |
| currency | TEXT | CNY / HKD / USD |
| quantity | REAL | 주식 수 / 단위 |
| purchase_nav | REAL | 매입 기준가 (NAV) |
| current_nav | REAL | 현재 기준가 (NAV) |
| purchase_amount | REAL | 총 매입 금액 |
| current_value | REAL | 현재 시장 가치 (필수) |
| unrealized_pnl | REAL | 미실현 손익 |
| unrealized_pct | REAL | 미실현 수익률 (%) |
| cash_dividend | REAL | 수령 현금 배당금 |
| total_return | REAL | 총 수익 (손익 + 배당) |
| total_return_pct | REAL | 총 수익률 (%) |
| coupon_rate | REAL | 구조화 예금용 |
| knockin_level | REAL | 구조화 예금용 |
| autocall_level | REAL | 구조화 예금용 |
| strike_level | REAL | 구조화 예금용 |
| maturity | TEXT | 만기일 |
| purchase_date | TEXT | 매입일자 |
| notes | TEXT | 자유 텍스트 메모 |
| created_at | TEXT | 자동 생성 |
| updated_at | TEXT | 자동 갱신 |
또한 snapshots 테이블은 포트폴리오 가치의 과거 스냅샷을 추적합니다.
팁
- 업데이트 시 항상
name으로 매칭하세요. 중복 레코드를 생성하지 마십시오. snapshot명령은 자동으로snapshots테이블에 오늘 날짜를 추가합니다.- NULL 필드(ticker, purchase_*, maturity, coupon 관련 필드)는 사용자가 나중에 제공하면 업데이트할 수 있습니다.