CloddsBot

CloddsBot 快速入门

CloddsBot（alsk1992/CloddsBot，Claude + Odds = Clodds）是一个开源（MIT）的自主 AI 交易代理：基于 Claude，覆盖 1000+ 市场——Polymarket / Kalshi 等预测市场、Binance / Hyperliquid 永续合约、Solana DEX（Jupiter / Pump.fun / Raydium / Orca）、5 条 EVM 链，自主扫描套利机会、执行交易、管理风险，通过 21 个消息平台（Telegram / WhatsApp / Discord 等）聊天操控。TypeScript / Node ≥22，自托管。2026-09-29 核验（GitHub API）：2,898★ / 353 fork，最近 push 2026-09-18（持续活跃），README 徽章标注 121+ Skills、Colosseum Agent Hackathon 参赛项目、14 天 10.7k clones，官网 cloddsbot.com 在线。

这是什么？适合谁？

CloddsBot 把「AI 替你看盘、下单、控风险」做成了一个可以跑在自己机器上的个人交易终端。它的核心循环是：扫描 → 发现 edge（套利/错价机会）→ 执行 → 风控，全程由 Claude 驱动决策，你通过任意消息平台的 Bot 对话交互——睡觉时它在工作，醒来后它汇报。

关键能力（README 核验）：

• 市场覆盖：10 个预测市场（Polymarket、Kalshi 等）+ 7 个合约交易所（Binance、Hyperliquid 等）+ Solana 全生态（Jupiter、Pump.fun、Raydium、Orca、Bags.fm）+ 5 条 EVM 链（Base、ETH、Arbitrum 等）
• 121+ Skills：交易技能以 Skill 形式组织，可扩展
• 21 个消息渠道：Telegram、WhatsApp、Discord 等 21 个平台皆可作为控制台
• 自托管：跑在自己机器上，私钥不交第三方
• Agent commerce protocol：支持机器对机器支付的代理商务协议

适合人群：懂技术（会 Node.js、懂钱包与私钥管理）的量化/交易爱好者，想要一个可自托管、可魔改的 AI 交易 Agent 骨架；参与预测市场套利的开发者。

不适合谁：没有风险承受能力的新手（自主交易代理意味着真实资金暴露在策略错误与 API 风险下）；不理解「AI 决策可能出错」的人； jurisdictions 禁止预测市场/加密合约交易的地区用户。

准备工作

1. 运行环境：Node.js ≥ 22（README 徽章要求）、约 2GB 内存的常驻机器（VPS/家庭服务器均可）
2. API keys：Anthropic API key（Claude 是决策核心）；各交易所/市场的 API key（按你要交易的市场配置）
3. 钱包：Solana/EVM 钱包私钥（走链上交易时）；强烈建议用独立小金额热钱包
4. 消息平台：Telegram Bot token（最常用控制台）或其他 20 个平台之一
5. 时间预算：安装配置 30-60 分钟；小额实盘试跑建议至少观察 1-2 周
6. 前置知识：TypeScript/Node 基础、交易所 API 概念、订单类型与滑点、预测市场机制（Polymarket/Kalshi 的订单簿）

替代方案：若不想自托管，Polymarket 官方界面 + 手动交易是最简替代；想要框架级多市场编排可看 Hyperliquid 官方 SDK 自写策略。

核心用法：五步上手

第 1 步：克隆与安装

git clone https://github.com/alsk1992/CloddsBot.git
cd CloddsBot
npm install

Node ≥ 22 是硬要求（README badge），低版本会在依赖安装或运行时报错。

第 2 步：配置环境

复制 .env.example 为 .env，填入：ANTHROPIC_API_KEY（Claude 决策核心）、交易所 API keys、钱包私钥、Telegram Bot token。私钥只放在本机 .env（已在 .gitignore），绝不明文进代码或截图。

第 3 步：启动并接入控制台

npm run start

在 Telegram 里对你的 Bot 发 /start，确认收到响应——这是「终端 ↔ 控制台」链路成功的判定。README 的 Quick Start 章节有各消息平台的接入说明（共 21 个渠道可选）。

第 4 步：先跑观察模式（纸面交易）

不要直接上真钱。先让 Bot 只扫描不下单（README 的 dry-run/观察配置），在控制台里问它「现在有哪些跨市场价差」，验证它对 Polymarket/Kalshi/永续的报价读取正确、机会计算合理。

第 5 步：小额实盘 + 风控参数

用小金额热钱包开始实盘，配置单笔上限、日亏损上限、最大持仓等风控参数。判定成功标准：一周内无失控订单、汇报清晰、盈亏与你的预期行为一致——再逐步放大金额。

常见踩坑

1. 症状：npm install 失败或启动报版本错误。 根因：Node < 22。解决：用 nvm/fnm 装 Node 22+，README badge 明确要求 node>=22。
2. 症状：Bot 在 Telegram 无响应。 根因：token 填错或未先对 Bot 发 /start 激活。解决：对照 BotFather 的 token 重填，先发 /start 再看日志是否收到消息事件。
3. 症状：预测市场报价与实际订单簿偏差。 根因：Polymarket/Kalshi 各自的 API 限频与数据延迟，跨市场价差计算需要考虑手续费与滑点。解决：开启观察模式核对它读到的报价与官网是否一致，把手续费参数配准。
4. 症状：Claude 决策看起来「上头」（连续开仓）。 根因：LLM 决策无硬性纪律约束时会被对话上下文带偏。解决：严格配置风控参数（单笔/日亏/持仓上限），把 Bot 的自主权限限制在参数框内——这是它设计里「manages risk」的意义，参数不配等于裸奔。
5. 症状：钱包资产异常或担心私钥安全。 根因：私钥暴露面过大。解决：永远用独立小额热钱包；机器装 fail2ban/防火墙；发现异常立即撤资换钥。自托管不等于自动安全。
6. 症状：永续合约仓位被强平。 根因：杠杆 + AI 自主加仓叠加。解决：初期禁用高杠杆，设置保证金告警阈值，让 Bot 在控制台主动推送保证金状态。

常见问题 FAQ

Q1: 它和 TradingAgents（多 Agent 交易分析框架）有什么区别？

A: TradingAgents 侧重多角色 Agent 对交易的分析与研究（输出观点），CloddsBot 是执行型自主代理——直接连交易所下单、管理仓位与风险，覆盖预测市场 + 加密 + 合约的真实执行链路，且带 21 平台消息控制台。

Q2: 需要多少启动资金？

A: 仓库本身免费（MIT）。运行成本：Anthropic API 按 Claude 用量计费（自主扫描模式建议关注 token 消耗）+ 服务器 + 交易本金。交易本金强烈建议从「亏光也不心疼」的量级开始。

Q3: 用的是哪个 Claude 模型？决策可靠吗？

A: README 未锁定单一模型，走 Anthropic API 可配置。可靠性必须靠观察模式验证 + 风控参数硬约束保证——LLM 决策没有回测保证，历史表现不预示未来。本站未实测其真实交易收益（未实测声明）。

Q4: 支持中文交互吗？

A: 控制台对话走 Claude，自然语言中文可用；但文档与配置项为英文，README 为英文原文。

Q5: 出了问题（错误下单）谁负责？

A: 开源 MIT 协议无任何担保，风险自担。这是自托管自主交易代理的固有属性——配置风控、小额试跑、持续监控是用户自己的责任。

参考链接

• GitHub 仓库 alsk1992/CloddsBot
• 官网 cloddsbot.com
• Polymarket / Kalshi — 支持的预测市场
• Anthropic API 文档

本文章基于公开资料整理，AI 辅助生成，独立实测与数据核验日期 2026-09-29。交易类工具涉及真实资金风险，本文不构成投资建议。