nofx/docs/nofx-integration-plan.md

NOFXi × NOFX 集成方案

审视日期: 2026-03-22 目标: NOFXi 自然接管 NOFX 的所有能力，成为交易领域的 OpenClaw

NOFX 现有能力清单

核心引擎 (kernel/)

模块	文件	能力	NOFXi 集成状态
AI 决策引擎	engine.go	完整的交易上下文构建 → AI 分析 → 结构化决策	❌ 未接入
Prompt 构建	engine_prompt.go	策略引擎+风控约束+多语言 prompt	❌ 未接入
持仓分析	engine_position.go	持仓状态+止损止盈+保证金分析	❌ 未接入
决策 Schema	schema.go	双语数据字典，AI 理解交易数据的基础	❌ 未接入
格式化	formatter.go	决策结果格式化输出	❌ 未接入
网格引擎	grid_engine.go	网格策略执行	❌ 未接入

交易执行 (trader/)

模块	能力	NOFXi 集成状态
auto_trader.go	自动交易主体：配置、初始化、生命周期	🔧 bridge 接口定义了，但未调用
auto_trader_loop.go	交易循环：上下文构建 → AI 决策 → 执行 → 记录	❌ 核心！必须接入
auto_trader_decision.go	决策执行：开仓/平仓/调仓	❌ 未接入
auto_trader_risk.go	风控：每日亏损限制、最大回撤、安全模式	❌ 未接入
auto_trader_orders.go	订单管理：止损止盈、追踪止损	❌ 未接入
auto_trader_grid.go	网格交易执行	❌ 未接入
9 交易所	binance/okx/bybit/bitget/gate/kucoin/hyperliquid/aster/lighter	🔧 factory.go 接了 6 个

MCP 客户端 (mcp/)

模块	能力	NOFXi 集成状态
client.go	OpenAI 兼容 + 流式 + 重试 + x402 支付	❌ NOFXi 自己写了简单版
context_guard.go	上下文长度预校验，防止超限	❌ 未接入
hooks.go	AI 调用钩子（日志、计费）	❌ 未接入
config.go	模型配置管理	❌ 未接入

市场数据 (market/)

模块	能力	NOFXi 集成状态
data.go	完整市场数据：价格/EMA/MACD/RSI/布林带/OI/资金费率	❌ NOFXi 只用了 ticker
data_indicators.go	技术指标计算	❌ 未接入
data_klines.go	K 线数据获取（CoinAnk 路由）	🔧 NOFXi 直接调 Binance
historical.go	历史数据	❌ 未接入

数据存储 (store/)

模块	能力	NOFXi 集成状态
decision.go	AI 决策记录（完整链路）	❌ 未接入
position.go	持仓记录	❌ 未接入
order.go	订单记录	❌ 未接入
equity.go	权益快照（画收益曲线）	❌ 未接入
exchange.go	交易所配置（加密存储）	❌ NOFXi 用 YAML
ai_charge.go	AI 调用计费	❌ 未接入
grid.go	网格策略配置和状态	❌ 未接入

Telegram Agent (telegram/)

模块	能力	NOFXi 集成状态
bot.go	Telegram bot + agent 系统	🔧 NOFXi 自己写了简单版
agent/	流式回复、tool calling、记忆	❌ 未接入

其他

模块	能力	NOFXi 集成状态
wallet/	USDC 钱包、x402 支付	❌ 未接入
hook/	HTTP 代理、IP 钩子	❌ 未接入
telemetry/	交易经验库	❌ 未接入
config/	统一配置管理	❌ NOFXi 用独立 YAML
auth/	用户认证	❌ 未接入
Web 前端	React 完整 UI（Dashboard/Traders/Strategy/Data/Competition）	❌ NOFXi 只有简单聊天页

---

集成优先级

P0 — 必须接入（NOFXi 才算真正的 NOFX Agent）

1. kernel/ 决策引擎 → 替换 NOFXi 的简单 LLM 调用

   • BuildTradingContext() → 完整的交易上下文
   • GetFullDecisionWithStrategy() → 结构化 AI 决策
   • StrategyEngine → 策略配置（aggressive/conservative/scalping）

2. trader/auto_trader_loop.go → NOFXi 的策略运行器直接调用

   • runCycle() 就是 NOFX 的核心交易循环
   • 包含：上下文构建 → AI 决策 → 执行 → 风控 → 记录

3. market/data.go → 替换 NOFXi 简单的 ticker 调用

   • 完整技术指标：EMA20/50、MACD、RSI7/14、布林带、ATR
   • 多时间维度：3min/15min/1h/4h
   • OI（持仓量）数据、资金费率

4. mcp/client.go → 替换 NOFXi 的简单 HTTP 调用

   • 流式支持、重试、x402 支付、上下文长度保护

P1 — 重要增强

5. store/ 完整数据层 → 替换 NOFXi 的简单 SQLite

   • 决策记录、订单、持仓、权益快照、AI 计费

6. trader/auto_trader_risk.go → 专业风控

   • 每日亏损限制、最大回撤、安全模式

7. trader/auto_trader_orders.go → 智能订单

   • 止损止盈、追踪止损、分批建仓

P2 — 差异化能力

8. kernel/grid_engine.go → 网格策略
9. telegram/agent/ → 升级为流式+tool calling
10. telemetry/experience.go → 交易经验库
11. Web 前端整合 → NOFXi 页面集成到 NOFX 前端

---

集成方式

NOFXi 位于 nofx/nofxi/，已经是 nofx 主模块的子包。可以直接 import nofx 的所有包。

// NOFXi 可以直接使用 NOFX 的核心引擎
import (
    "nofx/kernel"           // AI 决策引擎
    "nofx/market"           // 市场数据
    "nofx/mcp"              // LLM 客户端
    "nofx/store"            // 数据存储
    "nofx/trader"           // 交易执行
    "nofx/manager"          // Trader 管理器
    "nofx/config"           // 配置管理
    "nofx/wallet"           // 钱包/支付
)

架构关系

NOFX (交易引擎)
├── kernel/    → NOFXi.Thinking 调用
├── market/    → NOFXi.Perception 调用
├── trader/    → NOFXi.Execution 调用
├── store/     → NOFXi.Memory 调用
├── mcp/       → NOFXi.Thinking 调用
└── web/       → NOFXi Web 集成

NOFXi (AI Agent 层)
├── Agent Core     → 编排以上所有
├── Brain          → 自主决策 + 主动通知
├── Sentinel       → 异动感知
├── Learner        → 学习进化
└── Interaction    → Telegram + Web

NOFXi 不是重新造轮子，是给 NOFX 装上大脑。