Communitygithub.com

OpenKrab/ClawGold

利用 LiteLLM、APScheduler 和先進策略,由 AI 驅動的 XAUUSD 交易系統。

ClawGold 是什麼?

ClawGold 是一個由 AI 驅動的自主交易系統,專注於 XAUUSD(黃金兌美元)交易。它透過 LiteLLM 整合了多個 AI 提供商(如 OpenCode、KiloCode、Gemini 等),提供統一的市場分析接口,並支援自動故障轉移與成本追蹤。系統採用 APScheduler 進行持久化的背景任務排程,確保交易作業在重啟後仍能恢復,並搭配 Rich 庫進行豐富的日誌輸出,提升除錯體驗。核心功能包括即時價格監控、技術指標計算(如移動平均線)、多時間框架分析、交易訊號生成以及模擬交易執行。此外,ClawGold 還整合了情感分析、新聞聚合與先進的交易策略(如 trailing stop、網格交易、突破檢測),適用於 24/7 自主交易、策略回測與教育用途。

相容平台~Claude Code✓Codex CLI~Cursor✓Gemini CLI✓OpenCode
npx skills add OpenKrab/ClawGold

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

ClawGold v2.0

描述: ClawGold 是一個由 AI 代理驅動的自主 XAUUSD(黃金兌美元)交易系統。它具備透過 LiteLLM 進行的多供應商 LLM 整合、強大的 APScheduler 後端、進階技術分析、即時情感分析以及自動化交易執行功能。

最新更新: 第一階段 (v2.0.0) — LiteLLM 整合、APScheduler 遷移、Rich 日誌強化。

效能: 次秒級 LLM 呼叫並自動故障轉移;持久作業恢復;可靠性提升約 10-15%。

安全性: 本地優先架構、自託管 SQLite 資料庫、無資料共享。所有交易訊號僅為 AI 輔助建議,不構成投資建議。

第一階段:新功能

🚀 LiteLLM 整合

  • 統一 AI 接口:透過單一 LiteLLM API 存取 OpenCode、KiloCode、Gemini、Codex
  • 自動故障轉移:鏈結供應商;使用指數退避重試失敗的呼叫
  • 成本追蹤:即時 LLM 成本記錄至 SQLite (data/llm_costs.db)
  • 更高可靠性:API 失敗率降低 10-15%

📅 APScheduler 遷移

  • 作業持久化:排程任務在重啟後仍存活(儲存於 data/scheduler.db)
  • 三種排程模式:每日(基於時間)、間隔(秒)、cron(進階模式)
  • 執行緒池:最多 4 個並發作業,高效利用資源
  • 優雅恢復:為錯失的作業提供 30 秒寬限期

🎨 Rich 日誌

  • 增強的控制台輸出:彩色日誌、面板、表格、進度條
  • 更好的使用者體驗:藉助視覺層次加快除錯速度
  • 檔案日誌:所有日誌依時間戳儲存至 logs/clawgold.log

功能

核心交易引擎

  • 價格監控:透過 Yahoo Finance 即時獲取 XAUUSD 價格
  • 技術分析:移動平均線計算、EMA 交叉、多時間框架分析(M15、H1、H4、D1)
  • 訊號生成:基於 MA 交叉與 AI 共識的自動化買入/賣出/持有訊號
  • 模擬交易:逼真的交易執行與投資組合追蹤
  • 投資組合管理:餘額監控、持倉追蹤、盈虧計算

第一階段增強功能

  • 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 價格。
  • 參數: 無
  • 回傳: 以美元/盎司為單位的當前價格字串。
  • 範例: "目前 XAUUSD 價格:5146.9 美元/盎司"

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 訊號"

simulate_trade

  • 描述: 模擬以指定數量買入或賣出 XAUUSD。
  • 參數:
    • action (字串):"BUY" 或 "SELL"
    • amount (浮點數):黃金數量,以盎司為單位。
  • 回傳: 交易結果的字串。
  • 範例: "模擬買入:0.1 盎司,價格 5146.90 美元"

get_portfolio_status

  • 描述: 檢索目前模擬投資組合的狀態。
  • 參數: 無
  • 回傳: 包含餘額與持倉的字串。
  • 範例: "餘額:9742.60 美元\n持倉:\n 買入 0.05 盎司,價格 5148.00 美元\n總交易次數:2"

ai_research

  • 描述: 使用多個 CLI 工具(OpenCode、KiloCode、Gemini)執行 AI 驅動的市場研究。
  • 參數:
    • query (字串):關於市場狀況的研究問題。
    • tools (清單,可選):要使用的 AI 工具清單。預設值:['opencode', 'kilocode', 'gemini']
  • 回傳: 彙整的研究結果,附帶情感分析。
  • 範例: "AI 研究摘要:來自 3 個工具的看多共識"

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 Issues:錯誤回報與功能請求

版本:2.0.0 狀態:生產就緒(第一階段完成) 授權:MIT 維護者:JonusNattapong 最後更新:2026年3月4日

第一階段版本說明

  • ✅ LiteLLM 統一 AI 提供商接口
  • ✅ APScheduler 持久作業排程
  • ✅ Rich 強化控制台日誌
  • ✅ 自動成本追蹤與分析
  • ✅ 100% 向下相容

下一步: 第二階段(PydanticAI + Langfuse SDK)即將推出。

功能

  • 價格監控:即時 XAUUSD 價格獲取
  • 技術分析:移動平均線計算
  • 訊號生成:基於 MA 交叉的自動化買入/賣出訊號
  • 模擬交易:逼真的交易執行與投資組合追蹤
  • 投資組合管理:餘額與持倉監控

應用

  • 交易教育:無需動用真金白銀學習交易策略
  • 策略測試:回測與模擬交易想法
  • 自動化:與 OpenClaw 整合以實現自動化交易警報

工具

get_xauusd_price

  • 描述: 從 Yahoo Finance 獲取目前 XAUUSD 價格。
  • 參數: 無
  • 回傳: 以美元/盎司為單位的當前價格字串。
  • 範例: "目前 XAUUSD 價格:5146.9 美元/盎司"

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 訊號"

simulate_trade

  • 描述: 模擬以指定數量買入或賣出 XAUUSD。
  • 參數:
    • action (字串):"BUY" 或 "SELL"
    • amount (浮點數):黃金數量,以盎司為單位。
  • 回傳: 交易結果的字串。
  • 範例: "模擬買入:0.1 盎司,價格 5146.90 美元"

get_portfolio_status

  • 描述: 檢索目前模擬投資組合的狀態。
  • 參數: 無
  • 回傳: 包含餘額與持倉的字串。
  • 範例: "餘額:9742.60 美元\n持倉:\n 買入 0.05 盎司,價格 5148.00 美元\n總交易次數:2"

ai_research

  • 描述: 使用多個 CLI 工具(OpenCode、KiloCode、Gemini)執行 AI 驅動的市場研究。
  • 參數:
    • query (字串):關於市場狀況的研究問題。
    • tools (清單,可選):要使用的 AI 工具清單。預設值:['opencode', 'kilocode', 'gemini']
  • 回傳: 彙整的研究結果,附帶情感分析。
  • 範例: "AI 研究摘要:來自 3 個工具的看多共識"

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 Issues:錯誤回報與功能請求

版本:1.0.0 狀態:MVP 就緒 授權:MIT 維護者:JonusNattapong

相關技能