CloddsBot 是一個以 TypeScript 寫成的開源 AI 交易代理,可在預測市場、加密現貨、永續合約與代幣發行之間自主運作。它透過 21 種通訊平台以對話指令操作,內建風險管理、跨平台套利偵測與決策稽核帳本。官方宣稱涵蓋 1000+ 市場與 118+ 交易策略。
CloddsBot 是一個開源的 AI 交易代理,程式碼以 TypeScript 為主(97.6%),採 MIT 授權,GitHub 上有 424 顆星、92 個 fork。它的定位是自主運作的交易代理:使用者以自然語言下指令,代理負責在多個市場執行下單、套利與風險控制。
操作介面是聊天。CloddsBot 接上 21 種通訊平台,包含 Telegram、Discord、Slack、WhatsApp、Teams、Signal、Matrix、iMessage 與 WebChat,在對話框輸入指令即可操作。它同時連接 10 個預測市場(Polymarket、Kalshi、Betfair、Drift、Manifold、Metaculus、Opinion.xyz、Predict.fun)、7 個永續合約交易所(Binance、Bybit、Hyperliquid、MEXC、Drift、Percolator、Lighter),以及 Solana 與 5 條 EVM 鏈(Ethereum、Arbitrum、Optimism、Base、Polygon)上的 DeFi 協議。
風險控制與稽核是內建的。系統提供斷路器、VaR/CVaR、Kelly 部位計算與波動度體制偵測;每一筆決策寫入交易帳本,含信心校準與 SHA-256 完整性雜湊,可回溯查核。官方宣稱內建 118+ 交易策略,涵蓋動能、均值回歸、套利、DCA、鯨魚追蹤與跟單,並覆蓋 1000+ 市場。
最快的方式是全域安裝 npm 套件,再執行互動式設定精靈。安裝需要 Node.js 與 npm 環境。
若要修改原始碼或自行建置,從 GitHub clone 後手動安裝相依、複製環境變數範本並建置:
clodds onboard 後,建議先執行 clodds doctor 做系統診斷、clodds secure 強化安全設定,並確認 .env 內交易所 API 金鑰與錢包私鑰的檔案權限,再開始實際交易。
CloddsBot 有兩層操作介面:終端機的 clodds CLI,負責安裝、啟動、診斷與帳本;以及通訊平台內的對話指令(以 / 開頭),負責實際下單與查詢。下方整理常用入口,實際可用指令以官方文件為準。
/percolator deposit 入金。/tao earnings daily 看每日收益。| 你想交易什麼 | 平台 | 入口 |
|---|---|---|
| 預測市場(事件、政治、體育) | Polymarket、Kalshi、Betfair、Manifold、Metaculus | 對話指令 |
| 加密永續合約 | Binance、Bybit、Hyperliquid、MEXC、Lighter | /futures … |
| 鏈上永續(Solana,免 KYC) | Percolator | /percolator … |
| Solana / EVM DeFi 現貨 | Jupiter、Raydium、Orca、Meteora、Uniswap V3 | 對話指令 |
以下整理自官方 README 與 docs/,是 CloddsBot 公布的能力分類與風險控制機制,非社群實測數據。涉及具體策略數量與市場覆蓋的數字為專案自述。
內建斷路器、VaR/CVaR、Kelly 部位計算與波動度體制偵測,於下單前介入控管曝險。
來源 · 官方 README · 風險管理每筆決策寫入帳本,含決策稽核軌跡、信心校準與 SHA-256 完整性雜湊;可用 clodds ledger anchor 錨定到鏈上。
以語意比對在不同平台間辨識等價市場,偵測跨平台價差。
來源 · 官方 READMETelegram、Discord、Slack、WhatsApp、Teams、Signal、Matrix、iMessage、WebChat 等,以對話操作代理。
來源 · 官方 READMEPolymarket、Kalshi、Betfair、Drift、Manifold、Metaculus、Opinion.xyz、Predict.fun。
來源 · 官方 READMEBinance、Bybit、Hyperliquid、MEXC、Drift、Percolator、Lighter。
來源 · 官方 READMESolana 上的 Jupiter、Raydium、Orca、Meteora、Pump.fun;以及 5 條 EVM 鏈:Ethereum、Arbitrum、Optimism、Base、Polygon。
來源 · 官方 README代理之間可進行點對點交易,以 USDC 託管(escrow);另含代幣發行與按用量計費的 Compute API。
來源 · 官方 README以下示範從安裝到操作的流程,使用 CloddsBot 真實的指令語法。實際下單結果取決於市場狀態與你的設定,此處僅示範指令流程,不代表任何績效。
下單前,系統會先跑風險檢查(斷路器、部位上限);下單後,該決策會寫入交易帳本,並可用 clodds ledger anchor 把雜湊錨定到鏈上。也就是說,每一個自動決策都有可回溯的紀錄,而非黑箱執行。
操作面則統一在對話:不論預測市場、永續合約或鏈上 DeFi,入口都是通訊平台裡的斜線指令,降低在多個交易終端之間切換的成本。
.env 內含交易所 API 金鑰與錢包私鑰。請限制檔案權限,先執行 clodds secure,且切勿提交到版本控制或分享。
clodds doctor 診斷。
CloddsBot 以 TypeScript 撰寫並採 MIT 授權,可自行 fork、修改與擴充。repo 提供 Dockerfile 與 docker-compose.yml,適合長時間運作的部署。
1. 讀 USER_GUIDE 完成完整設定。先讀 docs/USER_GUIDE.md,了解通訊平台、交易所與策略的完整設定流程。
2. 以 Docker 部署。使用 repo 內的 Dockerfile 與 docker-compose.yml 容器化部署,維持代理長時間運作。
3. 接成 MCP 伺服器。執行 clodds mcp 把代理開放為 MCP 伺服器,供其他代理或工具呼叫。
4. 啟用決策鏈上錨定。用 clodds ledger anchor <id> 把交易帳本的決策雜湊錨定到鏈上,建立可驗證的稽核紀錄。
5. 設定 Bittensor 挖礦。執行 clodds bittensor setup 設定子網 TAO 挖礦,並以 /tao status 監看狀態。
① docs/USER_GUIDE.md——完整設定與操作指南。
② docs/API_REFERENCE.md——指令與 API 參考。
③ docs/ARCHITECTURE.md——系統架構說明。