首次运行 MagicTradeBot 前需要配置哪些设置？

首次设置指南

在首次启动 MagicTradeBot 之前，必须配置一小部分强制性和推荐设置，以确保机器人正确启动、安全连接到您的交易所并无错误运行。

MagicTradeBot 设计有安全的默认值，因此您无需预先配置每个文件。以下步骤涵盖了顺利首次运行所需的最低要求和推荐设置。

1. 在 application.yaml 中配置交易所

您必须指定 MagicTradeBot 将连接到哪个交易所。

Exchange:
  Name: "bybit"

支持的交易所：

Binance
Bybit
OKX
Bitget
Hyperliquid

⚠️ 重要： 每个交易所都有严格的持仓模式要求（单向模式 vs 对冲模式）。在运行机器人之前，请确保您的交易所账户已相应配置。

2. 设置交易所 API 凭据（必需）

MagicTradeBot 需要 API 访问权限来下达和管理交易。

推荐方法：环境变量（最佳实践）

强烈建议使用环境变量，尤其是在生产环境中，因为：

API 密钥不存储在文件中
密钥更安全，更容易轮换
环境变量会自动覆盖 YAML 值

按操作系统设置环境变量

✅ Windows (PowerShell)

setx BINANCE_API_KEY "你的_api_密钥"
setx BINANCE_API_SECRET "你的_api_密钥_secret"

设置变量后，重新启动终端（或系统）。

✅ Linux / macOS (终端)

export BINANCE_API_KEY="你的_api_密钥"
export BINANCE_API_SECRET="你的_api_密钥_secret"

要使它们永久生效，请将以下行添加到：

~/.bashrc
~/.zshrc
您的 shell 配置文件

✅ Docker / Docker Compose

environment:
  - BINANCE_API_KEY=${BINANCE_API_KEY}
  - BINANCE_API_SECRET=${BINANCE_API_SECRET}

支持的环境变量名称

示例：

BINANCE_API_KEY, BINANCE_API_SECRET
BYBIT_API_KEY, BYBIT_API_SECRET
OKX_API_KEY, OKX_API_SECRET, OKX_PASSPHRASE
BITGET_API_KEY, BITGET_API_SECRET, BITGET_PASSPHRASE
HYPERLIQUID_PRIVATE_KEY

🔐 切勿在 API 密钥上启用提现权限。

3. 提供您的许可证密钥

在 application.yaml 中：

License:
  Key: "你的_许可证_密钥"

如何获取您的许可证密钥

登录 https://magictradebot.com
转到下载
复制您的许可证密钥

重要说明

没有许可证，机器人仍然可以运行
但是，功能将受到限制
许可证验证在启动时进行

4. 审查基本交易设置 (trading.yaml)

对于首次用户，此文件不需要强制更改。

您可以选择审查或调整：

初始交易金额
默认杠杆
风险限制

如果不确定，请保留默认值 — 它们对于初始运行和演示模式是安全的。

5. 首次交易对和杠杆设置（非常重要）

步骤 1：启用交易对同步（仅首次运行）

在 trading.yaml（或交易对配置文件）中：

SyncSymbolsOnStartup: true

这将：

从交易所获取所有支持的交易对
创建或更新 symbols.json
移除已退市的交易对
添加新上市的交易对

➡️ 运行机器人并等待交易对同步完成
➡️ 监控 symbols.json 文件
➡️ 同步完成后停止机器人

步骤 2：禁用交易对同步（可选）

第一次同步后，您可以设置：

SyncSymbolsOnStartup: false

如果您想要自动更新交易对，请将其永久保留为 true。

步骤 3：一次性杠杆设置（可选但推荐）

如果您希望 MagicTradeBot 自动配置杠杆：

SetLeverageStartup: true
SetMaxLeverage: false

这会将您配置的杠杆（例如 10倍）应用于所有支持的交易对
运行机器人一次
等待几分钟让杠杆更新
然后将两个选项都设置回 false

⚠️ 不要永久启用这些选项，否则杠杆将在每次重新启动时重置。

最大杠杆（剥头皮用例）

如果您想要交易所允许的最大杠杆：

SetMaxLeverage: true

仅使用此选项一次，然后再次禁用。

6. 选择要交易的交易对（可选）

您可以：

交易所有同步的交易对（500+）
或将交易限制为仅选定的交易对

示例：

BTCUSDT
ETHUSDT
SOLUSDT
XRPUSDT

如果交易所有交易对，请保留：

SyncSymbolsOnStartup: true

7. 配置通知（强烈推荐）

在 notification.yaml 中设置至少一个通知渠道：

Telegram
Discord

这使您可以接收：

交易执行
错误和失败
市场观察警报
紧急事件

没有通知也可以运行，但不推荐。

最终检查清单（首次运行）

在启动 MagicTradeBot 之前，请确保：

✅ 在 application.yaml 中选择了交易所
✅ 设置了 API 凭据（最好通过环境变量）
✅ 添加了许可证密钥（可选但推荐）
✅ 为首次运行启用了交易对同步
✅ 可选的杠杆设置已完成一次
✅ 配置了通知渠道

就是这样。
无需其他配置即可安全、正确地开始交易。