Twelve Data
用于只读工具与时间戳测试的市场数据。
工程接入教程
OpenClaw + QVeris
AI Agent 实时数据
连接 OpenClaw 与 QVeris，用一个范围明确的任务验证外部数据、权限和时间戳。
On this page
❌ 未接入 QVeris
Agent：“当前比特币价格是多少？”
回答示例：“根据训练数据，比特币在 2024 年初约为 42,000 美元……”
❌ 过时的训练数据
✓ 接入 QVeris
→ 通过 QVeris 发现 crypto.spot_price（示例标识）
→ 调用所选行情接口并检查时间戳
回答格式示例：“比特币价格为 [接口返回值]，数据时间为 [来源时间戳]。”
✓ 可核验的外部数据
你将构建什么
构建在运行时发现并调用真实 API 的 Agent，并在生产接入前完成验证。
运行时发现
Agent 通过自然语言寻找匹配能力；是否可用取决于当前目录、权限与接口契约。
外部数据访问
从金融、天气、新闻、加密货币等服务商获取数据；逐次检查来源时间戳，不保证所有接口均为实时数据。
生产执行
检查执行隔离、结构化 JSON、执行标识与审计记录，并按服务商契约验证返回格式。
开始前准备
✓
已安装 OpenClaw
OpenClaw → 安装指南
OpenClaw → 安装指南
☐
QVeris 账户
Discover/Inspect 免费。注册验证后一次性获得 1,000 credits；$19 购买 10,000 credits，永不过期，无月费、无自动续费。实时调用前请检查所选工具。
Discover/Inspect 免费。注册验证后一次性获得 1,000 credits；$19 购买 10,000 credits，永不过期，无月费、无自动续费。实时调用前请检查所选工具。
☐
QVeris API 密钥
账户 → API 密钥页面
账户 → API 密钥页面
☐
了解 AI Agent 基础知识
非必需，但有助于理解工作流
非必需，但有助于理解工作流
逐步接入：连接 OpenClaw 与 QVeris
01
安装面向 OpenClaw 的 QVeris Skill
通过官方 QVeris Skill 将能力发现与调用接入 OpenClaw；按当前安装文档核对配置步骤。
OpenClaw — Terminal
# Send this to your OpenClaw agent
Install QVeris skill following
/skill/instruct.md
and use
QVERIS_API_KEY=your-key-here
按官方指引下载安装并配置 Skill，完成后验证连接状态。
02
验证安装
让 Agent 确认 QVeris 已连接，并检查积分余额。
OpenClaw — Terminal
# Ask your OpenClaw agent:
"Check my QVeris connection status and show my remaining
credits"
# Expected response:
✓ QVeris connected
✓ API Key: qv-****-****
✓ Credits remaining:
Discover and Inspect are free. Receive 1,000 one-time signup credits after verification; buy 10,000 credits for $19. Credits never expire, with no monthly fees or auto-renewal. Check the selected tool before a live call.
✓ Region: Global (qveris.ai)
03
发现第一个能力
通过自然语言让 Agent 查找一个外部数据源。
OpenClaw — Terminal
# Ask your OpenClaw agent:
"Find me a real-time cryptocurrency price API"
# Agent discovers via QVeris:
Found 4 capabilities:
1. crypto.spot_price Binance
⚡ 180ms 99.4%
2. crypto.market_data CoinGecko
⚡ 320ms 98.1%
3. crypto.ticker Kraken
⚡ 210ms 99.2%
4. crypto.ohlcv Bybit
⚡ 195ms 98.8%
发现能力免费，不消耗积分。
04
调用前检查
让 Agent 在执行前检查参数、权限和成本。
OpenClaw — Terminal
# Agent inspects the top result:
crypto.spot_price (Binance)
Parameters:
symbol string (required) e.g. "BTCUSDT"
Cost: 2 credits per call Latency:
~180ms average Success rate:
99.4%
# Agent confirms:
"Ready to call. This will use 2 credits."
05
调用并获取数据
合成示例：下方请求、报价、24小时涨跌幅、成交量和时间戳均为虚构测试样例，仅演示响应结构，不代表已执行的实时调用或当前市场报价。示例时间戳（2026年3月15日）不是本指南的发布或更新日期。生产环境中，应核对返回的来源与时间戳，再判断报价是否为当前数据。
OpenClaw — Terminal
# Agent calls the capability:
"运行比特币报价的合成测试样例"
# Synthetic response fixture (no live call):
{
"symbol":
"BTCUSDT",
"price":
67423.51,
"change_24h":
+2.34,
"volume_24h":
28941823400,
"timestamp":
"2026-03-15T14:32:07Z"
}
# Agent responds:
"合成测试样例：比特币价格为 67,423.51 美元，模拟24小时涨幅为 +2.34%。这不是当前市场报价。"
接入后可支持的任务
📈 金融研究 Agent
获取股票行情、财报、分析师评级与市场新闻，并核验来源后生成研究报告。
金融能力目录₿ 加密市场监控 Agent
获取现货价格、链上指标、DeFi TVL 与代币数据，并核对交易所覆盖与时效。
外部数据📰 新闻与情绪 Agent
汇总多来源新闻、分析情绪并筛选与主题或资产相关的信号。
新闻数据源🛡 合规与风险 Agent
在具备授权的情况下查询 AML、制裁与监管合规数据。
已收录服务商📊 市场数据 Agent
访问行情、历史价格、公司行动、指数成分与另类信号，并检查具体覆盖。
多市场📄 文档处理 Agent
通过 OCR、PDF 解析与文档提取，将非结构化文档转换为结构化输出。
生产接入验证底层工作原理
OpenClaw Agent
用户自然语言请求
用户自然语言请求
↓
自然语言意图
“获取比特币价格”
“获取比特币价格”
↓
QVeris Skill
转换意图 → 调用 QVeris API
转换意图 → 调用 QVeris API
↓
QVeris 网络
发现 → 检查 → 路由 → 执行
发现 → 检查 → 路由 → 执行
↓
外部数据服务商
按当前目录选择的行情服务商
按当前目录选择的行情服务商
↓
结构化 JSON 响应
返回 Agent → 生成自然语言回答
返回 Agent → 生成自然语言回答
QVeris 提供统一调用入口；接入方仍需配置权限、处理限流并验证服务商返回结果。
常见问题
OpenClaw 是什么，如何与 QVeris 配合？
OpenClaw 提供 Agent 运行环境；QVeris 通过能力路由为 Agent 接入外部工具与 API。安装 Skill 后，Agent 可以发现工具、检查 Schema、发起调用并验证返回数据。
如何让 AI Agent 访问外部数据？
按官方指南为 OpenClaw 安装 QVeris Skill，随后可以发现并调用已授权的外部能力，包括行情、天气与新闻等，具体以当前工具目录和接口参数为准。
训练数据与外部数据有什么区别？
训练数据是模型训练时学习的内容，存在知识截止日期，不能自动反映当前事件、价格或状态；外部数据访问允许 Agent在运行时调用 API以获取新的信息，但仍需核对延迟、覆盖与来源时间戳。
面向 OpenClaw 的 QVeris Skill 免费吗？
Skill 本身免费并开源Discover/Inspect 免费。注册验证后一次性获得 1,000 credits；$19 购买 10,000 credits，永不过期，无月费、无自动续费。实时调用前请检查所选工具。