AI Market Maker: 面向加密货币对冲基金的智能体交易系统

项目概览 | 快速开始 | 设置详情 | 贡献指南 | 许可证

项目概览

AI-Market-Maker 是一个开源的、对冲基金风格的加密货币交易技术栈。它结合了专家 AI 交易智能体（作为交易台）、LangGraph 编排层、执行前的强硬风险防御（Risk Guard）否决机制，以及量化级别的纪律，包括集中式策略、基准持有收益对比和全链路可追溯性。

它的设计目标是打造一个小型的专业交易公司系统，而不仅仅是又一个普通机器人。

核心功能

• 具有清晰业务职责的多智能体工作流
• 严格的 Risk Guard，可否决任何交易请求
• 包含内置基准测试（超额收益 vs 持有收益）的量化风格回测
• 统一的智能体接口与治理层
• OpenClaw 就绪包装 (SKILL.md + manifest.json + 专用运行器)
• 支持 Binance Testnet 模拟交易 + 丰富的本地回测器；通过 OMS 层支持 Hyperliquid 适配器（dry-run 模式）
• 用于遥测和追踪的现代 Web 仪表盘
• 简洁的配置（JSON 策略文件 + 仅用于密钥的环境变量）

---

项目目标

当前阶段（交易模式） 获取实时数据，通过专家智能体生成信号，运行投资组合逻辑，执行 Risk Guard 否决检查，并在 Binance Testnet 上执行。

近期目标 完整的头寸生命周期管理、多资产投资组合管理、可配置杠杆以及改进的多空头操作处理。

长期目标 更深度的智能体能力、更好的 OpenClaw 集成，并支持更多的执行场所和数据源。

---

为什么该项目与众不同

• 真正的风险治理 — Risk Guard 拥有最终否决权，而不仅仅是记录日志。
• 量化纪律 — 每次回测都包含清晰的基准对比，绝不含糊。
• 标准化智能体 — 所有智能体遵循相同的 输入 → 处理 → 输出 → 反馈 契约。
• 透明度 — 提供完整的追踪、推理日志和事件账本。
• 可扩展性 — 基于 LangGraph 构建，拥有清晰的角色定义和 OpenClaw 技能包装。

系统架构

工作流模拟了一家小型对冲基金：

1. 研究部 — 市场扫描、技术分析、统计 Alpha、市场情绪
2. Alpha 生成 — 信号合成与投资逻辑构建
3. 投资组合管理 — 风险加权分配与交易规模确定
4. 风险防御 (Risk Guard) — 最终安全层（拥有全权否决能力）
5. 执行 — 仅在 Risk Guard 批准后才执行操作

查看 docs/langgraph-workflow.md 获取完整的图状态、节点、边和路由逻辑说明。

---

快速开始

# 1. 克隆仓库
git clone https://github.com/olaxbt/ai-market-maker.git
cd ai-market-maker

# 2. 安装依赖
pip install uv

# 3. 首先安装 TA-Lib（请参见 Prerequisites 部分的安装选项）
# 使用 Conda 安装示例（推荐用于 OpenClaw 环境）：
# wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
# bash Miniconda3-latest-Linux-x86_64.sh -b -p $HOME/miniconda
# source $HOME/miniconda/bin/activate
# conda install -y ta-lib -c conda-forge

# 4. 安装 Python 依赖
uv sync --extra dev
uv run pre-commit install

# 3. 设置环境变量
cp .env.example .env
# 使用你的 API 密钥编辑 .env 文件 (建议使用 Binance Testnet + OpenAI)
#
# Docker 栈必需项:
#   DATABASE_URL=postgresql+psycopg://aimm:aimm@db:5432/aimm
#   AIMM_AUTH_SECRET=

# 4. 运行平台栈（推荐）：DB + API + worker + web
# 需要 Docker Desktop / docker compose
#
docker compose -f docker-compose.prod.yml up --build -d

# 5. 运行数据库迁移（首次运行及 Schema 变更后执行）
docker compose -f docker-compose.prod.yml run --rm api alembic upgrade