它的設定檔問你要 9 把 API key、2 把私鑰。同一個檔案裡,沒有一行問你「最多能虧多少」。
一句話結論:CloddsBot 不是空殼,121 個技能和 10 個預測市場的程式碼都真實存在,而且它從不吹報酬率;但風控程式碼只佔全庫 0.49%,3 萬字 README 沒有一句風險提示,只適合看得懂 TypeScript 又願意先用小錢試的人。
我把這個倉庫從頭到尾數了一次。以下所有數字都是用 GitHub API 和 git tree 重算出來的,沒有一個抄自 README 徽章。讀數時間是 2026 年 9 月 11 日 04:06–04:13 UTC。
CloddsBot 到底是什麼?
它是一個裝在你自己電腦上的 AI 交易代理(trading agent,指能自己判斷並下單的程式)。你用 Telegram 或網頁聊天視窗跟它講話,它去掃 Polymarket、Kalshi 這類預測市場,以及 Binance、Hyperliquid 這類永續合約交易所,找到價差就下單。作者是 alsk1992,MIT 授權,TypeScript 寫的,為 Solana 的 Colosseum Agent Hackathon 而做。
規模先講清楚。整個倉庫 828 個檔案、12,894,693 bytes,其中 TypeScript 佔 622 個檔、9,859,057 bytes。git tree API 回傳 truncated: false,代表這是完整清單,不是被截斷的樣本。
星數 1,759 顆,fork 262 個,watcher 23 個。我在 04:06 讀到 1,756、04:13 讀到 1,759,七分鐘多了 3 顆,所以這是活數字,不是被快取凍住的舊值。
它宣稱支援的那些交易所,程式碼真的在嗎?
在。而且不是一兩個空檔案敷衍過去。我按平台名稱去數 git tree 裡的實際位元組:
| 平台 | 檔案數 | 程式碼大小 |
|---|---|---|
| Solana 生態 | 29 | 659,368 bytes |
| Polymarket | 11 | 222,596 bytes |
| Kalshi | 6 | 135,160 bytes |
| Hyperliquid | 4 | 106,151 bytes |
| x402 機器對機器付款 | 3 | 49,879 bytes |
| Binance 合約 | 4 | 41,698 bytes |
為了確認我的搜尋工具不是「搜什麼都有」,我拿三個絕對不該出現的名字做反向對照:FTX、Mt.Gox、BitConnect,各自 0 個檔案。工具沒壞,上面那些數字是真的。
「12 天寫完」這句話,禁得起查嗎?
禁得起。這點出乎我意料。
README 寫著為黑客松「12 天開發完成」。我去數 commit:全庫 447 個 commit,第一個在 2026-01-27 00:30:43 UTC。以那一刻起算 12 天,這段窗口內有 241 個 commit,佔全部的 53.9%。剩下 206 個分散在之後的七個多月,最近 30 天還有 53 個。
超過一半的 commit 確實落在頭 12 天。這是黑客松衝刺,不是行銷話術。而且它衝完之後沒有爛尾。
但同一份 commit 資料也吐出另一件事。貢獻者只有 4 個:alsk1992 436 個 commit、dependabot 機器人 6 個、另外兩位各 2 個和 1 個。一個人寫了 97.5%。對一個要拿你 API key 和私鑰的程式來說,這代表如果作者哪天不做了,補安全漏洞的人就沒了。
121 個技能,為什麼 README 一下說 118 一下說 119?
因為它自己也沒數清楚,而且是往少了說。
我去數 src/skills/bundled/ 底下的資料夾:121 個。而且這 121 個全部都有 index.ts(實作)和 SKILL.md(說明),121 比 121,沒有一個是空殼佔位。
README 那邊呢?徽章寫「119+ Skills」,表格寫「119 bundled skills」,但另一段又寫「118 bundled skills」,架構圖寫「118+ Strategies」。同一份 3 萬字的文件裡,同一個東西出現兩個數字。
再往下追一層,docs/SKILLS_CATALOG.md 標題寫「119 Skills」,底下切 11 個分類,逐類標了數量。我把 11 個分類的數字加起來:12 + 8 + 11 + 12 + 11 + 10 + 15 + 16 + 9 + 13 + 2 = 119,跟標題完全對得上,表格裡也剛好列了 119 行。這份目錄自己內部是乾淨的。
所以差在哪?差在磁碟上有兩個技能沒被寫進目錄:dex 和 rust-hft-arbitrage。119 + 2 = 121,數字對上了。
這種錯法值得記住。大部分專案的數字造假是往多了吹,這個是往少了報,而且漏掉的那兩個之一還是用 Rust 寫的高頻套利模組,算是它比較硬的功能。文件跟不上開發速度,比文件吹牛好得多,但你查它的時候要知道:README 的數字是作者記憶,不是程式碼事實。
那到底哪裡有問題?
問題在比例。我把倉庫按用途分桶量:
| 用途 | 目錄 | 大小 | 佔全庫 |
|---|---|---|---|
| 技能 | src/skills/ | 2,404,535 bytes | 18.65% |
| AI 代理 | src/agents/ | 1,103,740 bytes | 8.56% |
| 下單交易 | src/trading/ | 613,860 bytes | 4.76% |
| 執行層 | src/execution/ | 344,739 bytes | 2.67% |
| 風控 | src/risk/ | 63,052 bytes | 0.49% |
把所有負責把錢送出去的目錄加總(trading、execution、exchanges、solana、evm),是 1,808,405 bytes。負責保護你的錢的 src/risk/,是 63,052 bytes。
花錢的程式碼,是攔錢的程式碼的 28.7 倍。
文件那邊同一個方向。docs/TRADING.md 81,275 bytes,docs/RISK_MANAGEMENT.md 6,649 bytes,教你怎麼下單的篇幅是教你怎麼保命的 12.2 倍。而這個東西支援的槓桿,README 自己寫著 Bybit 最高 200 倍、Binance 125 倍。
我要把話講公道:0.49% 不等於沒有。那 7 個檔案裡有真東西,風險引擎 15,094 bytes、熔斷器 13,912 bytes、壓力測試 10,744 bytes,還有 VaR 計算和波動率偵測。測試也不是裝飾,tests/trading-safety.test.ts 裡我數到 25 個具名測試案例,涵蓋 Kelly 下注公式、熔斷器的觸發與重置、速率限制、持倉集中度(HHI)。這比大多數開源交易機器人認真。
最刺眼的是哪個檔案?
.env.example。這是你安裝第一天會複製的那個設定檔範本,7,361 bytes,60 個設定項。
我拿 6 個交易安全相關的關鍵字去掃它:DRY_RUN(空跑)、PAPER(模擬倉)、MAX_POSITION(單筆上限)、DAILY_LOSS(每日虧損上限)、KILL_SWITCH(緊急停止)、MAX_LEVERAGE(槓桿上限)。
六個全部 0 次。
同一支掃描器,在同一個檔案裡找到 API_KEY 9 次、PRIVATE_KEY 2 次。掃描器沒壞,那六個零是真的零。
公道話再講一次:這些限制在程式裡是存在的,docs/RISK_MANAGEMENT.md 有「觸發條件」「預設組合」「CLI 指令」三節,你可以事後用指令設。但新手裝完通常只改 .env,然後就開始聊天下單了。安全設定藏在第二層,而私鑰放在第一層。
它有沒有吹過報酬率?
沒有。一次都沒有,這是它最讓我意外的地方。
我在 31,025 bytes 的 README 裡掃了一整排關鍵字:ROI 0 次、winrate 0 次、returns 0 次、APY 0 次、Sharpe 0 次、profitable 0 次、backtest result 0 次。唯一出現的 “win rate” 是在說交易紀錄功能可以統計勝率,不是宣稱它有多少勝率;唯一出現的 “profit” 是套利範例裡的「3 美分價差」。
對照組:同一份 README 裡 trading 出現 33 次、market 41 次、skill 14 次。掃描器正常運作。
市面上大多數開源交易機器人會塞一張回測曲線,年化 300% 那種。這個沒有。它連自己的套利範例都註明「預設空跑模式」。在這個題材裡,不吹數字本身就是一種品質訊號。
那為什麼它偏偏把那個徽章放上去?
README 頂部掛著一個橘綠色徽章:「10.7k clones / 14d」,14 天內被 clone 一萬零七百多次,下面還配一張後台截圖。
這個數字你查不到。GitHub 的 clone 流量統計只有倉庫擁有者在 Insights 頁面看得到,外人沒有任何 API 可以驗證。而同一時間,任何人都查得到的公開數字是 1,759 顆星。
我不是說那張截圖是假的,clone 數包含 CI 和各種自動化拉取,一萬次完全可能。重點是選擇:它給了最大版面的那個數字,剛好是讀者唯一無法查證的那個。這跟前面「不吹報酬率」的克制,是同一個作者在同一份文件裡的兩種態度。
另一個對它有利的數字:fork 佔星數 14.9%,262 個 fork 對 1,759 顆星。fork 比例高通常代表人們真的拉回去改,不只是按個星收藏。
3 萬字 README 裡有免責聲明嗎?
沒有。我用 8 個關鍵字獨立掃過:disclaimer、not financial advice、financial advice、at your own risk、no warranty、AS IS、educational purposes、use at your own。八個全部 0 次。
LICENSE 檔案裡確實有 MIT 授權的標準條款,AS IS、WITHOUT WARRANTY、LIABILITY 各出現一次。但那是軟體瑕疵免責,講的是程式壞了不賠你,不是「你用 200 倍槓桿爆倉了不關我事」。兩者不是同一件事。
一個叫你填私鑰、連上永續合約交易所、可以 24 小時自己下單的程式,三萬字說明書裡沒有一句提醒你可能虧錢。這是我對它最大的保留。
那到底誰該跑,誰不要碰?
| 你的情況 | 建議 |
|---|---|
| 看得懂 TypeScript,想研究預測市場套利怎麼實作 | 值得讀,程式碼密度高 |
| 想接 Polymarket、Kalshi 的 API 但懶得自己寫封裝 | 可以抄,各平台封裝都完整 |
| 不會看程式碼,只想「開著它幫我賺錢」 | 不要碰 |
| 想用槓桿,而且沒設過停損 | 絕對不要碰 |
| 手上只有一個交易所帳號,資金是生活費 | 不要碰 |
如果你決定要試,照這個順序做:
- 先開一個只有小額資金的獨立帳號,不要用主帳號的 API key。
- 交易所後台建 API key 時,把提幣權限關掉,只留交易權限。
- 裝完先別填交易所 key,只填 LLM 的 key,讓它只讀行情不下單,觀察幾天。
- 讀完
docs/RISK_MANAGEMENT.md,用 CLI 把熔斷器和每日虧損上限設好,再開下單。 - 槓桿從 1 倍開始。它支援 200 倍不代表你要用 200 倍。
- 定期看
clodds ledger stats,它有決策紀錄功能,能回頭查每一筆是為什麼下的。
有沒有其他選擇?
有,看你要什麼。想要能自己描述策略再回測的,可以看港大開源的 Vibe-Trading,它偏研究和回測,不是全自動下單。想看另一種「AI 分析師團隊」型態的專案,我之前查過一個宣稱 68,233 筆交易在 6 秒內成交的開源 AI 對沖基金,那篇的查法跟這篇一樣。
如果你只是想要「AI 幫我看盤」而不是「AI 幫我下單」,老實說你不需要這種東西,把行情餵給 ChatGPT 或 Claude 問問題就夠了,風險是零。
查一個交易機器人,該看哪幾個數字?
這篇的方法你可以直接套到下一個專案上,六個問題:
- 風控目錄佔全庫多少百分比?低於 1% 就要警覺。
.env.example有沒有虧損上限和空跑開關?沒有就是預設全速。- README 有沒有報酬率宣稱?有的話,去要原始交易紀錄。
- 有沒有免責聲明?MIT 的 AS IS 不算。
- 幾個人在寫?一個人寫 97% 的專案,補安全漏洞靠運氣。
- 它放在徽章上的數字,你查得到嗎?查不到的數字不要當證據。
我在同一天查另一個 GitHub 日榜第一的專案時也用了類似的做法,結果發現它自己的測試報告寫著 FAILED 而 README 一次都沒提。專案不會騙你,但 README 常常會漏講。
常見問題
CloddsBot 是免費的嗎?
是,MIT 授權,可自由使用和修改。但你要自己付 LLM 的 API 費用,它支援 8 個模型供應商。
它真的能同時操作 1,000 個市場嗎?
「1000+ Markets」是 README 徽章上的數字,它沒有說明這個數字怎麼算出來的,我也無法從程式碼反推。可以確認的是它接了 10 個預測市場平台、7 個永續合約交易所,各平台的封裝程式碼都真實存在。
它有風控功能嗎?
有。src/risk/ 有風險引擎、熔斷器、VaR 計算、壓力測試、波動率偵測,測試檔裡有 25 個具名安全測試案例。但整個風控目錄只佔全庫 0.49%,而且安裝範本 .env.example 裡沒有任何虧損上限設定,要另外用 CLI 設。
星數 1,759 算多嗎?值得信嗎?
星數跟可靠度沒有直接關係。比較有意義的是 fork 佔星數 14.9%,代表有人真的拉回去改而不只是收藏。判斷可靠度應該去看倉庫裡有沒有測試、風控佔比多少、有沒有免責聲明,而不是看星數。
「12 天開發完成」是行銷話術嗎?
不是。全庫 447 個 commit 裡,有 241 個落在第一個 commit 之後的 12 天內,佔 53.9%。之後七個多月又累積了 206 個,最近 30 天還有 53 個,專案仍在維護。
本文所有 GitHub 數據由 GitHub REST API 與 git tree API 於 2026 年 9 月 11 日 04:06–04:13 UTC 一手重算,星數等即時數值會持續變動。倉庫位置:github.com/alsk1992/CloddsBot。
免責聲明:本文為開源專案的程式碼查核與技術分析,不構成任何投資建議、財務建議或交易建議。自動化交易工具可能因程式錯誤、網路延遲、交易所故障或市場波動造成本金全部損失,使用槓桿會放大這個風險。任何人自行部署交易機器人、提供 API 金鑰或私鑰所產生的一切後果,由使用者自行承擔。加密貨幣與衍生品交易風險極高,請先評估自身風險承受能力,切勿投入無法承受損失的資金。





發佈留言