什么是 xtrade-futu-paper-trade？

富途模拟交易技能通过 Openclaw Skills 生态系统提供了一个以开发者为中心的强大接口，用于与 FutuOpenD API 进行交互。它专为模拟交易环境设计，允许用户在没有财务风险的情况下查询实时市场行情、管理模拟交易持仓并执行模拟订单。通过在 Openclaw Skills 中利用此工具，开发者可以实现复杂金融工作流和策略测试的自动化。

除了基础交易外，该技能还集成了深度的金融分析能力。它可以检索多个时间维度的历史 K 线数据，并提取详细的财务报告。对于富途 API 无法直接提供的数据点，该技能会智能地回退到 AkShare 以获取 A 股和港股指标，为 Openclaw Skills 用户提供无缝的数据体验。

下载入口:https://github.com/openclaw/skills/tree/main/skills/xxxwang/xtrade-futu-paper-trade

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

xtrade-futu-paper-trade 应用场景

• 在模拟（PAPER）环境中安全地测试算法交易策略。
• 获取港股和 A 股股票的实时及历史市场数据。
• 自动监控模拟交易投资组合和每日盈亏报告。
• 使用资产负债表、利润表和现金流量表进行深度的基本面分析。

1. 技能初始化时通过指定的主机和端口检查本地 FutuOpenD 服务的连接情况。
2. 首次执行时，它会自动创建 Python 虚拟环境并安装必要的依赖项，如 futu-api 和 AkShare。
3. 用户命令通过 xtrade_xtrade_futu_skill.py 脚本处理，该脚本会验证环境是否设置为 PAPER 以防止意外的实盘交易。
4. 市场或账户请求被调度到 FutuOpenD，响应结果被格式化为结构化 JSON 供 AI 智能体使用。
5. 如果请求 A 股的财务报表数据，该技能将利用 AkShare 回退机制以确保 Openclaw Skills 内部全面的数据覆盖。

xtrade-futu-paper-trade 配置指南

要在 Openclaw Skills 中开始使用此技能，请确保已安装 Python 3 且 FutuOpenD 正在本地运行。

# 1. 设置所需的环境变量
export FUTU_TRADE_PWD="your_unlock_password"
export FUTU_TRD_ENV="PAPER"

# 2. 运行环境检查
python3 xtrade_xtrade_futu_skill.py check

# 3. 查询账户资金以验证连接
python3 xtrade_xtrade_futu_skill.py funds

xtrade-futu-paper-trade 数据架构与分类体系

该技能将市场和财务数据组织成结构化的 JSON 对象。以下是数据请求中使用的关键参数：

name: xtrade-futu-paper-trade
description: 使用富途纸面交易API查询行情、持仓并下单
metadata: {"openclaw":{"requires":{"bins":["python3"]},"os":["darwin","linux","win32"]}}

富途纸面交易 Skill

当用户需要查询行情、持仓、订单、成交或下单时，调用此技能。使用本技能时：

• 统一通过 {baseDir}/xtrade_xtrade_futu_skill.py 执行
• 首次执行会自动创建虚拟环境并安装依赖
• 依赖本地 FutuOpenD 服务

自动安装与引导

• 本技能会自动创建虚拟环境并安装 Python 依赖
• 若系统缺少 python3，请先安装后再重试
• 自动选择兼容 futu-api 的 Python 3.10/3.11/3.12 并重建虚拟环境
• FutuOpenD 属于官方程序，无法由技能自动下载安装
• 可使用 check 指令自动检测并给出引导步骤
• 完成后仅需设置 FUTU_TRADE_PWD 即可交易
• 安全限制：仅允许纸面交易，检测到 REAL 会拒绝执行

FutuOpenD 下载与登录

• 下载入口：https://www.futuhk.com/en/support/topic1_464
• 安装后解压，按文档启动 OpenD（Mac/Windows/Linux）并保持运行
• 登录方式：使用命令行参数 -login_account 与 -login_pwd 启动，不落盘保存密码
• 安全特性：默认不要求在本地保存账号密码

环境变量

• FUTU_HOST：FutuOpenD 地址，默认 127.0.0.1
• FUTU_PORT：FutuOpenD 端口，默认 11111
• FUTU_TRD_ENV：交易环境，仅支持 PAPER（或 SIMULATE）
• FUTU_TRD_MARKET：交易市场，默认 HK
• FUTU_TRADE_PWD：交易解锁密码
• FUTU_ACCOUNT：账号标识，可选
• FUTU_PASSWORD：账号密码，可选

常用命令

• 环境检查： python3 {baseDir}/xtrade_xtrade_futu_skill.py check
• 查询账户资金与资产： python3 {baseDir}/xtrade_xtrade_futu_skill.py funds
• 查询实时行情： python3 {baseDir}/xtrade_xtrade_futu_skill.py quote --symbols HK.00700 HK.09988
• 查询持仓： python3 {baseDir}/xtrade_xtrade_futu_skill.py positions
• 查询今日盈亏： python3 {baseDir}/xtrade_xtrade_futu_skill.py today-pnl
• 下单买入： python3 {baseDir}/xtrade_xtrade_futu_skill.py buy --symbol HK.00700 --qty 100 --price 320.5
• 下单卖出： python3 {baseDir}/xtrade_xtrade_futu_skill.py sell --symbol HK.00700 --qty 100 --price 321.0
• 查询订单： python3 {baseDir}/xtrade_xtrade_futu_skill.py orders --status all
• 撤单： python3 {baseDir}/xtrade_xtrade_futu_skill.py cancel --order-id 8851102695472794941
• 查询成交（默认当日）： python3 {baseDir}/xtrade_xtrade_futu_skill.py fills --days 1
• 获取历史 K 线（日线）： python3 {baseDir}/xtrade_xtrade_futu_skill.py historical-kline --code HK.00700 --start 2025-01-01 --end 2025-01-31 --ktype DAY
• 获取历史 K 线（周线）： python3 {baseDir}/xtrade_xtrade_futu_skill.py historical-kline --code HK.00700 --start 2024-01-01 --end 2025-01-31 --ktype WEEK
• 获取历史 K 线（月线）： python3 {baseDir}/xtrade_xtrade_futu_skill.py historical-kline --code HK.00700 --start 2020-01-01 --end 2025-01-31 --ktype MONTH
• 获取历史 K 线（分钟线）： python3 {baseDir}/xtrade_xtrade_futu_skill.py historical-kline --code HK.00700 --start 2025-01-01 --end 2025-01-02 --ktype 1M
• 获取历史 K 线（分页）： python3 {baseDir}/xtrade_xtrade_futu_skill.py historical-kline --code HK.00700 --start 2025-01-01 --end 2025-01-31 --ktype DAY --max-count 200 --page-req-key
• 查询财务报表： python3 {baseDir}/xtrade_xtrade_futu_skill.py financial-report --code SH.600519 --start 2024-01-01 --end 2024-12-31
• 查询财务指标（季度）： python3 {baseDir}/xtrade_xtrade_futu_skill.py financial-indicators --code SH.600519 --period QUARTER
• 查询财务指标（半年度）： python3 {baseDir}/xtrade_xtrade_futu_skill.py financial-indicators --code SH.600519 --period HALF
• 查询财务指标（年度）： python3 {baseDir}/xtrade_xtrade_futu_skill.py financial-indicators --code SH.600519 --period YEAR
• 查询资产负债表（季度）： python3 {baseDir}/xtrade_xtrade_futu_skill.py financial-balance --code SH.600519 --period QUARTER
• 查询利润表（半年度）： python3 {baseDir}/xtrade_xtrade_futu_skill.py financial-income --code SH.600519 --period HALF
• 查询现金流量表（年度）： python3 {baseDir}/xtrade_xtrade_futu_skill.py financial-cashflow --code SH.600519 --period YEAR

替代接口说明

• financial-report、financial-indicators、financial-balance、financial-income、financial-cashflow 默认优先使用 futu-api
• 当 futu-api 缺失相关接口时，A 股与港股回退 AkShare
• A 股财务报表来自新浪财经（SH./SZ.）
• 港股财务指标来自东方财富，港股财务报表依赖 AkShare 港股接口支持

输出说明

• 所有输出为 JSON
• 失败时返回 error 字段，包含原因与建议