CloddsBot 教程：把 Claude 变成你的全天候交易员

📌 项目日期：2026年9月 | 数据来源：GitHub官方仓库 | 星数：2.1k+

📋 项目简介

CloddsBot（Claude + Odds = Clodds）是一个个人 AI 交易终端（2.1k 星，单日 +627），出自 Colosseum Agent Hackathon——作者用 12 天构建，14 天内拿下 10.7k 次 clones。它把 LLM 变成一个真正的交易 Agent：你通过聊天平台说人话，它分析市场、执行策略、下单交易，还能自己写新技能。覆盖 Polymarket、Kalshi 等 10 个预测市场、Binance 等 7 个期货交易所、9 个 Solana DeFi 协议与 EVM 链上 DEX，内置 118+ 策略。如果你想要多 Agent 分工协作的交易研究框架，可以对比阅读 TradingAgents多Agent交易框架教程：用LLM模拟专业交易公司。

✨ 核心特性

能力	说明
21 个聊天渠道	Telegram、Discord、WhatsApp 等，在哪聊天哪就是交易终端
10 个预测市场	Polymarket、Kalshi、Betfair、Smarkets、Drift、Manifold、Metaculus、PredictIt 等
7 个期货交易所	Binance（125x）、Bybit（100x）、Hyperliquid（50x）、MEXC（200x）、Drift、Percolator（链上无 KYC）、Lighter
Solana DeFi	Jupiter、Raydium、Orca、Meteora、Kamino、Pump.fun（+Jito MEV）等 9 协议
118+ 策略	现成交易策略库，覆盖预测市场、期货、链上各场景
独立风险引擎	熔断、VaR/CVaR、Kelly 仓位、日损失上限、kill switch 与人分割
Trade Ledger 审计	每笔决策记录 SHA-256 摘要，可链上锚定，可回放问责
119 个 Skills	懒加载技能系统，agent 可自己写新技能自我扩展
8 家 LLM 提供商	Anthropic 为核心，另支持 7 家，4 个内置 agent 角色
GoPlus 安全审计	链上交易前自动代币安全检查

🏗️ 工作原理

你（Telegram/Discord/WebChat…21 渠道之一）
   │  "BTC 15分钟轮次怎么看？"
   ▼
Clodds Agent（LLM + LanceDB 语义记忆）
   │  调用 119 个懒加载 skills 之一
   │  ↓ 风险引擎前置检查（VaR / Kelly / 日损失上限 / 熔断）
   ▼
执行层 ──→ Polymarket（BTC 5/15分钟、1h/4h/日轮次专长）
        ──→ 期货所 / Solana DEX / EVM DEX
        ──→ 套利检测（arXiv:2508.03474，默认 dry-run）
   │
   ▼
Trade Ledger（SHA-256 审计 + 链上锚定）──→ 回到你聊天窗口的汇报

🚀 安装与上手

# 一、全局安装并引导配置（必需 ANTHROPIC_API_KEY）
npm install -g clodds
clodds onboard

# 二、打开内置 WebChat（无需接外部平台即可开始）
#    浏览器访问 http://localhost:18789

# 三、接入聊天渠道（选配，环境变量示例）
TELEGRAM_BOT_TOKEN=...
DISCORD_BOT_TOKEN=...
POLYMARKET_API_KEY=...

# 四、开发者
npm run dev      # 热重载
npm test         # 测试
docker compose up --build   # 容器化部署

数据自动存放在 ~/.clodds/（SQLite 首次运行自动创建）。生态还包含 Agent Forum（cloddsbot.com/forum，只有验证过的 Clodds 实例能注册 agent，人类只读）、Agent Marketplace（USDC 链上托管买卖代码/数据集）与 Compute API（x402 USDC 按次付费算力）。项目 MIT 开源，支持含中文在内的 10 种语言。

💡 使用建议

• 先 dry-run 后实盘：套利模块默认 dry-run，请保持这个习惯，任何新策略先让 Ledger 记录足够多的模拟决策，再谈真金白银。
• 风控参数先收紧：日损失上限、Kelly 系数、kill switch 全部先设保守值，加密与高杠杆市场波动远超直觉。
• 从预测市场小仓位切入：Polymarket 的 BTC 短周期轮次是它的专长场景，相比 200x 杠杆期货更适合作为第一个实盘试验场。
• 善用语义记忆与审计：LanceDB 记忆让它越用越懂你的风格；Trade Ledger 可回放每笔决策，是复盘学习的最佳材料。
• 搭配研究工具：A股场景可参考 Sequoia-X教程：A股自动选股系统，技术形态扫描+飞书推送配置指南，形成多市场观察。