openmm-exchange-setup

name: openmm-exchange-setup version: 0.1.0 description: "配置 OpenMM 交换 API 凭据的逐步指南。" tags: [openmm, setup, exchanges, configuration] metadata: openclaw: emoji: "🔑" requires: bins: [openmm] install: - kind: node package: "@3rd-eye-labs/openmm" bins: [openmm]

OpenMM交易所设置

本指南用于帮助您在OpenMM中配置交易所API凭据。

使用场景

• 首次设置OpenMM时
• 添加新的交易所时
• 解决连接问题时

支持的交易所

设置流程

第1步：创建API密钥

引导用户访问交易所的API管理页面：

MEXC:    https://www.mexc.com/ucenter/api
Gate.io: https://www.gate.io/myaccount/apikeys
Kraken:  https://www.kraken.com/u/security/api
Bitget:  https://www.bitget.com/account/newapi

第2步：配置权限

各交易所所需的权限：

MEXC:

• 启用现货交易
• 允许读取数据
• 禁用提款功能（出于安全考虑）
• 建议使用IP白名单

Gate.io:

• 现货交易
• 读取现货交易数据
• 无提款权限
• 建议使用IP白名单

Kraken:

• 查询资金
• 查询未成交订单和交易记录
• 创建和修改订单
• 无提款权限

Bitget:

• 进行交易
• 仅允许读取数据
• 无转账权限
• 请注意：密码短语在创建API密钥时已设置

第3步：设置环境变量

OpenMM使用环境变量来存储凭据。请将它们添加到.env文件中，或在shell中导出这些变量：

# MEXC
export MEXC_API_KEY="your_mexc_api_key"
export MEXC_SECRET="your_mexc_secret_key"

# Gate.io
export GATEIO_API_KEY="your_gateio_api_key"
export GATEIO_SECRET="your_gateio_secret_key"

# Bitget (requires passphrase)
export BITGET_API_KEY="your_bitget_api_key"
export BITGET_SECRET="your_bitget_secret_key"
export BITGET_PASSPHRASE="your_bitget_passphrase"

# Kraken
export KRAKEN_API_KEY="your_kraken_api_key"
export KRAKEN_SECRET="your_kraken_secret_key"

或者，在项目根目录下创建一个.env文件：

MEXC_API_KEY=your_mexc_api_key
MEXC_SECRET=your_mexc_secret_key
GATEIO_API_KEY=your_gateio_api_key
GATEIO_SECRET=your_gateio_secret_key
BITGET_API_KEY=your_bitget_api_key
BITGET_SECRET=your_bitget_secret_key
BITGET_PASSPHRASE=your_bitget_passphrase
KRAKEN_API_KEY=your_kraken_api_key
KRAKEN_SECRET=your_kraken_secret_key

第4步：验证连接

通过检查账户余额来测试凭据是否有效：

# MEXC
openmm balance --exchange mexc

# Gate.io
openmm balance --exchange gateio

# Bitget
openmm balance --exchange bitget

# Kraken
openmm balance --exchange kraken

第5步：测试市场数据

确认可以访问市场数据：

openmm ticker --exchange mexc --symbol BTC/USDT
openmm orderbook --exchange kraken --symbol ADA/EUR --limit 5

MCP服务器设置

若要将OpenMM用作MCP服务器，请将其配置添加到您的MCP客户端配置文件中：

{
  "mcpServers": {
    "openmm": {
      "command": "npx",
      "args": ["@qbtlabs/openmm-mcp"],
      "env": {
        "MEXC_API_KEY": "your_key",
        "MEXC_SECRET": "your_secret",
        "KRAKEN_API_KEY": "your_key",
        "KRAKEN_SECRET": "your_secret"
      }
    }
  }
}

请仅包含您需要使用的交易所的环境变量。

故障排除

“未找到凭据”

• 确认环境变量已正确设置：echo $MEXC_API_KEY
• 检查.env文件是否位于正确的目录中
• 确保变量名称完全匹配（例如：MEXC_SECRET而不是MEXC_SECRET_KEY）

“凭据验证失败”（Bitget）

• 确认BITGET_API_KEY、BITGET_SECRET和BITGET_PASSPHRASE这三个变量都已设置
• 密码短语在创建Bitget API密钥时已设置

“身份验证失败”（Kraken）

• 确认KRAKEN_API_KEY和KRAKEN_SECRET已设置
• 检查Kraken API设置页面上的权限信息

“时间戳错误”

• 系统时钟可能不同步
• 运行命令：sudo ntpdate time.google.com

“请求频率受限”

• 降低请求频率
• 查阅交易所的请求频率限制说明

安全最佳实践

1. 切勿启用提款功能——交易过程中通常不需要提款
2. 使用IP白名单——仅允许来自您服务器的IP地址进行访问
3. 切勿提交.env文件——将其添加到.gitignore文件中
4. 定期更换API密钥——建议每90天更换一次
5. 为测试环境和生产环境使用不同的API密钥——避免混淆测试网和主网的密钥