open-nof1.ai

系统概述

open-nof1.ai 是一个 AI 驱动的加密货币自动交易系统，将大语言模型智能与量化交易实践深度融合。系统基于 Agent 框架构建，通过赋予 AI 完全的市场分析和交易决策自主权，实现真正的智能化交易。

本系统采用最小人工干预的设计理念，摒弃传统的硬编码交易规则，让 AI 模型基于原始市场数据进行自主学习和决策。

系统架构

┌─────────────────────────────────────────────────────────┐
│                   Trading Agent (AI)                    │
│              (DeepSeek V3.2 / Gork4 / Claude)           │
└─────────────────┬───────────────────────────────────────┘
                  │
                  ├─── Market Data Analysis
                  ├─── Position Management
                  └─── Trade Execution Decisions
                  
┌─────────────────┴───────────────────────────────────────┐
│                    VoltAgent Core                       │
│              (Agent Orchestration & Tool Routing)       │
└─────────┬───────────────────────────────────┬───────────┘
          │                                   │
┌─────────┴──────────┐            ┌───────────┴───────────┐
│    Trading Tools   │            │   Gate.io API Client  │
│                    │            │                       │
│ - Market Data      │◄───────────┤ - Order Management    │
│ - News Data        │            │ - Position Query      │
│ - Account Info     │            │ - Market Data Stream  │
│ - Trade Execution  │            │                       │
└─────────┬──────────┘            └───────────────────────┘
          │
┌─────────┴──────────┐
│   LibSQL Database  │
│                    │
│ - Account History  │
│ - Trade Signals    │
│ - Agent Decisions  │
└────────────────────┘

技术栈

组件	技术	用途
框架	VoltAgent	AI Agent 编排与管理
AI 提供商	OpenAI 兼容 API	支持 OpenRouter、OpenAI、DeepSeek 等兼容供应商
交易所	Gate.io / OKX	加密货币交易(测试网 & 正式网)
数据库	LibSQL (SQLite)	本地数据持久化
Web 服务器	Hono	高性能 HTTP 框架
开发语言	TypeScript	类型安全开发
运行时	Node.js 20+	JavaScript 运行环境

快速开始

第一步：注册交易所账户

本项目依赖交易所 API。如果您还没有账户，请先完成注册：

推荐注册方式：

🔥 Gate.io 交易所（推荐）

• 立即注册 Gate.io
• 邀请码：NOFIAIOO

OKX 交易所

• 立即注册 OKX
• 邀请码：NOFIAIOO

新手建议：先注册并使用 Gate.io 测试网环境学习，零风险体验完整功能。

第二步：环境准备

• Node.js >= 20.19.0
• npm 或 pnpm 包管理器
• Git 版本控制工具

第三步：安装项目

# 克隆仓库
git clone <repository-url>
cd nof1.ai

# 安装依赖
npm install

第四步：配置

在项目根目录创建 .env 文件:

# 服务器配置
PORT=3100

# 交易参数
TRADING_STRATEGY=balanced               # 交易策略
TRADING_INTERVAL_MINUTES=20             # 交易循环间隔
MAX_LEVERAGE=25                         # 最大杠杆倍数
MAX_POSITIONS=5                         # 最大持仓数量
MAX_HOLDING_HOURS=36                    # 最大持有时长(小时)
EXTREME_STOP_LOSS_PERCENT=-30           # 极端止损百分比
INITIAL_BALANCE=1000                    # 初始资金(USDT)
ACCOUNT_STOP_LOSS_USDT=50               # 账户止损线
ACCOUNT_TAKE_PROFIT_USDT=20000          # 账户止盈线
SYNC_CONFIG_ON_STARTUP=true             # 启动时同步配置

# 数据库
DATABASE_URL=file:./.voltagent/trading.db

# 交易所选择（gate/okx，默认: gate）
EXCHANGE=gate

# Gate.io API 凭证(建议先使用测试网!)
GATE_API_KEY=your_api_key_here
GATE_API_SECRET=your_api_secret_here
GATE_USE_TESTNET=true

# OKX API 凭证（当 EXCHANGE=okx 时需要配置）
OKX_API_KEY=
OKX_API_SECRET=
OKX_API_PASSPHRASE=
OKX_USE_TESTNET=true

# 手动平仓密码（用于网页界面平仓功能）
CLOSE_POSITION_PASSWORD=

# AI 模型提供商（OpenAI 兼容 API）
OPENAI_API_KEY=your_api_key_here
OPENAI_BASE_URL=https://openrouter.ai/api/v1  # 可选
AI_MODEL_NAME=deepseek/deepseek-v3.2-exp      # 模型名称

# 账户回撤风控配置
# 当账户资产相比峰值回撤达到以下百分比时的风控措施：
ACCOUNT_DRAWDOWN_WARNING_PERCENT=20          # 警告阈值：发出风险警告提醒
ACCOUNT_DRAWDOWN_NO_NEW_POSITION_PERCENT=30  # 禁止开仓阈值：停止开新仓位，只允许平仓
ACCOUNT_DRAWDOWN_FORCE_CLOSE_PERCENT=50      # 强制平仓阈值：自动平掉所有仓位，保护剩余资金

# 账户记录配置
ACCOUNT_RECORD_INTERVAL_MINUTES=1            # 账户记录间隔

API 密钥获取:

• OpenRouter: https://openrouter.ai/keys
• OpenAI: https://platform.openai.com/api-keys
• DeepSeek: https://platform.deepseek.com/api_keys
• Gate.io 测试网: https://testnet.gate.com
• Gate.io 正式网: https://www.gatesite.org/signup/NOFIAIOO?ref_type=103
• OKX 交易所: https://www.okx.com/zh-hans/join/nofiaioo

环境变量说明

配置文件 .env 中的关键参数说明：

交易参数配置：

• TRADING_STRATEGY: 交易策略选择，影响开仓频率和风险控制
• TRADING_INTERVAL_MINUTES: 每次交易循环的间隔时间，越短越频繁
• MAX_LEVERAGE: 最大杠杆倍数，建议新手使用 3-5 倍
• MAX_POSITIONS: 同时持有的最大仓位数量，用于分散风险
• MAX_HOLDING_HOURS: 单个仓位的最长持有时间，超时自动平仓
• EXTREME_STOP_LOSS_PERCENT: 极端止损线，防止爆仓的最后防线
• INITIAL_BALANCE: 初始资金设置，用于计算仓位大小
• ACCOUNT_STOP_LOSS_USDT: 账户总资产止损线，触及后停止交易
• ACCOUNT_TAKE_PROFIT_USDT: 账户总资产止盈线，达到后可选择停止

风险控制参数：

• ACCOUNT_DRAWDOWN_WARNING_PERCENT: 回撤 20% 时发出警告
• ACCOUNT_DRAWDOWN_NO_NEW_POSITION_PERCENT: 回撤 30% 时禁止开新仓
• ACCOUNT_DRAWDOWN_FORCE_CLOSE_PERCENT: 回撤 50% 时强制平仓保护资金

数据库配置：

• DATABASE_URL: 数据库文件路径，存储交易记录和决策日志

交易所配置：

• EXCHANGE: 选择使用的交易所（gate 或 okx，默认: gate）
  • 设置为 gate 使用 Gate.io 交易所
  • 设置为 okx 使用 OKX 交易所

Gate.io API 配置：

• GATE_API_KEY: Gate.io API 密钥
• GATE_API_SECRET: Gate.io API 密钥
• GATE_USE_TESTNET: 设置为 true 使用测试网，false 使用正式网

OKX API 配置：

• OKX_API_KEY: OKX API 密钥（当 EXCHANGE=okx 时必需）
• OKX_API_SECRET: OKX API 密钥（当 EXCHANGE=okx 时必需）
• OKX_API_PASSPHRASE: OKX API 口令（当 EXCHANGE=okx 时必需）
• OKX_USE_TESTNET: 设置为 true 使用测试网，false 使用正式网

其他 API 配置：

• CLOSE_POSITION_PASSWORD: 网页界面手动平仓的安全密码

Gate MCP News 配置：

• GATE_NEWS_MCP_ENABLED: 是否启用消息面数据（默认 true，设为 false 可关闭）
• GATE_NEWS_MCP_URL: MCP 端点地址（默认 https://api.gatemcp.ai/mcp/news）
• 以上配置项均有默认值，无需额外配置即可使用

⚠️ 重要：

• 首次使用请务必在测试网环境测试（GATE_USE_TESTNET=true 或 OKX_USE_TESTNET=true）！
• 切换交易所时，请确保配置对应交易所的 API 密钥

第五步：数据库初始化

npm run db:init

第六步：启动交易系统

# 开发模式(热重载)
npm run dev

# 生产模式
npm run trading:start

启动失败？ 合约账户为0无法交易，请从现货账户划转交易金额（测试网同样需要）。

第七步：访问 Web 仪表板

在浏览器中访问 http://localhost:3100

完整文档

完整文档请参考：

• 英文完整文档 - 完整功能列表、API 参考、故障排查指南
• 中文完整文档 - 完整功能列表、API 参考、故障排查指南
• 日文完整文档 - 完全な機能リスト、APIリファレンス、トラブルシューティング
• 交易策略配置指南 - 5种交易策略详细说明和配置指南

完整文档包含内容:

• ✅ 详细功能说明
• ✅ 完整配置指南
• ✅ 所有命令参考
• ✅ 生产部署指南
• ✅ 故障排查和常见问题
• ✅ API 文档
• ✅ 最佳实践
• ✅ 贡献指南

核心特性

AI 驱动决策

• 模型支持: DeepSeek V3.2, Grok4, Claude 4.5, Gemini Pro 2.5
• 自主分析: 无预配置交易信号
• 多时间框架: 跨多个时间窗口聚合数据
• 风险管理: AI 控制的仓位规模和杠杆管理

消息面数据集成

• 数据来源: 通过 Gate MCP News 端点获取实时加密货币快讯、交易所公告、社交情绪数据
• 并行采集: 消息面数据与技术面数据并行采集，每周期与市场数据同时获取，为 AI 决策提供更全面的信息维度
• AI 工具: 支持 getCryptoNews、getExchangeAnnouncements、getSocialSentiment
• 故障隔离: 消息面数据获取失败不影响交易主流程

完整交易功能

• 支持资产: BTC, ETH, SOL, BNB, XRP, DOGE, GT, TRUMP, ADA, WLFI
• 合约类型: USDT 结算永续合约
• 杠杆范围: 1倍至10倍(可配置)
• 订单类型: 市价单、止损、止盈

实时监控

• Web 仪表板: 实时账户指标和持仓概览
• AI 决策日志: 透明展示模型推理过程
• 交易历史: 完整的交易记录与时间戳

风险声明

⚠️ 本系统仅供教育和研究目的。加密货币交易具有重大风险,可能导致资金损失。

• 务必先在测试网测试策略
• 仅投资您能承受损失的资金
• 用户对所有交易活动承担全部责任
• 系统性能不提供任何保证或担保

开源协议

本项目采用 GNU Affero General Public License v3.0 (AGPL-3.0) 协议。

主要条款

• 免费使用: 您可以出于任何目的使用本软件
• 开源要求: 任何修改必须在 AGPL-3.0 下发布
• 网络使用: 如果作为服务提供必须公开源代码
• 无担保: 软件按"原样"提供

完整条款请参见 LICENSE 文件。

资源

交流社区

• Telegram 交流群: 加入 AI Agent 学习交流群
  • 讨论 AI 量化交易策略
  • 分享项目使用经验
  • 获取技术支持和建议

🎁 交易返佣 & 社群福利

Gate.io 交易所（推荐）

如果您还没有 Gate.io 账户，可以通过我们的邀请注册：

• 邀请链接: https://www.gatesite.org/signup/NOFIAIOO?ref_type=103
• 邀请码: NOFIAIOO

加入 Telegram 交流群 获取 60% 手续费返佣等社群福利。

外部链接

• VoltAgent 文档
• OpenRouter 模型目录
• Gate.io API 参考
• Gate.io 测试网
• OKX API 参考
• OKX 交易所

参与贡献

欢迎贡献！请参考完整文档了解贡献指南。

支持项目

如果本项目对您有帮助，欢迎通过以下方式支持项目持续发展：

币种	网络	地址
USDT	TRON (TRC20)	TAdHVfDtJ3nn6fjT1DWvfuU89GzMBxcXmU
USDT	Ethereum (ERC20)	0x7b5a45499086632d1ccf7177f1f7fdf6a8236569
USDT	BNB Chain (BEP20)	0x7b5a45499086632d1ccf7177f1f7fdf6a8236569
USDT	Solana (SPL)	DVWUAJHampBM8pAUWCFskHXp6Uh4SrVKsjfPmnvMcjtq
USDT	Polygon	0x7b5a45499086632d1ccf7177f1f7fdf6a8236569

您的支持是项目不断改进的动力，感谢！

---

nof1.ai 快速上手指南

nof1.ai 是一个基于 AI Agent 的加密货币自动交易系统，支持 Gate.io 和 OKX 交易所，利用大语言模型进行自主市场分析与交易决策。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• Node.js: 版本 >= 20.19.0
• 包管理器: npm 或 pnpm
• 版本控制: Git
• 交易所账户: 需拥有 Gate.io 或 OKX 账户（建议先使用测试网环境）
  • Gate.io 测试网注册
  • OKX 注册
• AI API Key: 兼容 OpenAI 格式的 API Key（如 OpenRouter, DeepSeek, OpenAI 等）

安装步骤

1. 克隆项目

git clone <repository-url>
cd nof1.ai

2. 安装依赖

npm install

3. 配置环境变量

在项目根目录创建 .env 文件，并填入以下关键配置（请根据实际情况修改）：

# 服务器端口
PORT=3100

# 交易所选择 (gate 或 okx)
EXCHANGE=gate

# Gate.io 配置 (若使用测试网，GATE_USE_TESTNET 设为 true)
GATE_API_KEY=your_api_key_here
GATE_API_SECRET=your_api_secret_here
GATE_USE_TESTNET=true

# OKX 配置 (仅当 EXCHANGE=okx 时填写)
OKX_API_KEY=
OKX_API_SECRET=
OKX_API_PASSPHRASE=
OKX_USE_TESTNET=true

# AI 模型配置 (以 OpenRouter + DeepSeek 为例)
OPENAI_API_KEY=your_openrouter_key_here
OPENAI_BASE_URL=https://openrouter.ai/api/v1
AI_MODEL_NAME=deepseek/deepseek-v3.2-exp

# 基础交易参数
TRADING_STRATEGY=balanced
TRADING_INTERVAL_MINUTES=20
MAX_LEVERAGE=5
INITIAL_BALANCE=1000

# 数据库路径
DATABASE_URL=file:./.voltagent/trading.db

# 手动平仓密码 (用于 Web 界面)
CLOSE_POSITION_PASSWORD=your_secure_password

注意：首次运行务必开启测试网模式 (GATE_USE_TESTNET=true 或 OKX_USE_TESTNET=true) 以避免资金损失。

4. 初始化数据库

npm run db:init

基本使用

启动系统

您可以选择开发模式（支持热重载）或生产模式启动：

# 开发模式
npm run dev

# 生产模式
npm run trading:start

提示：如果启动失败提示合约账户余额为 0，请先在交易所界面从现货账户划转少量资金至合约账户（测试网同样需要此操作）。

访问仪表盘

系统启动后，在浏览器中访问：

http://localhost:3100

您将看到实时账户指标、AI 决策日志以及持仓概览。您可以在界面中使用配置的 CLOSE_POSITION_PASSWORD 进行手动平仓操作。

停止交易

在终端按下 Ctrl + C 即可停止系统运行。