# Easy-Deal **Repository Path**: xszyou/easy-deal ## Basic Information - **Project Name**: Easy-Deal - **Description**: 就算有一套完全自动赚钱的工具，你也会经常盯着它。你跟专业交易员对比，差别在于是否看得懂。而EasyDeal 就是解决这个问题的一套框架，提供一组MCP工具，接入 openclaw、Claude Code, Fay等agent后，在MT5交易环境可以协同各种策略工作，监控策略的执行、为你解答各种问题、指导你做出突发处理，甚至直接帮你修改策略代码。 - **Primary Language**: Python - **License**: GPL-3.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 134 - **Forks**: 21 - **Created**: 2022-11-09 - **Last Updated**: 2026-04-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # EasyDeal MT5 智能交易系统 ## 项目概述 就算有一套完全自动赚钱的工具，你也会经常盯着它。你跟专业交易员对比，差别在于是否看得懂。而EasyDeal 就是解决这个问题的一套框架，提供一组MCP工具，接入 openclaw、Claude Code, Fay等agent后，在MT5交易环境可以协同各种策略工作，监控策略的执行、为你解答各种问题、指导你做出突发处理，甚至直接帮你修改策略代码。 - **核心交易端 (EA)**: 由 `GMarket.mq5` (也可以替换成自己的，或者**进群**获取更多)负责，直接在 MT5 终端运行。它执行核心的交易逻辑（双向开仓、马丁格尔策略、风险控制）、提供图形化操作界面 (UI)，并内置了财经日历新闻过滤功能。 - **智能监控端 (MCP Server)**: 由 `easydeal_mcp_server.py` 负责。它作为 AI Agent (如 openclaw、Claude Code, Fay) 的连接器，通过 MCP 协议提供实时的策略状态监控、异常告警、日志分析及一致性校验功能。 这种架构确保了交易的稳定性（EA 独立运行，不受 Python 端影响），同时赋予了系统强大的 AI 扩展能力（通过 MCP 进行自然语言交互和智能风控）。 ## 主要特点 ### 核心策略 (EA) - **双向对冲策略**：同时捕捉多空机会，顺势爬梯止盈，逆势马丁解套。 - **智能风控**： - **新闻过滤**：自动读取财经日历，在重大数据（如非农、利率决议）发布前后暂停加仓。 - **技术指标过滤**：结合 ATR 波动率和布林带偏离度，避免在极端行情下盲目加仓。 - **最大回撤保护**：设定最大浮亏金额，触及阈值自动清仓止损。 - **图形化控制面板 (UI)**： - 实时显示马丁层级、交易方向、ATR/布林带状态及当前盈利。 - 快捷按钮：一键暂停策略、开关马丁功能、强制重载状态。 - **断点续传**：EA 具备自动状态恢复功能，重启 MT5 后可自动识别并接管已有订单。 ### 智能监控 (MCP Server) - **AI Agent 集成**：支持通过 MCP 协议接入 Claude Desktop 或 Fay 数字人，实现"对话式"交易监控。 - **全方位告警**： - **状态异常**：EA 停止运行、终端掉线通知。 - **风险预警**：浮亏比例预警 (30%/50%/70%)、马丁层级过高预警。 - **技术信号**：RSI 超买超卖、MACD 金叉死叉提示。 - **一致性校验**：每日自动比对 EA 交易日志与策略规则，生成执行合规性报告。 - **Web API**：提供 HTTP 接口供其他系统调用。 - **主动修改策略及参数**：若agent需要执行此类操作，通常会先获得主人的允许，代码修改前也先会备份，你也可以让agent恢复过往的版本。（注：目前已经的问题是，修改的代码经常需要人工编译，但大模型常常会认为已经完成了编译工作） # 交易账号注册与MT5安装 - 访问 exness 官网（需要开启 VPN，VPN 不能使用美国、伊朗、朝鲜、欧盟、英国）：https://one.exnessonelink.com/a/r6fx3vgje1 - 点击右上角登录 --> 开立账户 --> 注册 --> 个人专区 - ![image-20251201164439332](images/image-20251201164439332.png) - 我的账户 --> 模拟 --> 交易 --> Meta Trader 5（此处保存好交易账号信息及服务器信息）--> 下载安装 MT5 平台 --> 运行 exness5setup.exe --> 等待安装完成 - ![image-20251201164751516](images/image-20251201164751516.png) - ![image-20251201165907714](images/image-20251201165907714.png) - 运行 MT5 终端 --> 关闭开设账户弹窗 --> 导航栏 --> exness --> 账户 -- 右键 --> 登录到交易账户（注意，此处填写的登录名为上文选择 mt5 交易时记录的那串数字账号，服务器也需注意选择正确） --- # MT5开启算法交易 ![MT5开启算法交易 封面]() ## 前置条件 开始算法交易之前，请确定已经完成MT5的安装及交易账号的注册。 ## 下载mql5源码 首先到网站https://gitee.com/xszyou/easy-deal 下载GMarket.mq5代码文件。 ``` https://gitee.com/xszyou/easy-deal ``` ## 编译mql5源码 ![讲义]() 点击MT5上面菜单栏的文件，选择“打开数据文件夹”，的把刚刚下载的源码文件放到 MQL5\Experts目录下，并双击，此时应该看到如图所示的编辑器。在编辑器上点一下上方的“编写”即完成代码的编译工作。 ## 打开交易窗口 ![讲义]() 此时关闭编辑器，回到MT5，右键点击交易品种“XAUUSD”，选择“图表窗口”，即打开了如图所示图表。 ## 附加EA开启算法交易 ![讲义]() 此时，到导航栏，找到刚才编译的EA，双击附加到图表。附加的时候要注意勾选允许算法交易。确定后，点击上方的算法交易按钮，让算法交易开启起来。成功后你应该能够看到类似作者的窗口交易。注意，在非交易日，一般是节假日，没有行情报价从交易所过来，ea是不会运作的，也不会出现左下角的信息窗和右下角的按钮，附加ea后，等待交易时间到来即可。 --- # easydea fay版搭建教程 ![easydea fay版搭建教程 封面]() ## 前置条件 ![讲义]() 启动MT5，登录到交易服务器，附加ea到xausd的图表并开启算法交易。 ## 安装fay ![讲义]() 首先请到以下网址下载并在宿主机安装fay。在windows系统上安装。 ``` https://qqk9ntwbcit.feishu.cn/wiki/V5qcwlikKiehoYkAPhYcmBPAnAc ``` ## 配置easydeal mcp服务 ![讲义]() 我们打开fay的管理页面，进入mcp栏，依图添加easy deal的mcp服务，easy deal的源码地址也给你们贴出来了，请提前下载并安装好python环境及依赖。 ``` https://gitee.com/xszyou/easy-deal ``` ## mcp启动及验证 ![讲义]() 在fay这里添加好mcp服务后，需要点击连接，等待连接上easy deal的mcp服务器，咱们就可以到fay的聊天页面测试easy deal了。在这之前大家记得启动好mt5,并把算法交易启动。 ## 找出策略的问题 ![讲义]() 我们可以让fay去找到策略的问题，并完成修改。 ## 分析总结情况 ![讲义]() 我们可以让fay去分析运行情况，并做进一步的优化。 --- # easydeal小龙虾版搭建教程 ![easydeal小龙虾版搭建教程 封面]() ## 前置条件 ![讲义]() 启动MT5，登录到交易服务器，附加ea到xausd的图表并开启算法交易。 ## 安装wsl ![讲义]() 首先到windows系统自带的microsoft store搜索并安装ubuntu 24.04。 ``` 首先到windows系统自带的microsoft store搜索并安装ubuntu 24.04。 ``` ## 启动wsl ![讲义]() 接着通过powsell启动wsl ``` 接着通过powsell启动wsl ``` ## 给wsl配置代理 ![讲义]() 宿主机器通过内网为wsl提供代理服务，这里注意宿主机的内网网卡是这个带wsl标识的虚拟网卡。 ``` 宿主机器通过内网为wsl提供代理服务，这里注意宿主机的内网网卡是这个带wsl标识的虚拟网卡。如果vpn还没有生效可以通过以下指令在powershell上执行以更改防火墙到wsl的拦截： New-NetFirewallRule -DisplayName "WSL Proxy 7890" -Direction Inbound -LocalPort 7890 -Protocol TCP -Action Allow ``` ## wsl上安装nodejs 在wsl中输入以下命令，完成nodejs的安装 ``` 1. 更新系统 sudo apt update && sudo apt upgrade -y 2. 安装 Node.js 22 执行以下命令安装 Node.js 22： CoClaw curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs 3. 验证安装 node --version # 应显示 v22.x npm --version ``` ## 安装openclaw 在wsl终端上继续输入以下命令完成openclaw的安装 ``` npm install -g openclaw@latest ``` ## 安装微信通道 请在终端上输入以下命令以安装微信插件。如果安装时出现“Rate limit exceeded”，那是因为安装的人太多，可以等几分钟再试，又或者到github下载源码安装。 ``` openclaw plugins install "@tencent-weixin/openclaw-weixin" ``` ## 启用微信插件 在控制台输入如下命令启用微信插件并重启网关。 ``` openclaw config set plugins.entries.openclaw-weixin.enabled true #启用微信插件 openclaw gateway restart #重启网关 ``` ## 微信扫码登录 ![讲义]() 输入如下命令后微信扫码登录，请放心，此插件为腾讯官方插件，不会封号的。 ``` openclaw channels login --channel openclaw-weixin ``` ## openclaw配置 ![讲义]() 在wsl终端上输入以下命令回车后开始配置openclaw ``` nano ~/.openclaw/openclaw.json ``` ## openclaw配置：llm ![讲义]() 参考如下代码完成agents部分的修改。以及在json第1级下增加models，这里要注意修改base url为你宿主机的ip，这个ip咱们之前配置vpn里已经教过怎么获取了。 ``` agents部分： "agents": { "defaults": { "model": { "primary": "fay/llm" }, "models": { "fay/llm": { "alias": "fay llm" } }, "workspace": "/root/.openclaw/workspace" } } models部分： "models": { "mode": "merge", "providers": { "fay": { "baseUrl": "http://172.23.48.1:5000/v1", "apiKey": "sk-fay", "api": "openai-completions", "models": [ { "id": "llm", "name": "Fay LLM" } ] } } } ``` ## openclaw常用命令 ![讲义]() 至此，openclaw的配置引导已经完成了，以下是openclaw常用的操作命令。 ``` openclaw update #升级 openclaw gateway start # 启动 openclaw gateway stop # 停止 openclaw gateway restart # 重启 openclaw gateway status # 查看状态 openclaw tui # 打开终端聊天界面 openclaw dashboard # 打开 Web 控制台 openclaw status # 查看运行状态 openclaw configure # 重新进入交互式配置向导 openclaw models list # 查看可用模型列表 ``` ## 修改llm配置：安装fay ![讲义]() 首先请到以下网址下载并在宿主机安装fay。在windows系统上安装。 ``` https://qqk9ntwbcit.feishu.cn/wiki/V5qcwlikKiehoYkAPhYcmBPAnAc ``` ## 验证配置 ![讲义]() 使用以下命令重启openclaw，打开webui,并复制连接到宿主机访问测试 ``` openclaw gateway restart # 重启 openclaw dashboard # 打开 Web 控制台 ``` ## 配置easydeal mcp服务 ![讲义]() 我们打开fay的管理页面，进入mcp栏，依图添加easy deal的mcp服务，easy deal的源码地址也给你们贴出来了，请提前下载并安装好python环境及依赖。 ``` https://gitee.com/xszyou/easy-deal ``` ## mcp启动及验证 ![讲义]() 在fay这里添加好mcp服务后，需要点击连接，等待连接上easy deal的mcp服务器，咱们就可以到fay的聊天页面测试easy deal了。在这之前大家记得启动好mt5,并把算法交易启动。 ## openclaw配置mcp服务 ![讲义]() 确定fay连通了easy deal后，openclaw就可以借助fay与mt5通讯了。接下来我们需要在wsl终端上给openclaw配置mcp服务。请输入以下命令完成配置。这里注意，请把ip替换成宿主机ip。 ``` openclaw mcp set faymcp '{"url":"http://172.23.48.1:8765/sse"}' #添加mcp服务 openclaw gateway restart #重启 openclaw mcp show faymcp #检查mcp服务配置 openclaw mcp unset faymcp #删除mcp服务 ``` ## 创建agent ![讲义]() 请通过以下指令创建量化交易相关的agent。其中forex-commander 是交易指挥官，是主 Agent，负责接收所有渠道消息，分类意图，调度子 Agent 执行，汇总结果回复用户。ea-supervisor是EA 监管员，负责监控 MT5 EA 运行状态，检查持仓、账户、交易历史，发现异常主动报告。strategy-analyst是策略分析师，负责分析交易历史数据，评估 EA 策略表现，给出优化建议。risk-guard是风控员，负责检查账户风险敞口、保证金率、单币对集中度，超阈值时报警。 ``` openclaw agents add forex-commander --workspace ~/.openclaw/workspaces/forex-commander --non-interactive openclaw agents add ea-supervisor --workspace ~/.openclaw/workspaces/ea-supervisor --non-interactive openclaw agents add strategy-analyst --workspace ~/.openclaw/workspaces/strategy-analyst --non-interactive openclaw agents add risk-guard --workspace ~/.openclaw/workspaces/risk-guard --non-interactive ``` ## 定义agent ![讲义]() 请在easy deal 仓库里找到openclaw-agent目录，把里面的文件替换到 ~/.openclaw/workspaces 对应的目录，注意，只需要做文件替换，不需要删除已经存在的文件。 ## openclaw.conf中修改agent配置 ![讲义]() 请编辑openclaw.conf完成图上这些agent配置，完成配置文件参考我也放在了easydeal仓库了。 ## 修改bindings、tools和cron配置 ![讲义]() 同样参考图例完成config文件的修改。 ## 完成配置 ![讲义]() 至此，所有配置已经完成，你已经可以和小龙虾去共同完善你的交易策略了，同时也监控着你策略的风险。 # 许可证 本项目采用 GLP 3.0 许可证。 # 联系我们 ![image-20251201173859002](images/wechat.png) 注：群满加 qq467665317