Communitygithub.com

OpenKrab/ClawGold

AI 기반 XAUUSD 트레이딩 시스템 - LiteLLM, APScheduler 및 고급 전략을 활용한 자동 거래

ClawGold란 무엇인가요?

ClawGold v2.0은 XAUUSD(금/미국 달러)를 대상으로 하는 완전 자동화된 AI 트레이딩 시스템입니다. 이 시스템은 LiteLLM을 통해 여러 AI 제공업체(OpenCode, KiloCode, Gemini, Codex)를 통합하여 시장 분석 신호를 생성하고, APScheduler로 지속적인 작업 스케줄링을 지원하며, 고급 기술적 분석과 실시간 감정 분석을 바탕으로 자동 매매를 실행합니다. v2.0.0 Phase 1에서는 서브초 단위 LLM 호출과 자동 폴백 메커니즘, 비용 추적, SQLite 기반 작업 지속성, 향상된 Rich 로깅을 도입하여 안정성을 10-15% 개선했습니다. 보안 면에서 로컬 우선 아키텍처를 채택하여 모든 데이터를 자체 호스팅 SQLite 데이터베이스에 저장하며, 트레이딩 신호는 AI 보조 추천 사항으로만 제공됩니다. 사용자는 간단한 API를 통해 가격 조회, 이동평균 계산, 트레이딩 신호 생성, 포트폴리오 시뮬레이션, AI 기반 시장 조사 등을 수행할 수 있으며, ClawFlow를 통해 손쉽게 설치 및 설정할 수 있습니다.

지원 대상~Claude Code✓Codex CLI~Cursor✓Gemini CLI✓OpenCode
npx skills add OpenKrab/ClawGold

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

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

문서

ClawGold v2.0

설명: ClawGold는 AI 에이전트가 구동하는 자율적인 XAUUSD(금 대 미국 달러) 트레이딩 시스템입니다. LiteLLM을 통한 다중 제공업체 LLM 통합, 강력한 APScheduler 백엔드, 고급 기술적 분석, 실시간 감정 분석, 자동화된 거래 실행을 제공합니다.

최신 업데이트: Phase 1 (v2.0.0) — LiteLLM 통합, APScheduler 마이그레이션, Rich 로깅 개선.

성능: 서브초 LLM 호출 및 자동 폴백; 지속적인 작업 복구; 신뢰성 약 10-15% 향상.

보안: 로컬 우선 아키텍처, 자체 호스팅 SQLite 데이터베이스, 데이터 공유 없음. 모든 트레이딩 신호는 AI 보조 추천 사항입니다.

Phase 1: 새로운 기능

🚀 LiteLLM 통합

  • 통합 AI 인터페이스: 단일 LiteLLM API를 통한 OpenCode, KiloCode, Gemini, Codex 지원
  • 자동 폴백: 제공업체 체인 구성; 실패 시 지수 백오프 재시도
  • 비용 추적: SQLite(data/llm_costs.db)에 실시간 LLM 비용 로깅
  • 향상된 안정성: API 오류 10-15% 감소

📅 APScheduler 마이그레이션

  • 작업 지속성: 예약된 작업이 재시작 후에도 유지됨 (data/scheduler.db에 저장)
  • 세 가지 스케줄링 모드: 일일(시간 기반), 간격(초 단위), 크론(고급 패턴)
  • 스레드 풀: 최대 4개의 동시 작업으로 효율적인 리소스 사용
  • 정상 복구: 지연된 작업에 대해 30초 유예 기간

🎨 Rich 로깅

  • 개선된 콘솔 출력: 컬러 로그, 패널, 테이블, 진행률 표시줄
  • 더 나은 사용자 경험: 시각적 계층 구조를 통한 빠른 디버깅
  • 파일 로깅: 모든 로그가 타임스탬프와 함께 logs/clawgold.log에 저장됨

기능

핵심 트레이딩 엔진

  • 가격 모니터링: Yahoo Finance를 통한 실시간 XAUUSD 가격 조회
  • 기술적 분석: 이동평균 계산, EMA 교차, 다중 시간대 분석 (M15, H1, H4, D1)
  • 신호 생성: MA 교차 및 AI 합의 기반 자동 매수/매도/홀드 신호
  • 거래 시뮬레이션: 포트폴리오 추적을 포함한 현실적인 거래 실행
  • 포트폴리오 관리: 잔액 모니터링, 포지션 추적, 손익 계산

Phase 1 개선사항

  • LiteLLM 통합: 통합된 다중 제공업체 AI 인터페이스 (OpenCode, KiloCode, Gemini, Codex)
  • 자동 폴백: 여러 제공업체 연결; 지수 백오프를 통한 자동 재시도
  • APScheduler 백엔드: 충돌 복구 기능을 갖춘 지속적인 백그라운드 작업 스케줄링
  • Rich 콘솔 출력: 아름다운 컬러 로그, 패널, 테이블, 진행률 표시줄
  • 비용 추적: 제공업체별 실시간 LLM 비용 분석 (SQLite 저장)

AI 기반 분석

  • 멀티 AI 리서치: 시장 분석을 위해 여러 AI 제공업체에 병렬 쿼리
  • 감정 분석: 여러 출처의 실시간 감정 점수
  • 시장 조사: AI 생성 시장 전망 및 추세 예측
  • 위험 평가: AI 기반 포지션 크기 조정 및 위험 관리 권장사항
  • 뉴스 수집: 감정 분석을 포함한 자동 뉴스 수집

고급 트레이딩 전략

  • 트레일링 스탑: 가격 움직임에 따른 자동 손절가 조정
  • 그리드 트레이딩: 변동성 포착을 위한 다중 레벨 매수/매도 주문
  • 돌파 감지: 자동화된 돌파 진입 신호
  • 스캘핑 모드: 마이크로 트렌드 기반 고빈도 거래
  • 위험 관리: 일일 손실 한도, 증거금 모니터링, 포지션 크기 조정

활용 사례

  • 자율 트레이딩: 수동 개입 없이 24/7 거래
  • AI 지원 의사결정: 거래 전 AI 합의로 시장 방향 확인
  • 전략 테스트: 현실적인 조건에서 트레이딩 아이디어 백테스트 및 시뮬레이션
  • 교육: AI 안내를 통한 고급 트레이딩 개념 학습
  • 리서치: 단일 대시보드에서 시장 뉴스 및 감정 통합

도구

get_xauusd_price

  • 설명: Yahoo Finance에서 현재 XAUUSD 가격을 조회합니다.
  • 매개변수: 없음
  • 반환값: 온스당 현재 가격(USD) 문자열
  • 예시: "Current XAUUSD price: 5146.9 USD per ounce"

calculate_moving_average

  • 설명: 지정된 기간 동안 XAUUSD의 단순 이동평균을 계산합니다.
  • 매개변수:
    • period (정수, 기본값 20): 이동평균 계산 기간(일)
  • 반환값: SMA 값 문자열
  • 예시: "SMA(20): 5123.45"

generate_trading_signal

  • 설명: 이동평균 교차 전략에 따라 트레이딩 신호를 생성합니다.
  • 매개변수:
    • short_period (정수, 기본값 10): 단기 MA 기간
    • long_period (정수, 기본값 20): 장기 MA 기간
  • 반환값: BUY, SELL 또는 HOLD를 나타내는 문자열
  • 예시: "BUY signal"

simulate_trade

  • 설명: 지정된 수량으로 XAUUSD 매수 또는 매도를 시뮬레이션합니다.
  • 매개변수:
    • action (문자열): "BUY" 또는 "SELL"
    • amount (실수): 금의 온스 수량
  • 반환값: 거래 결과 문자열
  • 예시: "Simulated BUY: 0.1 oz at 5146.90 USD"

get_portfolio_status

  • 설명: 현재 시뮬레이션된 포트폴리오 상태를 조회합니다.
  • 매개변수: 없음
  • 반환값: 잔액과 포지션 문자열
  • 예시: "Balance: 9742.60 USD\nPositions:\n BUY 0.05 oz at 5148.00 USD\nTotal trades: 2"

ai_research

  • 설명: 여러 CLI 도구(OpenCode, KiloCode, Gemini)를 사용하여 AI 기반 시장 조사를 수행합니다.
  • 매개변수:
    • query (문자열): 시장 상황에 대한 연구 질문
    • tools (리스트, 선택사항): 사용할 AI 도구 목록. 기본값: ['opencode', 'kilocode', 'gemini']
  • 반환값: 감정 분석이 포함된 통합 연구 결과
  • 예시: "AI Research Summary: BULLISH consensus from 3 tools"

AI CLI 도구

다음 AI CLI 도구가 시장 조사에 지원됩니다:

도구설치사용법
OpenCodenpm install -g opencodeopencode run "<프롬프트>"
KiloCodehttps://kilo.aikilo run "<프롬프트>"
Gemininpm install -g @google/gemini-cligemini "<프롬프트>"

사용법

  • ClawFlow 설치: clawflow install claw-gold
  • 설정: config.yaml 파일을 편집하여 설정을 사용자 정의합니다.
  • 통합: OpenClaw 에이전트와 함께 사용하여 거래 지원을 받습니다.

지원 및 커뮤니티

문서

커뮤니티 지원

  • GitHub 이슈: 버그 신고 및 기능 요청

버전: 2.0.0 상태: 프로덕션 준비 완료 (Phase 1 완료) 라이선스: MIT 관리자: JonusNattapong 마지막 업데이트: 2026년 3월 4일

Phase 1 릴리스 노트

  • ✅ LiteLLM 통합 AI 제공업체 인터페이스
  • ✅ APScheduler 지속적인 작업 스케줄링
  • ✅ Rich 개선 콘솔 로깅
  • ✅ 자동 비용 추적 및 분석
  • ✅ 100% 하위 호환성

다음: Phase 2 (PydanticAI + Langfuse SDK) 출시 예정

기능

  • 가격 모니터링: 실시간 XAUUSD 가격 조회
  • 기술적 분석: 이동평균 계산
  • 신호 생성: MA 교차 기반 자동 매수/매도 신호
  • 거래 시뮬레이션: 포트폴리오 추적을 포함한 현실적인 거래 실행
  • 포트폴리오 관리: 잔액 및 포지션 모니터링

활용 사례

  • 트레이딩 교육: 실제 자금 없이 트레이딩 전략 학습
  • 전략 테스트: 트레이딩 아이디어 백테스트 및 시뮬레이션
  • 자동화: OpenClaw와 통합하여 자동 거래 알림

도구

get_xauusd_price

  • 설명: Yahoo Finance에서 현재 XAUUSD 가격을 조회합니다.
  • 매개변수: 없음
  • 반환값: 온스당 현재 가격(USD) 문자열
  • 예시: "Current XAUUSD price: 5146.9 USD per ounce"

calculate_moving_average

  • 설명: 지정된 기간 동안 XAUUSD의 단순 이동평균을 계산합니다.
  • 매개변수:
    • period (정수, 기본값 20): 이동평균 계산 기간(일)
  • 반환값: SMA 값 문자열
  • 예시: "SMA(20): 5123.45"

generate_trading_signal

  • 설명: 이동평균 교차 전략에 따라 트레이딩 신호를 생성합니다.
  • 매개변수:
    • short_period (정수, 기본값 10): 단기 MA 기간
    • long_period (정수, 기본값 20): 장기 MA 기간
  • 반환값: BUY, SELL 또는 HOLD를 나타내는 문자열
  • 예시: "BUY signal"

simulate_trade

  • 설명: 지정된 수량으로 XAUUSD 매수 또는 매도를 시뮬레이션합니다.
  • 매개변수:
    • action (문자열): "BUY" 또는 "SELL"
    • amount (실수): 금의 온스 수량
  • 반환값: 거래 결과 문자열
  • 예시: "Simulated BUY: 0.1 oz at 5146.90 USD"

get_portfolio_status

  • 설명: 현재 시뮬레이션된 포트폴리오 상태를 조회합니다.
  • 매개변수: 없음
  • 반환값: 잔액과 포지션 문자열
  • 예시: "Balance: 9742.60 USD\nPositions:\n BUY 0.05 oz at 5148.00 USD\nTotal trades: 2"

ai_research

  • 설명: 여러 CLI 도구(OpenCode, KiloCode, Gemini)를 사용하여 AI 기반 시장 조사를 수행합니다.
  • 매개변수:
    • query (문자열): 시장 상황에 대한 연구 질문
    • tools (리스트, 선택사항): 사용할 AI 도구 목록. 기본값: ['opencode', 'kilocode', 'gemini']
  • 반환값: 감정 분석이 포함된 통합 연구 결과
  • 예시: "AI Research Summary: BULLISH consensus from 3 tools"

AI CLI 도구

다음 AI CLI 도구가 시장 조사에 지원됩니다:

도구설치사용법
OpenCodenpm install -g opencodeopencode run "<프롬프트>"
KiloCodehttps://kilo.aikilo run "<프롬프트>"
Gemininpm install -g @google/gemini-cligemini "<프롬프트>"

사용법

  • ClawFlow 설치: clawflow install claw-gold
  • 설정: config.yaml 파일을 편집하여 설정을 사용자 정의합니다.
  • 통합: OpenClaw 에이전트와 함께 사용하여 거래 지원을 받습니다.

지원 및 커뮤니티

문서

커뮤니티 지원

  • GitHub 이슈: 버그 신고 및 기능 요청

버전: 1.0.0 상태: MVP 준비 완료 라이선스: MIT 관리자: JonusNattapong

관련 스킬