使用手冊

預測市場 / 永續合約 / AI Agent

跨 1000+ 市場的開源 AI 交易代理。

alsk1992/CloddsBot 完整實戰手冊。以 TypeScript 寫成的開源 AI 交易代理,可在預測市場、加密現貨、永續合約與代幣發行之間自主運作,透過 21 種通訊平台以對話操作。安裝、能力總覽、CLI 指令與使用實例。

CloddsBot 是一個以 TypeScript 寫成的開源 AI 交易代理,可在預測市場、加密現貨、永續合約與代幣發行之間自主運作。它透過 21 種通訊平台以對話指令操作,內建風險管理、跨平台套利偵測與決策稽核帳本。官方宣稱涵蓋 1000+ 市場與 118+ 交易策略。

alsk1992/cloddsbot
星標
—
分支
—
授權
—
資料截至
—
閱讀時間
7 分
更新日期
開啟原始報告
GitHub Stars
424
Forks
92
支援市場
1000+
開源授權
MIT
本頁章節

01這到底是什麼

一個用對話操作的自動交易代理。

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+ 市場。

  1. 對話指令

  2. 市場掃描

  3. 策略訊號

  4. 風險檢查

  5. 執行下單

  6. 帳本稽核

「Open Source AI trading agent that operates autonomously across 1000+ markets.」 開源 AI 交易代理,跨 1000+ 市場自主運作。

— CloddsBot README · 專案定義

02安裝

全域安裝, 以 onboard 完成設定。

最快的方式是全域安裝 npm 套件,再執行互動式設定精靈。安裝需要 Node.js 與 npm 環境。

bash
# 全域安裝 CLI,再執行設定精靈
npm install -g clodds --loglevel=error
clodds onboard

從原始碼安裝

若要修改原始碼或自行建置,從 GitHub clone 後手動安裝相依、複製環境變數範本並建置:

bash
git clone https://github.com/alsk1992/CloddsBot.git && cd CloddsBot
npm install && cp .env.example .env
npm run build && npm start

03能力總覽

CLI 指令與對話指令一覽。

CloddsBot 有兩層操作介面:終端機的 clodds CLI,負責安裝、啟動、診斷與帳本;以及通訊平台內的對話指令(以 / 開頭),負責實際下單與查詢。下方整理常用入口,實際可用指令以官方文件為準。

CLI · 設定

clodds onboard

互動精靈

互動式設定精靈,引導完成通訊平台、交易所金鑰與策略設定。

CLI · 啟動

clodds start

啟動閘道

啟動代理閘道,開始接收通訊平台指令並運作。

CLI · 互動

clodds repl

互動主控台

進入 REPL 互動主控台,直接對代理下指令。

CLI · 診斷

clodds doctor

系統診斷

檢查環境、相依與連線狀態,定位設定問題。

CLI · 安全

clodds secure

安全強化

強化安全設定,降低金鑰與權限相關風險。

CLI · 在地化

clodds locale set zh

語言切換

切換介面語言,支援中文等多語系。

CLI · MCP

clodds mcp

MCP 伺服器

啟動 MCP 伺服器,供其他代理或工具接入。

CLI · 帳本

clodds ledger stats

決策統計

顯示交易帳本的決策統計與彙整數據。

CLI · 帳本

clodds ledger anchor <id>

鏈上錨定

將決策雜湊錨定到區塊鏈,提供可驗證的稽核紀錄。

CLI · 挖礦

clodds bittensor setup

Bittensor 挖礦

設定 Bittensor 子網 TAO 挖礦。

對話 · 合約

/futures long BTCUSDT 0.1 10x

永續下單

在聊天中開永續合約多單,指定數量與槓桿倍數。

對話 · 合約

/futures sl BTCUSDT 95000

停損設定

為持倉設定停損價。

對話 · 鏈上

/percolator long 100

鏈上永續

透過 Percolator 在 Solana 上開鏈上永續部位;另有 /percolator deposit 入金。

對話 · TAO

/tao status

挖礦狀態

查詢 Bittensor 挖礦狀態;/tao earnings daily 看每日收益。

對話 · 技能

/skills

技能清單

檢視代理內建技能與其啟用狀態。

想交易什麼,走哪個入口

你想交易什麼平台入口
預測市場(事件、政治、體育)Polymarket、Kalshi、Betfair、Manifold、Metaculus對話指令
加密永續合約Binance、Bybit、Hyperliquid、MEXC、Lighter/futures …
鏈上永續(Solana,免 KYC)Percolator/percolator …
Solana / EVM DeFi 現貨Jupiter、Raydium、Orca、Meteora、Uniswap V3對話指令

04架構與安全 · 官方文件

內建的風險控制與稽核設計。

以下整理自官方 README 與 docs/,是 CloddsBot 公布的能力分類與風險控制機制,非社群實測數據。涉及具體策略數量與市場覆蓋的數字為專案自述。

風險管理層

內建斷路器、VaR/CVaR、Kelly 部位計算與波動度體制偵測,於下單前介入控管曝險。

來源 · 官方 README · 風險管理

交易帳本與稽核

每筆決策寫入帳本,含決策稽核軌跡、信心校準與 SHA-256 完整性雜湊;可用 clodds ledger anchor 錨定到鏈上。

來源 · 官方 docs

跨平台套利偵測

以語意比對在不同平台間辨識等價市場,偵測跨平台價差。

來源 · 官方 README

21 種通訊平台

Telegram、Discord、Slack、WhatsApp、Teams、Signal、Matrix、iMessage、WebChat 等,以對話操作代理。

來源 · 官方 README

10 個預測市場

Polymarket、Kalshi、Betfair、Drift、Manifold、Metaculus、Opinion.xyz、Predict.fun。

來源 · 官方 README

7 個永續合約交易所

Binance、Bybit、Hyperliquid、MEXC、Drift、Percolator、Lighter。

來源 · 官方 README

Solana 與 EVM DeFi

Solana 上的 Jupiter、Raydium、Orca、Meteora、Pump.fun;以及 5 條 EVM 鏈:Ethereum、Arbitrum、Optimism、Base、Polygon。

來源 · 官方 README

代理論壇與市集

代理之間可進行點對點交易,以 USDC 託管(escrow);另含代幣發行與按用量計費的 Compute API。

來源 · 官方 README

05使用實例

從安裝到第一筆下單。

以下示範從安裝到操作的流程,使用 CloddsBot 真實的指令語法。實際下單結果取決於市場狀態與你的設定,此處僅示範指令流程,不代表任何績效。

~ · clodds cli + telegram


# 1. 安裝與設定
$ npm install -g clodds --loglevel=error
$ clodds onboard
  # [setup wizard] 選擇通訊平台 · 連接交易所金鑰 · 設定預設策略
  ok: ✓ 設定已寫入 .env


# 2. 安全與診斷檢查
$ clodds doctor
  ok: ✓ 環境、相依與平台連線正常
$ clodds secure
  ok: ✓ 安全設定已強化


# 3. 啟動代理閘道
$ clodds start
  # [gateway] 監聽中 · Telegram 已連線


# 4. 在 Telegram 對話中操作
$ You › /futures long BTCUSDT 0.1 10x
claude: CloddsBot ›
  [風險檢查] 斷路器與 Kelly 部位上限通過
  ok: 已送出永續多單:BTCUSDT · 0.1 · 10x


$ You › /futures sl BTCUSDT 95000
claude: CloddsBot ›
  ok: 停損已設定:BTCUSDT @ 95000


$ You › /skills
claude: CloddsBot ›
  # 顯示已載入的技能與啟用狀態


# 5. 回終端查交易帳本
$ clodds ledger stats
  # 列出決策統計;每筆決策含信心校準與 SHA-256 雜湊
$ clodds ledger anchor <id>
  ok: ✓ 決策雜湊已錨定到鏈上,可供稽核驗證

操作介面是對話, 風險檢查與決策稽核是內建的。

— CloddsBot 的設計取向

這段流程的重點

下單前,系統會先跑風險檢查(斷路器、部位上限);下單後,該決策會寫入交易帳本,並可用 clodds ledger anchor 把雜湊錨定到鏈上。也就是說,每一個自動決策都有可回溯的紀錄,而非黑箱執行。

操作面則統一在對話:不論預測市場、永續合約或鏈上 DeFi,入口都是通訊平台裡的斜線指令,降低在多個交易終端之間切換的成本。

06先看清楚這些

上線前先確認的邊界。

07進階路徑

把 CloddsBot 接進你的工作流。

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——系統架構說明。

「Open Source AI trading agent that operates autonomously across 1000+ markets.」

— alsk1992/CloddsBot · README