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 도구가 시장 조사에 지원됩니다:
| 도구 | 설치 | 사용법 |
|---|---|---|
| OpenCode | npm install -g opencode | opencode run "<프롬프트>" |
| KiloCode | https://kilo.ai | kilo run "<프롬프트>" |
| Gemini | npm install -g @google/gemini-cli | gemini "<프롬프트>" |
사용법
- 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 도구가 시장 조사에 지원됩니다:
| 도구 | 설치 | 사용법 |
|---|---|---|
| OpenCode | npm install -g opencode | opencode run "<프롬프트>" |
| KiloCode | https://kilo.ai | kilo run "<프롬프트>" |
| Gemini | npm install -g @google/gemini-cli | gemini "<프롬프트>" |
사용법
- ClawFlow 설치:
clawflow install claw-gold - 설정:
config.yaml파일을 편집하여 설정을 사용자 정의합니다. - 통합: OpenClaw 에이전트와 함께 사용하여 거래 지원을 받습니다.
지원 및 커뮤니티
문서
커뮤니티 지원
- GitHub 이슈: 버그 신고 및 기능 요청
버전: 1.0.0 상태: MVP 준비 완료 라이선스: MIT 관리자: JonusNattapong