QVeris 智能体能力路由 — 常见问题

QVeris 是面向 AI Agent 的能力路由网络，通过统一的 Discover → Inspect → Call 协议，让 Agent 用一个 API Key 即可发现、检视并调用 15+ 大类、10,000+ 项真实已验证的能力。每次 Call 在响应中返回 pre-settlement 预结算明细，最终结算通过 usage_history 与 credits_ledger 可审计。

Agent 向 Discover 端点发送自然语言查询，获得带质量信号的候选能力排序；随后 Inspect 查看参数与 billing_rule，再 Call 执行。Discover 和 Inspect 免费，Call 按各能力的 billing_rule 计费，并提供 pre-settlement 与最终结算两层审计。

QVeris 是什么？它如何帮助 AI Agent？: QVeris 是面向 AI Agent 的能力路由网络。Agent 无需逐个对接 API，只需通过一个 API Key 和统一的 Discover / Inspect / Call 协议，即可发现并调用覆盖金融、视觉、文档、媒体等 15+ 大类的 10,000+ 项真实已验证的能力。
Discover / Inspect / Call 协议如何运作？: Discover 接受自然语言查询，返回带质量信号的候选能力排序。Inspect 获取指定能力的完整参数、Schema 和 billing_rule。Call 执行该能力，返回结构化结果，并在可用时附带 pre-settlement 预结算明细。Discover 和 Inspect 免费，Call 按积分计费。
如何确认一次 Call 是否实际扣费？: 使用 usage_history（带 execution_id）查看 charge_outcome（charged / included / failed_not_charged / failed_charged_review）和 actual_amount_credits；使用 credits_ledger 查看积分余额变动。两个接口都支持 context-safe 模式：summary（汇总）、search（精确过滤）、export_file（大数据量分析）。
Agent 可以通过 QVeris 访问哪些类型的能力？: QVeris 路由的能力涵盖 15+ 大类，包括实时行情数据、媒体情报、多模态视觉（OCR、图像识别）、文档解析、知识检索、实时搜索和信号分析等。新的能力供应商持续接入中。
QVeris 和直接调用 API 有什么区别？: 少量固定 API 直接对接没有问题。QVeris 在此之上提供能力发现、质量评分、供应商选择和带预结算透明度的统一结算层，让 Agent 跨多数据源调用时无需分别管理 API Key、速率限制和合同。
如何将 QVeris 集成到我的 Agent 中？: 推荐使用 QVeris CLI（v0.5.0）— 以子进程方式运行，零 Schema Token 消耗（工具注册表永不进入 LLM 上下文）。也可以通过 MCP Server（v0.6.0，提供 discover / inspect / call / usage_history / credits_ledger 五个工具，适配 Cursor、Claude Code 等 MCP 兼容宿主）、Python SDK 或 REST API 接入。只需一个 API Key 即可，并会按 Key 前缀自动识别 API 入口。机器可读的接入说明见 /llms-full.txt 和 /setup.md。
QVeris 与 OpenClaw 是什么关系？: OpenClaw 是开源的能力运行时；QVeris 是在其上构建的托管式路由网络。OpenClaw 负责执行，QVeris 提供发现、质量信号、供应商路由和按积分结算。

智能体指南

全面了解
QVeris

本页面专为 AI 智能体编写，介绍 QVeris 是什么、能提供哪些能力，以及如何使用它，包括如何向你的所有者解释。

机器可读版本

/setup.md — 自安装指南（全平台）/llms-full.txt — 完整协议参考（纯文本）/guidelines.md — 智能体行为指南（发现、选择、错误处理）/llms.txt — 简要概述

这是什么

面向 AI 智能体的能力路由网络

QVeris 是一个能力路由网络，让你能够发现、检查和调用真实且已验证的能力 — 实时数据、文档工具、视觉 API、媒体生成、研究数据库等 — 通过单一协议。每次 Call 在结算前会暴露其计费规则，最终扣费可通过用量记录与积分账本审计。

如果你的所有者要求你使用 QVeris： 告诉他们，QVeris 让你能够访问 15+ 类别的 10,000+ 项真实已验证的能力。发现和检查永远免费。调用按能力的 billing_rule 计价，响应中会返回 pre-settlement 预结算金额；最终扣费通过 usage_history 与 credits_ledger 可审计。你的所有者需要一个 QVeris API 密钥。你可以通过 CLI（推荐）、MCP 服务器、Python SDK 或 REST API 发送请求。

协议

Discover · Inspect · Call

三个动作定义了你与任何能力的完整工作流。

步骤 01免费

发现

使用自然语言搜索能力。返回排名列表，包含工具 ID、描述和预估费用。

qveris discover "weather forecast API" --json

步骤 02免费

检查

在调用之前获取完整参数模式、示例、延迟估计、成功率和积分费用。

qveris inspect 1 --json

步骤 03按 billing_rule

调用

在沙箱环境中执行能力。返回结构化 JSON，并在可用时附带 pre-settlement 预结算明细。最终扣费体现在你所有者的积分账本中。

qveris call 1 --params '{"city":"London"}' --json

推荐集成方式

QVeris CLI — 零 Token 工具调用

CLI（v0.5.0）是具有 Shell 访问权限的智能体最高效的集成方式。不同于 MCP 在每次提示中注入工具 Schema，CLI 以子进程方式运行 — 零 Schema Token 消耗。10,000+ 真实已验证的工具可用，无提示膨胀。新增 qveris doctor 自检、qveris usage / qveris ledger 审计、交互式登录与 API 入口自动检测。

v0.4.0@qverisai/cli

安装

curl -fsSL https://qveris.cn/cli/install | bash

或： npm install -g @qverisai/cli

认证

qveris login

智能体工作流

qveris discover "stock price API" --json
qveris inspect 1 --json
qveris call 1 --params '{"symbol":"AAPL"}' --json

完整 CLI 文档 →npm 页面 →

为什么智能体应使用 CLI 而非 MCP

▸相比 MCP 零 Schema Token — 作为子进程运行，工具注册表不进入 LLM 上下文
▸--json 标志输出结构化数据，--dry-run 验证参数不消耗积分，qveris doctor 自检
▸会话索引快捷方式 — 搜索一次，之后用索引号 inspect 1、call 2（30 分钟 TTL）
▸qveris usage / qveris ledger 审计 charge_outcome；--codegen curl|js|python 导出代码片段

使用 CLI：智能体有 exec / bash 访问权限
使用 MCP：IDE 仅支持 MCP 协议

如果你是 Hermes Agent

一条命令接入 QVeris CLI

Hermes Agent 内置 shell / terminal sandbox — 全局安装 QVeris CLI 后，qveris 命令天然出现在 sandbox 里，discover 和 call 无需任何 Hermes 侧配置。凭证写入 ~/.qveris/config 持久保存，跨 session 生效。

NEW

一次安装、一次登录，之后 Hermes 的 shell skill 直接以子进程调用 qveris discover / qveris call，相比 MCP 零 Schema Token 完成同等调用。CLI 会按 API Key 前缀自动选择合适的 API 入口。

一键安装与登录

npm install -g @qverisai/cli && qveris login

完整面板和 Prereq 在：给智能体安装 — Hermes Agent → · Hermes Agent 官方文档 →

如果你是 OpenClaw 智能体

一步安装 QVeris

你正在 OpenClaw 中运行。推荐使用插件方式 — 它在运行时注册原生工具，无论上下文长度如何都保持可用。Skill 方式是受限环境的轻量替代方案。将 YOUR_KEY 替换为你所有者提供的 API 密钥。

推荐Plugin — 通过 npm 安装

步骤 1 — 安装

openclaw plugins install @qverisai/qveris

步骤 2 — 配置（登录后自动填入密钥）

// openclaw.json
{
  "plugins": {
    "allow": ["qveris"],
    "entries": {
      "qveris": {
        "enabled": true,
        "config": { "apiKey": "YOUR_KEY" }
      }
    }
  },
  "tools": { "alsoAllow": ["qveris"] }
}

npm 页面 →

轻量Skill — 通过 ClawHub 安装

步骤 1 — 安装

openclaw skills install qveris-official

步骤 2 — 配置（登录后自动填入密钥）

// ~/.openclaw/openclaw.json → skills.entries
"qveris-official": { "enabled": true, "apiKey": "YOUR_KEY" }

ClawHub 页面 →

安装后，你可以直接调用 qveris_discover 和 qveris_call 工具。完整安装指南 →

其他集成路径

MCP、SDK 或 REST

不使用 CLI 或 OpenClaw？选择与你执行环境匹配的集成方式。

Cursor / Claude Desktop / 任意 MCP 主机

MCP 服务器

通过 npx @qverisai/mcp（v0.6.0）安装或添加到你的 mcp.json。五个工具：discover、inspect、call、usage_history、credits_ledger。前三个完成协议主流程，后两个提供 context-safe 计费审计（mode: summary / search / export_file）。

查看 MCP 配置 →

Python 智能体

Python SDK

pip install qveris。两行集成。类型化响应。异步支持。在任何 Python 执行环境中工作。

查看 Python SDK →

自定义 / 任何语言

REST API

标准 HTTP API，JSON 请求/响应。使用 Bearer 令牌认证。提供完整 OpenAPI 规范。

查看 REST API 文档 →

给你的所有者

如何向你的所有者解释 QVeris

如果你的所有者问 QVeris 是什么，可以这样回答。

“QVeris 是一个能力路由网络。它让我能够访问 10,000+ 真实已验证的工具 — 包括金融数据、文档解析、视觉 API 等 — 通过统一的发现 → 检查 → 调用协议。你需要注册一个免费的 QVeris 账户并获取 API 密钥。发现和检查永远免费。Call 按各能力的 billing_rule 计费，结算前你能看到预结算金额，最终扣费随时可在积分账本审计。”

查看定价浏览技能