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.logcon 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:
| Herramienta | Instalación | Uso |
|---|---|---|
| OpenCode | npm install -g opencode | opencode run "<prompt>" |
| KiloCode | https://kilo.ai | kilo run "<prompt>" |
| Gemini | npm install -g @google/gemini-cli | gemini "<prompt>" |
Uso
- Instalación de ClawFlow:
clawflow install claw-gold - Configuración: Edita
config.yamlpara 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:
| Herramienta | Instalación | Uso |
|---|---|---|
| OpenCode | npm install -g opencode | opencode run "<prompt>" |
| KiloCode | https://kilo.ai | kilo run "<prompt>" |
| Gemini | npm install -g @google/gemini-cli | gemini "<prompt>" |
Uso
- Instalación de ClawFlow:
clawflow install claw-gold - Configuración: Edita
config.yamlpara 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