Communitygithub.com

OpenKrab/ClawGold

Sistema de trading autónomo de XAUUSD impulsado por IA con integración LiteLLM, APScheduler y estrategias avanzadas.

¿Qué es ClawGold?

ClawGold es un sistema de trading autónomo para XAUUSD (Oro vs Dólar estadounidense) que aprovecha agentes de IA para realizar análisis de mercado en tiempo real, generación de señales y ejecución automatizada de operaciones. Soporta múltiples proveedores de LLM a través de LiteLLM, proporcionando respaldo automático y seguimiento de costos. El sistema incluye un motor de análisis técnico con medias móviles y cruces de EMA en múltiples marcos temporales, análisis de sentimiento, y estrategias avanzadas como trailing stops, grid trading y detección de rupturas. Diseñado para ser local y seguro, utiliza bases de datos SQLite auto-alojadas y no comparte datos con terceros. Se integra perfectamente con el agente OpenClaw y es ideal tanto para traders autónomos como para fines educativos y de backtesting.

Compatible con~Claude Code✓Codex CLI~Cursor✓Gemini CLI✓OpenCode
npx skills add OpenKrab/ClawGold

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

ClawGold v2.0

Descripción: ClawGold es un sistema de trading autónomo de XAUUSD (Oro vs Dólar estadounidense) impulsado por agentes de IA. Cuenta con integración multi-proveedor de LLM a través de LiteLLM, un robusto backend APScheduler, análisis técnico avanzado, análisis de sentimiento en tiempo real y ejecución automatizada de operaciones.

Última actualización: Fase 1 (v2.0.0) — Integración LiteLLM, migración a APScheduler, mejora de logging con Rich.

Rendimiento: Llamadas a LLM en menos de un segundo con respaldo automático; recuperación persistente de trabajos; mejora de ~10-15% en fiabilidad.

Seguridad: Arquitectura local, bases de datos SQLite auto-alojadas, sin intercambio de datos. Todas las señales de trading son solo recomendaciones asistidas por IA.

Fase 1: Novedades

🚀 Integración LiteLLM

  • Interfaz de IA Unificada: OpenCode, KiloCode, Gemini, Codex a través de una única API LiteLLM
  • Respaldo Automático: Encadenamiento de proveedores; reintento de llamadas fallidas con retroceso exponencial
  • Seguimiento de Costos: Registro de costos de LLM en tiempo real en SQLite (data/llm_costs.db)
  • Mejor Fiabilidad: Reducción del 10-15% en fallos de API

📅 Migración a APScheduler

  • Persistencia de Trabajos: Las tareas programadas sobreviven a reinicios (almacenadas en data/scheduler.db)
  • Tres Modos de Programación: Diario (basado en hora), por intervalo (segundos), cron (patrones avanzados)
  • Pool de Hilos: Máximo 4 trabajos concurrentes para uso eficiente de recursos
  • Recuperación Graceful: Período de gracia de 30 segundos para trabajos fallidos

🎨 Logging Mejorado con Rich

  • Salida de Consola Mejorada: Logs coloreados, paneles, tablas, barras de progreso
  • Mejor UX: Depuración más rápida con jerarquía visual
  • Logging a Archivo: Todos los logs guardados en logs/clawgold.log con marcas de tiempo

Características

Motor Principal de Trading

  • Monitoreo de Precios: Obtención de precios de XAUUSD en tiempo real vía Yahoo Finance
  • Análisis Técnico: Cálculos de medias móviles, cruces de EMA, análisis multi-marco temporal (M15, H1, H4, D1)
  • Generación de Señales: Señales automáticas de compra/venta/retención basadas en cruce de MA y consenso de IA
  • Simulación de Operaciones: Ejecución realista de operaciones con seguimiento de cartera
  • Gestión de Cartera: Monitoreo de saldo, seguimiento de posiciones, cálculos de P&L

Mejoras de la Fase 1

  • Integración LiteLLM: Interfaz de IA unificada multi-proveedor (OpenCode, KiloCode, Gemini, Codex)
  • Respaldo Automático: Encadenamiento de múltiples proveedores; reintento automático con retroceso exponencial
  • Backend APScheduler: Programación persistente de trabajos en segundo plano con recuperación ante caídas
  • Salida de Consola Mejorada con Rich: Logs coloreados, paneles, tablas, barras de progreso
  • Seguimiento de Costos: Análisis de costos de LLM en tiempo real por proveedor (almacenamiento en SQLite)

Análisis Impulsado por IA

  • Investigación Multi-IA: Consultas paralelas a múltiples proveedores de IA para análisis de mercado
  • Análisis de Sentimiento: Puntuación de sentimiento en tiempo real desde múltiples fuentes
  • Investigación de Mercado: Perspectivas de mercado y predicciones de tendencias generadas por IA
  • Evaluación de Riesgos: Recomendaciones de dimensionamiento de posiciones y gestión de riesgos impulsadas por IA
  • Agregación de Noticias: Recopilación automática de noticias con análisis de sentimiento

Estrategias Avanzadas de Trading

  • Trailing Stops: Ajuste automático del stop-loss siguiendo el movimiento del precio
  • Grid Trading: Órdenes de compra/venta en múltiples niveles para capturar volatilidad
  • Detección de Rupturas: Señales automáticas de entrada por ruptura
  • Modo Scalping: Operaciones de alta frecuencia sobre micro-tendencias
  • Gestión de Riesgos: Límites diarios de pérdidas, monitoreo de margen, dimensionamiento de posiciones

Aplicaciones

  • Trading Autónomo: Trading 24/7 sin intervención manual
  • Decisiones Asistidas por IA: Obtén consenso de IA sobre la dirección del mercado antes de operar
  • Prueba de Estrategias: Backtesting y simulación de ideas de trading con condiciones realistas
  • Educación: Aprende conceptos avanzados de trading con guía de IA
  • Investigación: Agrega noticias de mercado y sentimiento en un solo panel

Herramientas

get_xauusd_price

  • Descripción: Obtiene el precio actual de XAUUSD desde Yahoo Finance.
  • Parámetros: Ninguno
  • Devuelve: Cadena con el precio actual en USD por onza.
  • Ejemplo: "Precio actual de XAUUSD: 5146.9 USD por onza"

calculate_moving_average

  • Descripción: Calcula la media móvil simple para XAUUSD durante el período especificado.
  • Parámetros:
    • period (entero, predeterminado 20): Número de días para la media móvil.
  • Devuelve: Cadena con el valor de la SMA.
  • Ejemplo: "SMA(20): 5123.45"

generate_trading_signal

  • Descripción: Genera una señal de trading basada en la estrategia de cruce de medias móviles.
  • Parámetros:
    • short_period (entero, predeterminado 10): Período de la MA corta.
    • long_period (entero, predeterminado 20): Período de la MA larga.
  • Devuelve: Cadena que indica COMPRA, VENTA o RETENCIÓN.
  • Ejemplo: "Señal de COMPRA"

simulate_trade

  • Descripción: Simula la compra o venta de XAUUSD con la cantidad especificada.
  • Parámetros:
    • action (cadena): "COMPRA" o "VENTA"
    • amount (flotante): Cantidad de oro en onzas.
  • Devuelve: Cadena con el resultado de la operación.
  • Ejemplo: "COMPRA simulada: 0.1 oz a 5146.90 USD"

get_portfolio_status

  • Descripción: Recupera el estado actual de la cartera simulada.
  • Parámetros: Ninguno
  • Devuelve: Cadena con el saldo y las posiciones.
  • Ejemplo: "Saldo: 9742.60 USD\nPosiciones:\n COMPRA 0.05 oz a 5148.00 USD\nTotal de operaciones: 2"

ai_research

  • Descripción: Realiza investigación de mercado impulsada por IA utilizando múltiples herramientas CLI (OpenCode, KiloCode, Gemini).
  • Parámetros:
    • query (cadena): Pregunta de investigación sobre condiciones del mercado.
    • tools (lista, opcional): Lista de herramientas de IA a utilizar. Predeterminado: ['opencode', 'kilocode', 'gemini']
  • Devuelve: Resultados de investigación agregados con análisis de sentimiento.
  • Ejemplo: "Resumen de Investigación IA: Consenso ALCISTA de 3 herramientas"

Herramientas CLI de IA

Las siguientes herramientas CLI de IA son compatibles para la investigación de mercado:

HerramientaInstalaciónUso
OpenCodenpm install -g opencodeopencode run "<prompt>"
KiloCodehttps://kilo.aikilo run "<prompt>"
Gemininpm install -g @google/gemini-cligemini "<prompt>"

Uso

  • Instalación de ClawFlow: clawflow install claw-gold
  • Configuración: Edita config.yaml para personalizar la configuración.
  • Integración: Úsalo con el agente OpenClaw para asistencia en trading.

Soporte y Comunidad

Documentación

Soporte Comunitario

  • GitHub Issues: Reportes de errores y solicitudes de funciones

Versión: 2.0.0 Estado: Listo para Producción (Fase 1 Completa) Licencia: MIT Mantenedores: JonusNattapong Última Actualización: 4 de marzo de 2026

Notas de la Versión Fase 1

  • ✅ Interfaz unificada de proveedores de IA con LiteLLM
  • ✅ Programación persistente de trabajos con APScheduler
  • ✅ Logging mejorado en consola con Rich
  • ✅ Seguimiento automático de costos y análisis
  • ✅ 100% retrocompatible

Próximo: Fase 2 (PydanticAI + Langfuse SDK) próximamente.

Características

  • Monitoreo de Precios: Obtención de precios de XAUUSD en tiempo real
  • Análisis Técnico: Cálculos de medias móviles
  • Generación de Señales: Señales automáticas de compra/venta basadas en cruce de MA
  • Simulación de Operaciones: Ejecución realista de operaciones con seguimiento de cartera
  • Gestión de Cartera: Monitoreo de saldo y posiciones

Aplicaciones

  • Educación en Trading: Aprende estrategias de trading sin dinero real
  • Prueba de Estrategias: Backtesting y simulación de ideas de trading
  • Automatización: Integración con OpenClaw para alertas automáticas de trading

Herramientas

get_xauusd_price

  • Descripción: Obtiene el precio actual de XAUUSD desde Yahoo Finance.
  • Parámetros: Ninguno
  • Devuelve: Cadena con el precio actual en USD por onza.
  • Ejemplo: "Precio actual de XAUUSD: 5146.9 USD por onza"

calculate_moving_average

  • Descripción: Calcula la media móvil simple para XAUUSD durante el período especificado.
  • Parámetros:
    • period (entero, predeterminado 20): Número de días para la media móvil.
  • Devuelve: Cadena con el valor de la SMA.
  • Ejemplo: "SMA(20): 5123.45"

generate_trading_signal

  • Descripción: Genera una señal de trading basada en la estrategia de cruce de medias móviles.
  • Parámetros:
    • short_period (entero, predeterminado 10): Período de la MA corta.
    • long_period (entero, predeterminado 20): Período de la MA larga.
  • Devuelve: Cadena que indica COMPRA, VENTA o RETENCIÓN.
  • Ejemplo: "Señal de COMPRA"

simulate_trade

  • Descripción: Simula la compra o venta de XAUUSD con la cantidad especificada.
  • Parámetros:
    • action (cadena): "COMPRA" o "VENTA"
    • amount (flotante): Cantidad de oro en onzas.
  • Devuelve: Cadena con el resultado de la operación.
  • Ejemplo: "COMPRA simulada: 0.1 oz a 5146.90 USD"

get_portfolio_status

  • Descripción: Recupera el estado actual de la cartera simulada.
  • Parámetros: Ninguno
  • Devuelve: Cadena con el saldo y las posiciones.
  • Ejemplo: "Saldo: 9742.60 USD\nPosiciones:\n COMPRA 0.05 oz a 5148.00 USD\nTotal de operaciones: 2"

ai_research

  • Descripción: Realiza investigación de mercado impulsada por IA utilizando múltiples herramientas CLI (OpenCode, KiloCode, Gemini).
  • Parámetros:
    • query (cadena): Pregunta de investigación sobre condiciones del mercado.
    • tools (lista, opcional): Lista de herramientas de IA a utilizar. Predeterminado: ['opencode', 'kilocode', 'gemini']
  • Devuelve: Resultados de investigación agregados con análisis de sentimiento.
  • Ejemplo: "Resumen de Investigación IA: Consenso ALCISTA de 3 herramientas"

Herramientas CLI de IA

Las siguientes herramientas CLI de IA son compatibles para la investigación de mercado:

HerramientaInstalaciónUso
OpenCodenpm install -g opencodeopencode run "<prompt>"
KiloCodehttps://kilo.aikilo run "<prompt>"
Gemininpm install -g @google/gemini-cligemini "<prompt>"

Uso

  • Instalación de ClawFlow: clawflow install claw-gold
  • Configuración: Edita config.yaml para personalizar la configuración.
  • Integración: Úsalo con el agente OpenClaw para asistencia en trading.

Soporte y Comunidad

Documentación

Soporte Comunitario

  • GitHub Issues: Reportes de errores y solicitudes de funciones

Versión: 1.0.0 Estado: MVP Listo Licencia: MIT Mantenedores: JonusNattapong

Skills relacionados