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 工具:
| 工具 | 安裝方法 | 使用方式 |
|---|---|---|
| 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 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 工具:
| 工具 | 安裝方法 | 使用方式 |
|---|---|---|
| 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 Issues:錯誤回報與功能請求
版本:1.0.0 狀態:MVP 就緒 授權:MIT 維護者:JonusNattapong