QVeris
快速入门实践指南命令行工具Python SDK 指南Python SDK API 参考TypeScript SDK 指南TypeScript SDK API 参考MCP 服务器REST API 参考编辑器与命令行配置OpenClaw 配置Codex 与 ChatGPT 桌面端配置Claude Code 配置OpenCode 配置

OpenClaw 安装指南

QVeris 集成 OpenClaw 有两种方式： Plugin （运行时，通过 npm — 推荐）或 Skill （纯指令，通过 ClawHub — 轻量替代方案）。两种方式都能让你的智能体通过 Discover → Inspect → Call 协议访问 10,000+ 真实已验证的能力。

前置条件

  • OpenClaw 已安装
  • QVeris API 密钥 — 前往 控制台/API密钥 获取（有免费额度）
  • Node.js（插件方式必需；技能方式可选）

方式一：插件 推荐

插件方式将 QVeris 工具注册为原生 OpenClaw 工具 原生 OpenClaw 工具 ，在运行时生效。工具注册在运行时环境中而非提示上下文中，因此无论对话多长都能保持可用，不会争抢上下文窗口空间，并使用显式配置的 API 入口。 ，发布为 @qverisai/qveris。

第 1 步 — 安装插件

openclaw plugins install @qverisai/qveris

第 2 步 — 配置 openclaw.json

将插件配置添加到你的 openclaw.json：

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

这里做了三件事：

  • plugins.allow — 允许插件运行
  • plugins.entries.qveris — 配置 API 密钥
  • tools.alsoAllow — 让 QVeris 工具对智能体可见

为什么推荐插件

  • 无上下文竞争 — 工具注册在运行时中，而非注入到提示中。即使在长对话中也始终可用。
  • 类型化工具调用 — 参数通过 JSON Schema 校验，减少幻觉或格式错误的参数。
  • 自动会话状态 — 插件自动在 discover → inspect → call 序列中跟踪 search_id。
  • 模型无关 — 在所有 LLM 提供商上表现一致；不依赖模型的指令遵循能力。

智能体一句话指令

复制此提示并粘贴给你的 OpenClaw 智能体（登录后可自动填充 API 密钥）：

Install QVeris plugin: openclaw plugins install @qverisai/qveris, then configure plugins.allow: ["qveris"], plugins.entries.qveris: { enabled: true, config: { apiKey: "YOUR_KEY" } }, and tools.alsoAllow: ["qveris"] in openclaw.json

方式二：技能 轻量替代方案

技能方式是纯指令型的 — 通过注入提示文本教 OpenClaw 如何使用 QVeris，无需添加运行时依赖。技能托管在 ClawHub 上，经过 OpenClaw 安全扫描器审核。

注意：由于技能通过向智能体上下文窗口注入指令工作，在非常长的对话中或与多个其他技能竞争时可能被「遗忘」。为生产环境可靠性，我们推荐上述插件方式。

第 1 步 — 安装技能

openclaw skills install qveris-official

第 2 步 — 添加 API 密钥

编辑 ~/.openclaw/openclaw.json 并添加技能配置：

{
  "skills": {
    "entries": {
      "qveris-official": {
        "enabled": true,
        "apiKey": "YOUR_KEY"
      }
    }
  }
}

智能体一句话指令

复制此提示并粘贴给你的 OpenClaw 智能体（登录后可自动填充 API 密钥）：

Install QVeris skill: openclaw skills install qveris-official, then add "qveris-official": { "enabled": true, "apiKey": "YOUR_KEY" } to skills.entries in ~/.openclaw/openclaw.json

验证

安装完成后（任一方式），向你的智能体提问验证：

Use qveris_discover to search for "stock quote API"

如果智能体返回包含工具 ID、描述和成功率的候选工具列表，则集成成功。

插件 vs 技能 — 对比

 Plugin ✦Skill
工作方式运行时注册原生工具智能体读取指令，调用 HTTP API
上下文竞争无 — 工具在运行时中可能被其他提示覆盖
依赖Node.js + npm 包无
参数校验JSON Schema 强制执行仅靠智能体记忆
API 入口配置显式配置 Base URL显式配置 Base URL
适用场景生产使用、长会话、高可靠性快速试用、无 npm 环境

链接