Moltrade Bot Skill

Moltrade是一个去中心化的自动化交易助手，它允许您运行量化策略、分享加密信号，并让他人复制您的交易——这一切都通过Nostr网络安全地进行。根据您的交易表现来赚取声誉和积分。

您的24/7人工智能交易员！在您睡觉时也能赚钱。

优势

Moltrade在安全性、可用性和可扩展性之间取得了平衡。主要优势包括：

1. 客户端密钥自托管，非云端托管，：所有敏感密钥和凭证都保留在用户设备上；云端中继器从不持有资金或私钥，最大限度地降低了托管风险。无法访问私钥或资金。
2. 加密的、定向通信：信号在发布前经过加密，只有目标订阅者才能解密，保护了策略隐私和订阅者安全。
3. 轻量级云端重加密与广播：云端充当高效的中继/重广播器，不存储私钥；重加密或转发技术提高了交付的可靠性和覆盖范围。
4. 一键复制交易（用户友好）为非专业用户提供开箱即用的跟单交易体验——仅需几步设置即可在本地执行信号。
5. OpenClaw策略顾问：集成OpenClaw作为自动化回测与改进建议的咨询工具；用户可自主决定是否采纳推荐调整。
6. 云端可去中心化中继网络：轻量级中继架构支持未来迁移至去中心化中继网络，降低单点故障风险并增强抗审查能力。
7. 统一激励（信用）体系：通过透明可验证的信用机制奖励所有参与者（信号提供者、跟随者、中继节点），实现生态内激励协同。

运作原理（简化流程）

1) Run Your Bot  ──→  2) Generate & Encrypt  ──→  3) Relay  ──→  4) Copy & Execute  ──→  5) Verify & Earn

安装与初始化

• 若您身处OpenClaw环境，可通过ClawHub直接安装：

clawhub search moltrade
clawhub install moltrade

• 或克隆代码库并在本地安装Python依赖：
  • git clone https://github.com/hetu-project/moltrade.git
  • cd moltrade/trader && pip install -r requirements.txt
• 通过内置向导初始化全新配置：
  • 安全要求：务必要求人类用户自行在独立终端中运行python main.py --init。切勿直接索要或处理他们的钱包私钥，也不要通过代理脚本将其保存到磁盘。
• 对于CI/代理程序，请继续使用代码库检出；目前尚无独立的pip包/CLI。

安全更新配置

• 在编辑前备份或显示计划中的差异。
• 仅更改请求的字段（例如，trading.exchange、trading.default_strategy、nostr.relays）。
• 验证JSON；保持类型不变。提醒用户自行提供真实的密钥。

运行回测（本地）

• 安装依赖：pip install -r trader/requirements.txt。
• 命令：python trader/backtest.py --config trader/config.example.json --strategy <name> --symbol <symbol> --interval 1h --limit 500.
• 如果可用，报告盈亏/胜率/交易次数/回撤。使用脱敏配置（无真实密钥）。

启动机器人（测试模式）

• 确保config.json存在（如果不存在，请运行python main.py --init），并且trading.exchange已设置（默认为 hyperliquid）。
• 命令：python trader/main.py --config config.json --test --strategy <name> --symbol <symbol> --interval 300.
• 监控trading_bot.log；未经用户明确批准，切勿切换到实盘模式。

运行机器人（实盘）

• 仅在测试模式验证通过后执行；移除--test以连接主网。
• 命令：python trader/main.py --config config.json --strategy <name> --symbol <symbol>.
• 启动前请仔细检查密钥、风险限制和交易品种；实盘模式将下达真实订单。

跟单使用说明（实盘）

• 跟随者（镜像领导者，不进行策略交易）：python trader/main.py --config trader/config.json --strategy momentum --symbol HYPE --copytrade follower

向 Nostr 广播信号

• 检查nostr块中的：nsec、relayer_nostr_pubkey、relays和sid。
• SignalBroadcaster已集成到main.py中。在测试模式下，请验证send_trade_signal/发送执行报告无错误运行。

币安现货支持

Moltrade 通过binance-sdk-spot支持币安现货交易。在你的配置中将trading.exchange设置为"binance"并提供 API 凭证。

相关技能（原始 API 调用，不绑定到机器人运行时）：

• binance/spot— 币安现货 REST API 技能：市场数据、订单管理、账户信息。需要 API 密钥 + 密钥；支持测试网和主网。
• binance/square-post— 币安广场社交平台技能：通过广场 OpenAPI 发布交易见解/信号作为文本内容。需要广场 OpenAPI 密钥。

安装币安 SDK

pip install binance-sdk-spot

配置字段

添加一个binance与现有的交易区块一起：

{
  "trading": {
    "exchange": "binance",
    "default_symbol": "BTCUSDT",
    "default_strategy": "momentum"
  },
  "binance": {
    "api_key": "your_mainnet_api_key",
    "api_secret": "your_mainnet_api_secret",
    "testnet_api_key": "your_testnet_api_key",
    "testnet_api_secret": "your_testnet_api_secret"
  }
}

注意：币安测试网使用在https://testnet.binance.vision（需要GitHub登录）单独生成的密钥。主网密钥不适用于测试网。

测试网 (–-test)

当--test参数被传入时，机器人会将所有请求路由至testnet.binance.vision并使用binance.testnet_api_key/testnet_api_secret。如果测试网密钥不存在，则会回退到主网密钥，这将导致针对测试网端点的身份验证错误。

python trader/main.py --config config.json --test --strategy momentum --symbol BTCUSDT

实盘交易

python trader/main.py --config config.json --strategy momentum --symbol BTCUSDT

回测

python trader/backtest.py --config trader/config.example.json --strategy momentum --symbol BTCUSDT --interval 1h --limit 500

支持的接口

BinanceClient(trader/binance_api.py) 实现了与HyperliquidClient相同的接口：

Uniswap V3 支持

Moltrade 通过web3使用 Uniswap V3 Router 支持 EVM 链上的去中心化交易。在配置中将trading.exchange设置为"uniswap"。请注意，DEX 交易是原子性的；不存在开放的限价订单或保证金头寸，且价格图表需要外部预言机（目前在本地返回空数据或模拟数据）。

安装 Web3

pip install web3

配置字段

在现有的trading配置块旁添加一个uniswap配置块：

{
  "trading": {
    "exchange": "uniswap",
    "default_symbol": "WETH",
    "default_strategy": "momentum"
  },
  "uniswap": {
    "rpc_url": "https://eth-mainnet.g.alchemy.com/v2/...",
    "private_key": "your_wallet_private_key",
    "chain_id": 1,
    "router_address": "0xE592427A0AEce92De3Edee1F18E0157C05861564",
    "slippage_tolerance": 0.005,
    "default_token_in": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
    "default_token_out": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
  }
}

Polymarket 支持

Moltrade 通过官方的py-clob-client支持 Polymarket 上的预测市场。设置trading.exchange至"polymarket"在你的配置中。

安装CLOB客户端

pip install py-clob-client

配置字段

添加一个polymarket块，与现有的trading块并列：

{
  "trading": {
    "exchange": "polymarket",
    "default_symbol": "TOKEN_ID_HERE",
    "default_strategy": "momentum"
  },
  "polymarket": {
    "api_key": "your_polymarket_api_key",
    "api_secret": "your_polymarket_api_secret",
    "api_passphrase": "your_polymarket_api_passphrase",
    "private_key": "your_wallet_private_key",
    "chain_id": 137
  }
}

添加交易所适配器

• 在trader/exchanges/中实现适配器，以匹配HyperliquidClient接口（get_candles、get_balance、get_positions、place_order
• 等）。trader/exchanges/factory.py按以下键索引trading.exchange。
• 更新配置trading.exchange并重新运行回测/测试模式。

集成新策略

• 遵循trader/strategies/INTEGRATION.md以继承BaseStrategy并在get_strategy中注册。
• 在strategies.<名称>下添加配置；先进行回测，然后在实盘前进行测试模式。

安全性 / 密钥

• 切勿打印或提交私钥、助记词、nsec或共享密钥。
• 默认使用测试模式；实盘交易需获得明确同意。