TradeMemory Protocol

📊 AI 交易记忆与策略进化系统

MCP 协议驱动的 AI 交易记忆系统,自动记录 MT5/外汇交易、发现行为模式并生成策略调整建议,支持三层记忆架构实现从原始交易到策略优化的闭环。

收藏
3.8k
安装
1.1k
版本
0.3.2
CLS 安全性认证2026-08-03
点击查看完整报告 >

使用说明

核心用法

TradeMemory 是专为 MT5、Binance、Alpaca 等交易平台设计的 AI 交易记忆系统,通过 MCP(Model Context Protocol)为 AI Agent 提供持久化的交易记忆能力。系统支持两种主要使用模式:手动记录模式通过自然语言指令记录交易详情(如"记录我的 XAUUSD 多头交易,入场 2847,出场 2855,盈利 $40");自动同步模式则通过 mt5_sync.py 脚本每 60 秒自动拉取 MT5 已平仓交易,实现零侵入的 EA 集成。

核心功能围绕四大 MCP 工具展开:store_trade_memory 存储交易决策的完整上下文(品种、方向、仓位、策略、市场条件、置信度、反思);recall_similar_trades 按品种、时间、策略等维度检索历史交易用于模式匹配;get_strategy_performance 聚合各策略的胜率、盈亏比、最大回撤等关键指标;get_trade_reflection 提供单笔交易的深度复盘,包含入场逻辑、出场理由、盈亏分析和评分。

三层记忆架构

系统的核心创新在于 L1-L2-L3 三层记忆架构:L1(热层)存储原始交易数据,包含 15+ 维度完整上下文;L2(温层)由每日运行的 Reflection 引擎自动发现模式,如不同时段胜率差异(伦敦盘 78% vs 亚盘 31%)、策略边缘性对比、置信度-收益相关性、回撤序列特征等;L3(冷层)则基于 L2 发现生成规则化的策略调整,包括自动禁用亏损策略、为验证边缘性增加仓位、趋势市场中限制交易方向、基于历史相关性调整置信度阈值。

定时复盘机制

通过 OpenClaw 的 cron 功能可配置日/周/月自动复盘:每日 23:55 生成当日交易摘要,每周日对比本周与上周表现,每月初总结策略变化与调整建议。复盘内容可通过 WhatsApp、Slack 等渠道推送。

显著优点

1. 零侵入集成:MT5 自动同步无需修改 EA 代码,通过独立 Python 脚本轮询实现
2. 结构化反思:突破传统交易日记的文本记录,将"反思"解构为可查询、可分析的维度

3. 行为模式发现:系统能识别交易者自身未察觉的行为偏误,如特定时段过度自信、某类行情下的重复错误

4. 策略进化闭环:从原始数据→模式发现→自动调参,形成完整的策略优化循环

5. 灵活部署:本地 SQLite 存储保障隐私,可选 Claude API 增强分析深度,也可纯规则运行

潜在缺点与局限性

1. 数据孤岛风险:当前版本为单机部署,多设备交易需手动同步数据库文件;跨账户分析依赖即将到来的托管版本
2. AI 依赖局限:无 ANTHROPIC_API_KEY 时仅能用规则引擎,模式发现深度受限;而启用 LLM 则产生额外 API 成本

3. MT5 绑定较重:自动同步功能对 MT5 Python API 有依赖,其他平台需通过手动记录或自定义脚本接入

4. 策略调整偏保守:L3 层的自动调参以"禁用"和"微调"为主,缺乏更激进的策略重构建议

5. 回测缺失:系统专注于实盘记录与反思,不包含历史数据回测功能,无法验证"如果按调整后的策略执行"的假设收益

适合人群

  • 系统化交易者:已有明确策略框架,需要数据驱动的持续优化
  • MT5 量化用户:使用 EA 但缺乏交易日志分析工具
  • 交易心理成长型选手:希望从"凭感觉"转向"凭数据"识别自身行为模式
  • 多策略管理者:同时运行多个策略,需要横向对比与动态权重调整
  • 纪律性复盘困难者:难以坚持手写交易日记,需要自动化工具降低复盘门槛

常规风险

1. 凭证管理:MT5 密码以明文存储于本地 .env 文件,虽声明不向外传输,但仍需确保文件系统权限安全
2. 本地 API 暴露:默认监听 localhost:8000,若暴露至公网可能导致交易数据泄露

3. 过度拟合风险:自动化模式发现可能捕捉到样本内的统计噪音,而非真实边缘性

4. LLM 幻觉:AI 反思可能生成看似合理但缺乏数据支撑的"洞察",需人工复核关键结论

5. 策略调整滞后:基于历史数据的自动调参,在市场环境突变时可能产生逆向效果

技术可靠性

项目基于 MCP 标准协议,具备 203 个测试用例,MIT 开源协议,GitHub 仓库公开可审计。依赖均为 Python 生态主流库(MetaTrader5、requests、python-dotenv),无编译型依赖或系统级权限需求。

安全解读

核心用法

TradeMemory 是一套专为交易者设计的持久化记忆系统,采用独特的三层架构(原始交易层→模式发现层→策略调整层)帮助用户系统化地记录、分析与优化交易行为。

基础记录功能:用户可通过自然语言指令让 AI 代理记录每笔交易的完整上下文,包括交易品种、方向、仓位、进出场价格、盈亏、策略名称、市场环境描述及事后反思。数据默认存储于本地 SQLite 数据库,支持 MT5、Binance、Alpaca 等多平台接入。

MT5 自动同步:Windows 用户可配置 MT5 凭证,实现每 60 秒自动拉取已平仓交易,无需修改现有 EA。Linux/macOS 用户需通过手动导入或 CSV 方式同步。

AI 复盘引擎:调用 Anthropic Claude API 对交易数据进行智能分析,自动发现时段性交易优势(如伦敦时段胜率 78% 对比亚洲时段 31%)、策略盈亏表现差异、信心-结果相关性等深层模式。未配置 API 密钥时,系统回退至基于规则的本地分析。

策略自动调整:基于 L2 层发现的模式,系统生成规则化调仓建议,包括自动停用亏损策略、对验证边缘增仓、趋势市场限制反向交易、动态调整信心阈值等。

定时复盘:支持配置 cron 任务实现每日、每周、每月自动复盘,可推送至 WhatsApp 或 Slack 等通知渠道。

显著优点

架构设计先进:三层记忆架构(热数据→温数据→冷策略)清晰分离了原始记录、模式挖掘与策略优化,既保证查询效率,又支持长期学习进化。

平台兼容性强:核心功能纯本地运行,不绑定特定经纪商;MT5 同步作为可选模块,支持 Binance、Alpaca 等替代数据源。

隐私保护到位:所有交易数据本地存储,敏感凭证(MT5 密码、API Key)仅存于用户设备 .env 文件,不传输至云端(除非用户主动配置远程端点或启用 Claude API)。

透明度与可控性:网络行为完全透明,无隐藏的后台请求;权限需求最小化,不修改系统文件,无需管理员权限。

开源可审计:MIT 许可证,GitHub 公开源代码,203 项测试覆盖,供应链安全可验证。

潜在缺点与局限性

平台限制:MT5 Python API 仅限 Windows,非 Windows 用户无法享受自动同步便利,需依赖手动输入或 CSV 导入。

AI 功能依赖外部 API:高级复盘功能需要 Anthropic API 密钥,产生额外成本;无密钥时仅能用规则化分析,智能化程度下降。

金融数据敏感性:交易记录属于高度敏感的个人财务信息,虽然本地存储降低了泄露风险,但用户仍需自行承担设备安全责任。

策略调整建议非交易指令:系统生成的风险调整建议需用户手动确认执行,不会自动下单,对期望全自动交易的用户可能造成体验落差。

托管版本尚未上线:当前纯本地部署,未来计划的云端版本(mcp.mnemox.ai)功能与定价待定,长期使用路径存在不确定性。

适合的目标群体

系统化交易者:已建立明确交易策略、需要数据驱动优化的严肃交易者,尤其是使用 MT5 的 forex/CFD 交易者。

交易日记习惯者:希望从手动交易记录升级为智能分析,减少复盘时间成本的用户。

策略开发者:需要多账户、多策略绩效对比,验证策略边缘有效性的量化交易研究者。

AI 辅助决策接受者:愿意使用 Claude 等 LLM 进行行为模式分析,并据此调整交易纪律的用户。

隐私优先用户:对将完整交易历史上传至第三方云服务持谨慎态度,偏好本地数据主权的交易者。

使用风险说明

凭证管理风险:MT5 账户密码和 Anthropic API Key 以明文形式存储于 .env 文件,存在被误提交至版本控制、文件权限配置不当或备份泄露的风险。建议严格配置 .gitignore、设置 600 文件权限,并考虑使用系统密钥管理服务。

远程端点误配风险:TRADEMEMORY_API 可配置为远程 URL,若误配不受信任端点可能导致交易数据泄露。建议仅使用自托管端点,并关注未来版本可能增加的端点白名单验证。

交易建议免责声明:系统生成的策略调整建议基于历史数据分析,不构成投资建议,用户需自行承担交易决策风险。

依赖项供应链风险:安装时从 PyPI 和 GitHub 拉取依赖,虽均为官方源,但仍建议定期审计依赖包完整性。

性能与数据规模:长期运行后 SQLite 数据库可能增长,极端高频交易者需关注查询性能,未来可能需要迁移至专用数据库。

TradeMemory Protocol 内容

scripts文件夹
手动下载zip · 7.9 kB
install.shtext/x-shellscript
请选择文件