共计 3388 个字符，预计需要花费 9 分钟才能阅读完成。
最近在折腾 [[OpenClaw]] 的工作流时，发现富途开放平台悄悄上线了一套专为 AI 工具设计的 Skills 包。安装之后，我们可以直接在对话框里问 AI "帮我看看腾讯最近的 K 线，如果 RSI 低于 20，帮我买入 20 股"，AI 就能自动调用 Futu API 返回数据，分析各类指标，并为我们完成下单——这种体验比自己写脚本顺手太多了。这篇文章就来聊聊 [[Futu API]] 是什么、能做什么，以及怎么在 OpenClaw 里跑起来。
Futu API 是什么
Futu API（富途量化接口）是[[富途牛牛]]开放给开发者的量化交易平台，官方的定位是"为程序化交易提供丰富的行情数据和交易接口"。它的架构分两层：一个叫 [[OpenD]] 的本地网关程序，以及各语言的 SDK（Python、Java、C#、C++、JavaScript 均有支持）。
OpenD 跑在你的本地机器或云服务器上，充当你的程序和富途后台之间的中继。你的代码通过自定义 TCP 协议和 OpenD 通信，OpenD 再去富途服务端取数据或执行交易，语言无关的设计让接入门槛很低。官方宣传的订单执行速度可以做到 0.0014 秒，对量化策略来说响应是够快的。
更值得关注的是，Futu API 覆盖的市场相当全面：港股（股票、ETF、期权、权证、期货）、美股（股票、ETF、期权、期货）、A 股（股票、ETF）、新加坡、日本、澳大利亚市场都在支持列表里，这对同时持有多市场仓位的投资者很方便。
Futu API 能做什么
整理一下官方 Skills 文档里列出的能力，大致可以分几类：
- 行情数据：实时报价、K 线历史（分钟/日线/周线等级别）、逐笔成交、摆盘快照、板块列表与成分股、资金流向分析，覆盖从短线到中线策略所需的大多数输入
- 交易操作：挂单（限价/市价）、撤单、改单，模拟账户与真实账户接口完全一致，调试完切换实盘只需改一个参数；期货额外支持新加坡市场并内置代码生成辅助
- 筛选与研究：按价格、市值、PE、换手率等维度筛股，查询实时市场状态（是否开市、当前交易时段）
- 账户管理：查持仓、查资金，支持实时订阅推送（行情、K 线、成交）
futuapi 模块共覆盖 25 个脚本，内置 65 条 API 接口签名供 AI 快速索引，基本覆盖了日常投研和交易所需的全部场景。
如何安装：一键接入 OpenClaw
富途牛牛官方提供了一套基于 [[Claude Code]] Skills 标准构建的 OpenD Skills 包，包含两个模块：install-futu-opend（安装助手）和 futuapi（行情交易助手）。对于 [[OpenClaw]] 用户，安装流程非常简洁。
如果是使用 OpenClaw ，可以直接和 OpenClaw 说如下的提示词。
阅读文档中的一键安装步骤，安装富途牛牛OpenD和相关skills
https://openapi.futunn.com/futu-api-doc/intro/ai.html
手动安装
为了确保安全，你也可以自己手动下载并安装 Skills 包。
打开终端，执行以下命令完成一键安装：
# 下载 Skills 压缩包
curl -L https://openapi.futunn.com/skills/opend-skills.zip -o /tmp/opend-skills.zip
# 解压到临时目录
unzip /tmp/opend-skills.zip -d /tmp/opend-skills
# 复制到 OpenClaw 全局 skills 目录
cp -r /tmp/opend-skills/skills/* ~/.openclaw/skills/
# 清理临时文件
rm -rf /tmp/opend-skills /tmp/opend-skills.zip
根据你使用的 AI 工具，目标路径有所不同：
| 工具 | 安装路径 |
|---|---|
| Claude Code / VS Code + Claude 插件 / JetBrains | ~/.claude/skills/ |
| OpenClaw | ~/.openclaw/skills/ |
| Cursor（内置 AI，无 Claude 插件） | .cursor/rules/（逐个 skill 文件拷贝为 rule） |
| VS Code Cline / Roo Code | .vscode/cline_instructions.md 或 .roo/rules/ |
| JetBrains（Junie） | .junie/guidelines/ |
[[Claude Code]] 还支持 --add-dir 参数按需加载：
claude --add-dir /tmp/opend-skills
这种方式不需要把文件复制到全局目录，适合临时使用或项目级隔离。
安装完成后，在 OpenClaw 的对话框里输入 / 触发补全，应该能看到 install-futu-opend 和 futuapi 两个选项出现，说明 Skills 已经就位。
安装 OpenD 与 Python SDK
Skills 包装好之后，还需要本地跑一个 OpenD 网关。最省事的方式是直接调用安装助手 Skill：
/install-futu-opend
这个 Skill 会自动识别你的操作系统（Windows/macOS/Linux），下载对应版本的 OpenD，完成解压和启动，同时自动更新 futu-api Python SDK。整个过程不需要手动去官网翻下载链接，跑完之后 OpenD 就在后台监听了。
OpenD 启动后需要手动登录一次[[富途牛牛]]账号（用客户端或 OpenD 自带的 Web UI 登录），完成授权之后才能通过 API 正常访问行情和交易接口。这一步是每次重启 OpenD 后都要做的，富途出于安全考虑没有提供免登录的持久会话。
在 OpenClaw 里用起来
Skills 装好、OpenD 跑起来之后，就可以在对话里用自然语言描述需求了，AI 会自动匹配并调用对应的接口。
查行情的典型用法：
帮我看一下腾讯（00700）最近 30 天的日 K 线
查一下苹果今天的实时报价和成交量
给我看一下港股通资金流向，今天主力净流入最多的前十只股票
下单和账户查询：
在模拟账户里，以市价买入 100 股腾讯
查一下我现在的持仓情况和可用资金
需要注意的是，Skills 默认走模拟账户，如果要操作真实账户需要在指令里明确说"实盘"或"真实账户"，系统会要求你进行二次确认并输入交易密码，这个双重确认机制在实际使用中还是挺重要的安全设计。
另外实时行情订阅有配额限制（根据账户等级从 100 到 2000 个不等），如果你在开发调试阶段频繁订阅，记得定期释放不用的订阅，不然很快会跑满。下单也有速率限制，官方给的数字是每 30 秒最多 15 笔委托，高频策略需要注意这个上限。
文档喂给 AI 的技巧
官方文档提供了完整的 Markdown 版本下载（在文档站右上角的 Download 菜单里，可以按语言和编程语言分别下载）。如果你在用 [[Cursor]] 或者自己搭的 AI 助手，可以把下载的 .md 文件直接放进项目目录，让 AI 索引接口定义和参数规格，这样生成的代码质量会明显好于只靠训练数据推断。对于 [[OpenClaw]] 来说这一步通常不需要手动处理，因为 Skills 里已经内置了 65 条接口签名描述，但如果你要定制更复杂的策略脚本，喂原始文档是个好习惯。
如何更新 Skills
当官方发布新版 Skills 时，更新方式很简单：重新下载 opend-skills.zip，解压后覆盖原有文件即可。整个过程和初次安装一样，不需要额外操作，下次 OpenClaw 或 Claude Code 启动时会自动加载新版本。
安全性
本地安装的 OpenD 需要进行登录，这也就意味着我们需要一个 Futu 账号才能使用，但是大家也不用担心安全问题，真正的交易还是需要我们密码输入进行二次确认。但如果不放心在 OpenClaw 中使用，也可以首先使用模拟盘，或者只让 OpenClaw 进行数据查询和整理，确保安全无误之后再进行真实的交易。
最后
Futu API + OpenClaw Skills 这套组合，本质上是把量化交易的门槛从"会写 Python 脚本"降到了"会描述需求"。对于已经在用[[富途牛牛]]的投资者来说，接入成本极低——一条安装命令、一次 OpenD 登录，然后就可以用对话的方式驱动行情查询和下单操作。当然它目前的定位更像是辅助工具和快速验证，复杂的量化策略还是得落到代码层面，但对日常的研究、看盘、偶发性交易来说，这个工作流已经够用了。如果你本来就在用 [[Claude Code]] 或 OpenClaw，不妨花五分钟把 Skills 装上试试。
