OpenClaw 配置 QVeris 全能力指南【金融分析篇】

{  "tools": {    "web": {      "search": {        "enabled": true,        "provider": "qveris"      },      "fetch": {        "enabled": true      }    },    "qveris": {      "enabled": true,      "region": "global"    }  },  "plugins": {    "load": {      "paths": [        "/app/extensions/feishu",        "/root/.openclaw/skills"      ]    },    "entries": {      "feishu": {        "enabled": true      }    }  }}

~/.openclaw/skills/├── qveris-official/           # QVeris 官方 Skill│   └── qveris-official/│       ├── SKILL.md           # Skill 文档│       ├── package.json│       └── scripts/│           ├── qveris_tool.mjs      # 主 CLI 工具│           ├── qveris_client.mjs    # HTTP 客户端│           └── qveris_env.mjs       # 环境变量读取└── ai-quant-analysis/         # 其他 Skill

# 1. 进入 skills 目录cd ~/.openclaw/skills/# 2. 克隆 QVeris Skillgit clone https://github.com/QVerisAI/open-qveris-skills.git qveris-official# 3. 验证安装ls -la ~/.openclaw/skills/qveris-official/qveris-official/scripts/

# QVeris API Key（从 https://qveris.ai 获取）export QVERIS_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"# 添加到 ~/.bashrc 或 ~/.zshrc 使其持久化echo 'export QVERIS_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"' >> ~/.bashrcsource ~/.bashrc

# 使用 Docker 环境变量（推荐）# 在 docker-compose.yml 或 Dockerfile 中设置environment:  - QVERIS_API_KEY=${QVERIS_API_KEY}# 验证环境变量echo $QVERIS_API_KEY | head -c 20 && echo "..."

# 1. 发现工具node ~/.openclaw/skills/qveris-official/qveris-official/scripts/qveris_tool.mjs \  discover "<capability_description>"# 2. 调用工具node ~/.openclaw/skills/qveris-official/qveris-official/scripts/qveris_tool.mjs \  call <tool_id> \  --discovery-id <discovery_id> \  --params '<json_params>'# 3. 检查工具详情node ~/.openclaw/skills/qveris-official/qveris-official/scripts/qveris_tool.mjs \  inspect <tool_id>

# QVerisClaw 行为规范## 一、数据获取优先级（重要！）### 1.1 首选工具：QVeris数据获取优先级：1. QVeris 工具（首选）✅   - 实时行情：ths_ifind.real_time_quotation.v1   - 融资融券：ths_ifind.margin_trading.v1   - 资金流向：ths_ifind.money_flow.v1   - Web搜索：xiaosu.smartsearch.search.retrieve.v22. Web Fetch（次选）   - 当QVeris无对应工具时使用3. 原生 Web Search（最后）   - 当以上都不可用时使用### 1.2 执行流程每次需要数据时：Step 1: 使用 QVeris discover 查找工具   ↓Step 2: 如找到，使用 QVeris call 调用   ↓Step 3: 如未找到或调用失败，使用 Web Fetch   ↓Step 4: 如仍失败，使用原生 Web Search   ↓Step 5: 记录数据来源，标注可靠性## 二、数据来源标注规范✅ 【QVeris实时数据】- 最可靠，优先使用⏰ 【数据时间】- 注明数据时间戳⚠️ 【Web数据】- 可能有延迟📰 【搜索数据】- 仅供参考5.2 Agent 启动流程 ~/workspace/AGENTS.md## Session StartupBefore doing anything else:1. Read SOUL.md — this is who you are2. Read USER.md — this is who you're helping3. Read memory/YYYY-MM-DD.md (today + yesterday) for recent context4. If in MAIN SESSION: Also read MEMORY.md5. Read 行为规范.md — 加载核心行为规范（数据获取优先级等）6. 运行启动检查脚本 — bash /root/.openclaw/workspace/startup_check.sh7. 验证 QVeris 工具可用 — 确保数据获取能力正常

# Step 1: 发现工具discovery_result=$(node ~/.openclaw/skills/qveris-official/qveris-official/scripts/qveris_tool.mjs \  discover "China A-share real-time stock market data API" \  --json)discovery_id=$(echo $discovery_result | jq -r '.search_id')tool_id="ths_ifind.real_time_quotation.v1"# Step 2: 调用工具node ~/.openclaw/skills/qveris-official/qveris-official/scripts/qveris_tool.mjs \  call $tool_id \  --discovery-id $discovery_id \  --params '{"symbols": ["000001.SZ", "600000.SH"]}'

# Step 1: 发现搜索工具discovery_result=$(node ~/.openclaw/skills/qveris-official/qveris-official/scripts/qveris_tool.mjs \  discover "web search API" \  --json)discovery_id=$(echo $discovery_result | jq -r '.search_id')# Step 2: 调用国内搜索node ~/.openclaw/skills/qveris-official/qveris-official/scripts/qveris_tool.mjs \  call xiaosu.smartsearch.search.retrieve.v2.6c50f296_domestic \  --discovery-id $discovery_id \  --params '{"q":"人工智能行业最新动态","count":10,"freshness":"week","enableContent":true}'

// 在 Agent 代码中调用 QVerisconst { execSync } = require('child_process');function qverisDiscover(query) {  const result = execSync(    `node ~/.openclaw/skills/qveris-official/qveris-official/scripts/qveris_tool.mjs discover "${query}" --json`,    { encoding: 'utf-8' }  );  return JSON.parse(result);}function qverisCall(toolId, discoveryId, params) {  const result = execSync(    `node ~/.openclaw/skills/qveris-official/qveris-official/scripts/qveris_tool.mjs call ${toolId} --discovery-id ${discoveryId} --params '${JSON.stringify(params)}' --json`,    { encoding: 'utf-8' }  );  return JSON.parse(result);}// 使用示例const discovery = qverisDiscover("stock price API");const toolId = discovery.results[0].tool_id;const result = qverisCall(toolId, discovery.search_id, { symbol: "AAPL" });

QVERIS_API_KEY not set原因：环境变量未配置解决方案：export QVERIS_API_KEY="..."HTTP 401 Unauthorized原因：API Key 无效解决方案：检查 Key 是否正确，从官网重新获取No tools found原因：查询描述不准确解决方案：使用英文能力描述，如 "stock price API"tool execution failed原因：参数错误解决方案：检查参数类型和格式，参考示例参数Request timed out原因：网络或工具响应慢解决方案：增加 --timeout 参数

# 1. 检查环境变量echo $QVERIS_API_KEY | head -c 20 && echo "..."# 2. 检查 Skill 安装ls -la ~/.openclaw/skills/qveris-official/# 3. 测试工具发现node ~/.openclaw/skills/qveris-official/qveris-official/scripts/qveris_tool.mjs \  discover "weather forecast API"# 4. 检查 OpenClaw 配置openclaw status# 5. 查看网关日志openclaw logs --follow

// tools-cache.json{  "stock_realtime": {    "tool_id": "ths_ifind.real_time_quotation.v1",    "last_verified": "2026-03-18T00:00:00Z"  },  "search_domestic": {    "tool_id": "xiaosu.smartsearch.search.retrieve.v2.6c50f296_domestic",    "last_verified": "2026-03-18T00:00:00Z"  }}

{  "tools": {    "qveris": {      "enabled": true,      "region": "global",      "fallback_regions": ["ap-southeast-1", "us-west-2"]    }  }}

# 1. 配置文件中使用环境变量引用{  "qveris": {    "apiKey": "${QVERIS_API_KEY}"  }}# 2. 日志中自动掩码# 所有包含 API Key 的日志输出自动隐藏# 显示格式: sk-xxxxxxxx...# 3. 禁止在代码中硬编码# 错误: const apiKey = "sk-xxx..."# 正确: const apiKey = process.env.QVERIS_API_KEY