OpenClaw 安装指南

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

前置条件

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

方式一：插件推荐

插件方式将 QVeris 工具注册为原生 OpenClaw 工具 原生 OpenClaw 工具 ，在运行时生效。工具注册在运行时环境中而非提示上下文中，因此无论对话多长都能保持可用，不会争抢上下文窗口空间。支持显式区域配置 (global 对应 qveris.ai, cn 对应 qveris.cn) ，发布为 @qverisai/qveris。

第 1 步 — 安装插件

openclaw plugins install @qverisai/qveris

第 2 步 — 配置 openclaw.json

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

{
  "plugins": {
    "allow": ["qveris"],
    "entries": {
      "qveris": {
        "enabled": true,
        "config": {
          "apiKey": "YOUR_KEY",
          "region": "global"
        }
      }
    }
  },
  "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", region: "global" } }, 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 强制执行	仅靠智能体记忆
区域配置	显式指定（global / cn）	通过 API 密钥
适用场景	生产使用、长会话、高可靠性	快速试用、无 npm 环境

链接

OpenClaw 安装指南

前置条件

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

方式一：插件推荐

第 1 步 — 安装插件

openclaw plugins install @qverisai/qveris

第 2 步 — 配置 openclaw.json

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

{
  "plugins": {
    "allow": ["qveris"],
    "entries": {
      "qveris": {
        "enabled": true,
        "config": {
          "apiKey": "YOUR_KEY",
          "region": "global"
        }
      }
    }
  },
  "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", region: "global" } }, 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 强制执行	仅靠智能体记忆
区域配置	显式指定（global / cn）	通过 API 密钥
适用场景	生产使用、长会话、高可靠性	快速试用、无 npm 环境

OpenClaw 安装指南

前置条件

方式一：插件 推荐

第 1 步 — 安装插件

第 2 步 — 配置 openclaw.json

为什么推荐插件

智能体一句话指令

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

第 1 步 — 安装技能

第 2 步 — 添加 API 密钥

智能体一句话指令

验证

插件 vs 技能 — 对比

链接

方式一：插件推荐

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