ClawHub
Security warning — review recommended

ClawHub Security found sensitive or high-impact capabilities. Review the scan results before using.

Mt4 Trader

MT4 Trader Bridge enables Python to MT4 EA communication via files for trading, order management, risk control, and grid strategies without extra dependencies.

Audits

Warn
ClawScanWarn

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install mt4-trader

MT4 智能交易桥 · 量化自动交易系统

MT4 智能交易桥。通过文件 I/O 与 MT4 EA 通信，无需 DLL 或额外依赖。支持 OpenClaw（小龙虾 AI Agent）通过微信 / 飞书 / Telegram 等渠道直接操作 MT4 交易。

关键词：MT4, MetaTrader 4, 外汇交易, Python交易, 算法交易, 自动交易, 网格策略, 支撑压力位, ATR止损, 移动止损, 黄金交易, 原油交易, 比特币交易, OpenClaw, 小龙虾, AI交易助手, 微信操作MT4, 飞书操作MT4

🎯 自然语言交互示例

📱 微信/飞书/Telegram 口语化命令

你说MT4 做
黄金多少钱返回 XAUUSD.s 实时报价
买黄金 0.05 手市价买入 0.05 手
平仓 95832104平掉指定订单
全平平掉所有持仓
查持仓列出当前所有持仓
设置止损 95832104 4500设置止损位
启动黄金网格启动黄金网格策略
获取MT4 黄金的1小时K线数据进行行情分析将会自动帮您分析好黄金后市走向以及给出交易方案

文件结构

mt4-trader/
├── SKILL.md                         # 本使用说明
├── mql4/                            # MT4 EA 编译文件（.ex4，由脚本生成）
│   [用户手动下载 .ex4 文件放到此目录]
├── scripts/                         # Python 脚本
│   ├── mt4_client.py                # Python 交易客户端（核心）
│   ├── deploy_ex4.py                # EA 部署指引（显示下载链接和安装步骤）
│   ├── alert_commands.py            # 价格预警命令行工具
│   ├── position_summary.py          # 持仓汇总（命令行输出）
│   ├── position_summary_cron.py     # 持仓汇总（定时推送）
│   ├── sr_strategy.py               # 支撑压力位策略编排
│   └── summary_utils.py             # 持仓汇总工具模块
└── references/
    └── api_docs.md                  # 完整 API 参考文档

安装步骤（详细版）

第一步：找到你的 MT4 数据目录

每个 MT4 安装实例都有一个专属的数据目录，格式为：

%APPDATA%\MetaQuotes\Terminal\<32位随机ID>

例如：C:\Users\Administrator\AppData\Roaming\MetaQuotes\Terminal\ABC123...

怎么找？在 MT4 中按 F7 打开 MetaEditor（代码编辑器），点击菜单 文件 → 打开数据文件夹，弹出的路径就是你的 MT4 数据目录。

第二步：确认 MT4 安装目录

EA 文件需要部署到两个不同的目录：

EA 文件目标目录说明
mt4_bridge.ex4MT4安装目录\MQL4\Experts\主程序 EA（必须）
芝麻网格V2.ex4MT4安装目录\MQL4\Experts\网格策略 EA（可选）
tools2.3.ex4MT4安装目录\MQL4\Libraries\网格策略依赖库（网格必须，不是 Experts！）

⚠️ Libraries 目录与 Experts、Indicators 同级，不是 Experts 的子目录。

典型路径结构：

C:\Program Files (x86)\EBC Financial Group Cayman MT4 Terminal\MQL4\
├── Experts\           ← mt4_bridge.ex4, 芝麻网格V2.ex4 放这里
│   ├── mt4_bridge.ex4
│   └── 芝麻网格V2.ex4
├── Libraries\         ← tools2.3.ex4 放这里（与 Experts 同级！）
│   └── tools2.3.ex4
├── Indicators\
└── Scripts\

第三步：下载 .ex4 文件

从 Gitee 仓库下载 3 个 .ex4 文件：

https://gitee.com/3603317/skill-plugin/tree/master/mt4

需要下载的文件：

文件说明
mt4_bridge.ex4主程序 EA（必选）
芝麻网格V2.ex4网格策略 EA（可选）
tools2.3.ex4网格策略依赖库（选网格则必选）

点击文件 → 点右上角 Raw 按钮即可保存到本地。

下载后放入 skills\mt4-trader\mql4\ 目录，然后运行以下命令一键部署到 MT4：

cd scripts\
python deploy_ex4.py deploy

第四步：在 MT4 中挂载 EA

挂载 mt4_bridge（核心，必须操作）：

  1. 打开 MT4，按 Ctrl+N 打开左侧"导航器"面板
  2. 展开"EA 交易"列表，找到 mt4_bridge
  3. 用鼠标左键拖拽到任意品种图表上（推荐 XAUUSD.s 或主流品种）
  4. 弹出 EA 属性对话框 → 选项卡"常用"：
    • 允许实时交易 → ✅ 勾选（必须！）
    • 允许导入 DLL → ✅ 勾选
    • 确认取消"手动交易禁止" 等限制
  5. 点"确定"关闭对话框
  6. 图表右上角显示一个 EA 图标：
    • 😊 绿色笑脸 → ✅ 正常工作中
    • 😢 哭脸或灰脸 → 检查下面"第五步"的自动交易按钮
  7. 右键图表 → 属性 → 常用 中可修改 EA 输入参数（可选）

可选：挂载芝麻网格 EA：

  1. 将 芝麻网格V2 EA 拖到需要跑网格的品种图表上（如 XAUUSD.s、XTIUSD.s）
  2. 勾选"允许实时交易"
  3. 确认 tools2.3.ex4 已放在 Libraries\ 目录中，否则网格 EA 无法运行

多图表挂载（重要）：

  • mt4_bridge EA 可以挂载在多个品种的图表上（例如黄金一个图表、原油一个图表）
  • 每个 EA 实例自动通过品种专属请求文件区分，不会互相干扰
  • Python 客户端传了 symbol 参数后，会自动路由到对应的品种请求文件

第五步：开启自动交易

这是新手最容易忽略的一步！

  1. 在 MT4 工具栏上方找到 "自动交易"按钮（一个黄色播放 ▶️ 图标）
  2. 如果它是 灰色 的 → 点击一下，变成 绿色 ✅
  3. 此时所有已挂载的 EA 图标都应变成 绿色笑脸 😊
  4. 如果某个 EA 还是哭脸，右键该 EA 图标 → "属性" → 勾选"允许实时交易"

💡 每次重启 MT4 后，自动交易按钮默认为关闭状态，需要手动开启。 建议在 MT4 设置中勾选"启动时启用自动交易"。

第六步：验证部署是否成功

方法一：脚本检查

cd scripts\
python mt4_client.py

如果看到类似下面的交互菜单，说明通信正常：

=== MT4 交易助手 ===
1. 获取报价  2. 查询持仓  3. 交易  4. 网格策略
请输入指令：

方法二：Python 代码验证

from mt4_client import MT4Client
client = MT4Client()

# 获取账户信息（确认通信正常）
info = client.get_account_info()
print(info)  # 应该看到余额、净值、可用保证金

# 获取实时报价
price = client.get_price("XAUUSD.s")
print(price) # 应该看到 bid/ask 价格

如果返回 "MT4 超时未响应"：

  • MT4 在运行吗？→ 打开 MT4
  • EA 挂载了吗？→ 图表上有没有 EA 图标
  • 自动交易开了吗？→ 工具栏自动交易按钮是绿色吗
  • EA 属性中"允许实时交易"勾了吗？→ 右键 EA 图标检查

核心 Python 方法

from mt4_client import MT4Client
client = MT4Client()

# === 行情 ===
client.get_price("XAUUSD.s")             # 获取实时报价（bid/ask）
client.get_positions()                    # 查询持仓列表
client.get_account_info()                 # 账户余额/净值/保证金
client.get_history(7)                     # 历史订单（最近 7 天）

# === 交易 ===
client.buy(symbol="XAUUSD.s", lots=0.03)  # 市价买入 0.03 手
client.sell(symbol="XAUUSD.s", lots=0.03) # 市价卖出 0.03 手
client.close(ticket=123456)               # 平指定订单
client.close_all()                        # 一键全平
client.partial_close(ticket=123456, lots=0.02) # 部分平仓

# === 止损止盈 ===
client.set_sl(ticket=123456, sl=75000)          # 设置止损
client.set_tp(ticket=123456, tp=80000)          # 设置止盈
client.modify_order(ticket=123456, sl=75000, tp=80000) # 同时修改
client.auto_sl(ticket=123456, risk_percent=2.0) # 按账户 2% 风险自动止损
client.atr_sl(ticket=123456, period=14, multiplier=2.0) # ATR 止损
client.trailing_stop(ticket=123456, distance=300) # 移动止损（300 点间距）

# === 平所有多单/空单 ===
client.close_all_buy()                     # 平所有多单
client.close_all_sell()                    # 平所有空单
client.close_profit()                      # 平所有盈利单
client.close_loss()                        # 平所有亏损单

# === 挂单 ===
client.buy_limit(symbol="XAUUSD.s", lots=0.03, price=4500.0)  # 限价买入
client.sell_limit(symbol="XAUUSD.s", lots=0.03, price=4600.0) # 限价卖出
client.buy_stop(symbol="XAUUSD.s", lots=0.03, price=4700.0)   # 买入止损（突破追涨）
client.sell_stop(symbol="XAUUSD.s", lots=0.03, price=4500.0)  # 卖出止损（破位追空）
client.get_pending_orders()                # 查询当前挂单
client.cancel_pending(ticket=123456)       # 取消挂单

# === OCO 订单（二选一挂单） ===
client.oco_order(symbol="XAUUSD.s", lots=0.03,
    order1={"type": "buy_stop",  "price": 77000, "sl": 76500},
    order2={"type": "sell_stop", "price": 76000, "sl": 76500}
)

# === 手数计算 ===
client.calc_lots(symbol="XAUUSD.s", risk_percent=1.0, sl_distance=5.0)
# 1% 风险，止损 5 美元 → 返回建议手数

# === K 线数据（量化分析用） ===
client.get_klines(symbol="XAUUSD.s", timeframe="H1", count=20)   # H1 最近 20 根
client.get_klines(symbol="XAUUSD.s", timeframe="M15", count=100) # M15 最近 100 根
client.get_klines(symbol="XAUUSD.s", timeframe="D1", count=30)   # 最近 30 根日线

# === 支撑压力位 ===
client.get_sr_levels(symbol="XAUUSD.s")      # 获取支撑压力位
client.draw_sr_levels(symbol="XAUUSD.s")     # 在图表上画出支撑压力位线
client.clear_chart_objects(symbol="XAUUSD.s")  # 清除图表上所有对象
client.draw_hline(symbol="XAUUSD.s", name="R1", price=4750)  # 画自定义水平线
client.clear_hline(symbol="XAUUSD.s", prefix="HL_")  # 按前缀删除水平线

⚠️ 重要：使用关键字参数！ 所有交易方法（buy/sell/close/set_sl 等）必须使用关键字参数传参：

# ✅ 正确
client.buy(symbol="XAUUSD.s", lots=0.03)
client.set_sl(ticket=123456, sl=75000)

# ❌ 错误——按位置传参可能会导致 order 4106（交易被禁用）
client.buy(0.03, "XAUUSD.s")      # 顺序可能不对！

网格策略（芝麻网格 EA）

命令说明
client.grid_start(symbol="XAUUSD.s")启动网格
client.grid_stop(symbol="XAUUSD.s")停止网格（不再开新单）
client.grid_close_all(symbol="XAUUSD.s")平掉所有网格持仓单
client.grid_status(symbol="XAUUSD.s")查询网格运行状态
client.grid_set_sl_tp(symbol="XAUUSD.s")批量设置网格单的止损止盈

⚠️ 平网格仓必须按以下顺序分两步执行：

client.grid_stop(symbol="XAUUSD.s")        # 第一步：停止网格
client.grid_close_all(symbol="XAUUSD.s")   # 第二步：平掉所有网格单

不可直接用 close_all() 平网格单。close_all 命令会拒绝 magic=777777（网格单）。 网格单必须走芝麻网格 EA 自己的关闭通道。

价格预警（可选）

cd scripts\

python alert_commands.py profit 20        # 总盈利达到 $20 时提醒
python alert_commands.py above 77000      # BTC 突破 77000 时提醒
python alert_commands.py below 75000      # BTC 跌破 75000 时提醒
python alert_commands.py list             # 查看当前所有预警
python alert_commands.py clear            # 清除所有预警
python alert_commands.py cancel 3        # 取消第 3 号预警

品种代码

品种代码说明
黄金XAUUSD.sXAUUSD 后缀 .s 是部分经纪商标准
比特币BTCUSD部分平台为 BTCUSD.pro
原油XTIUSD.s美国原油（WTI）
白银XAGUSD.s现货白银

品种代码精确格式因经纪商而异。如果 get_price 找不到品种，在 MT4 市场报价中右键 → "全部显示"确认准确的品种名。

通信原理

┌──────────┐    JSON 文件     ┌──────────────┐
│  Python   │ ───request────→ │  MT4 EA      │
│  Client   │ ←──response──── │  (on chart)   │
└──────────┘    JSON 文件     └──────────────┘
  • 共享目录：%APPDATA%\MetaQuotes\Terminal\Common\Files\mt4_bridge\
    • 示例：C:\Users\Administrator\AppData\Roaming\MetaQuotes\Terminal\Common\Files\mt4_bridge\
  • 请求文件：request_{品种}.json（如 request_XAUUSD.s.json）
  • 响应文件：response_{品种}.json
  • 协议：JSON over 文件（零 DLL 依赖）
  • 超时：5 秒（Python 客户端默认配置）
  • 多品种支持：多个 EA 实例通过品种专属文件名自动区分

常见问题排查

现象可能原因解决方法
MT4 超时未响应EA 未挂载或自动交易未启动确认图表右上角为绿色笑脸 😊
error 4106（交易禁用）EA 属性中"允许实时交易"未勾选右键 EA → 属性 → 勾选"允许实时交易"
找不到价格（空结果）品种代码不匹配在 MT4 市场报价中确认精确名称
tools2.3 编译报错文件放错了目录确认 tools2.3.ex4 在 MQL4\Libraries\，不是 Experts\
重复下单多个 EA 读同一个请求文件使用 v1.84+ 版本，自动使用品种专属文件
BTC 无法市价交易部分经纪商禁用 BTC 市价单改用 buy_limit()/sell_limit() 限价单
重启 MT4 后 EA 不跑自动交易默认关闭手动点绿色播放按钮，或在设置中勾选"启动时启用"
芝麻网格周末不运行经纪商周末休市正常现象，周一开市自动恢复

交流与反馈

欢迎加入 MT4 自动化技术交流群，一起讨论 MT4 自动交易、Python 量化、EA 开发等话题。

微信搜索：jiaoyibaohe （老码农） 加我好友，备注 MT4 即可拉入群聊。

或进入gitee项目主页，查看群二维码

https://gitee.com/3603317/skill-plugin/tree/master

📱 扫码添加微信好友，备注 MT4 即可拉入技术交流群。 群内可交流：安装问题、使用技巧、功能建议、Bug 反馈。

版本信息

文件版本最后更新
mt4_bridge.ex4v1.862026-05
芝麻网格V2.ex4v1.412026-03
tools2.3.ex4v2.32025-12
mt4_client.pyv1.862026-05-05
deploy_ex4.pyv1.0.72026-05-05

MT4 Trading Bridge · Automated Trading System

MT4 Trading Bridge communicates with MT4 EA via file I/O — zero DLLs, zero extra dependencies. Supports OpenClaw AI Agent to control MT4 trading through WeChat / Feishu / Telegram and other channels.

Keywords: MT4, MetaTrader 4, Forex Trading, Python Trading, Algorithmic Trading, Automated Trading, Grid Strategy, Support & Resistance, ATR Stop Loss, Trailing Stop, Gold Trading, Crude Oil Trading, Bitcoin Trading, OpenClaw, AI Trading Assistant

File Structure

mt4-trader/
├── SKILL.md                         # This documentation
├── mql4/                            # MT4 EA compiled files (.ex4, generated by script)
│   [Manually download .ex4 files here]
├── scripts/                         # Python scripts
│   ├── mt4_client.py                # Python trading client (core)
│   ├── deploy_ex4.py                # EA deployment guide (shows download links & steps)
│   ├── alert_commands.py            # Price alert CLI tool
│   ├── position_summary.py          # Position summary (CLI output)
│   ├── position_summary_cron.py     # Position summary (scheduled push)
│   ├── sr_strategy.py               # Support/Resistance strategy orchestrator
│   └── summary_utils.py             # Position summary utility module
└── references/
    └── api_docs.md                  # Full API reference

Installation

Step 1: Find Your MT4 Data Directory

Each MT4 installation has a unique data directory:

%APPDATA%\MetaQuotes\Terminal\<32-char-random-ID>

How to find it? In MT4, press F7 to open MetaEditor, then click File -> Open Data Folder.

Step 2: Confirm MT4 Directory

EA files go into two directories:

EA FileTarget DirectoryNotes
mt4_bridge.ex4MT4_Install_Dir\MQL4\Experts\Core EA (required)
SesameGridV2.ex4MT4_Install_Dir\MQL4\Experts\Grid strategy EA (optional)
tools2.3.ex4MT4_Install_Dir\MQL4\Libraries\Grid dependency (required if using grid)

Libraries is at the same level as Experts — NOT a subdirectory of Experts.

Step 3: Download .ex4 Files

From Gitee: https://gitee.com/3603317/skill-plugin/tree/master/mt4

Files: mt4_bridge.ex4 (required), SesameGridV2.ex4 (optional), tools2.3.ex4 (grid dependency).

Step 4: Attach EAs in MT4

Drag mt4_bridge onto any chart. In properties -> Common tab: check "Allow live trading" and "Allow DLL imports". Green smiley means working.

Optional: Attach SesameGridV2 on grid-trading charts.

Step 5: Enable Auto Trading

Click the yellow play icon (unicode triangle) on MT4 toolbar to turn it green.

Step 6: Verify

Run: python mt4_client.py

Core Python Methods

from mt4_client import MT4Client
client = MT4Client()

# Market Data
client.get_price("XAUUSD.s")           # Real-time quote
client.get_positions()                 # Open positions
client.get_account_info()              # Account info
client.get_history(7)                  # Order history (7 days)

# Trading
client.buy(symbol="XAUUSD.s", lots=0.03)
client.sell(symbol="XAUUSD.s", lots=0.03)
client.close(ticket=123456)
client.close_all()                     # Close all positions

# SL/TP
client.set_sl(ticket=123456, sl=75000)
client.set_tp(ticket=123456, tp=80000)
client.modify_order(ticket=123456, sl=75000, tp=80000)
client.trailing_stop(ticket=123456, distance=300)

# Pending Orders
client.buy_limit(symbol="XAUUSD.s", lots=0.03, price=4500.0)
client.sell_limit(symbol="XAUUSD.s", lots=0.03, price=4600.0)
client.buy_stop(symbol="XAUUSD.s", lots=0.03, price=4700.0)
client.sell_stop(symbol="XAUUSD.s", lots=0.03, price=4500.0)
client.get_pending_orders()
client.cancel_pending(ticket=123456)

# Kline Data
client.get_klines(symbol="XAUUSD.s", timeframe="H1", count=20)

# Support & Resistance
client.get_sr_levels(symbol="XAUUSD.s")
client.draw_sr_levels(symbol="XAUUSD.s")
client.clear_chart_objects(symbol="XAUUSD.s")  # Clear all chart objects
client.draw_hline(symbol="XAUUSD.s", name="R1", price=4750)  # Draw horizontal line
client.clear_hline(symbol="XAUUSD.s", prefix="HL_")  # Delete lines by prefix

Use keyword arguments for all trading methods!

Grid Strategy

CommandDescription
grid_start(symbol)Start grid
grid_stop(symbol)Stop grid
grid_close_all(symbol)Close grid orders
grid_status(symbol)Check status

For closing grid: call grid_stop() first, then grid_close_all().

Symbol Codes

InstrumentCode
GoldXAUUSD.s
BitcoinBTCUSD
Crude OilXTIUSD.s
SilverXAGUSD.s

Troubleshooting

IssueSolution
MT4 TimeoutEA not attached or auto-trading off
error 4106"Allow live trading" unchecked
Empty price resultWrong symbol code
Duplicate ordersUse v1.84+ for symbol-specific files
BTC market order failsSome brokers disable BTC market orders

Communication & Feedback

Join the MT4 Automated Trading Technical Group to discuss MT4 auto trading, Python quantitative trading, EA development, and more.

Search WeChat: jiaoyibaohe (MT4 Developer) — add me as a friend, note MT4 to join the group.

Click to view Gitee project homepage, group QR code

Scan the QR code to add WeChat friend, note MT4 to join the technical group. Topics: installation issues, usage tips, feature suggestions, bug reports.