OpenClaw 使用说明

说明

本页供在 OpenClaw（或同类支持「自定义 HTTP / HTTPS 请求」的智能体、插件、工作流）中对接 量脉金融数据平台 时使用。业务接口的别名、路径参数、查询参数与返回字段，以开发者文档与 API 接口目录为准；此处只固定网关形态与推荐配置习惯。

当前文档地址（可收藏）：https://api.level2.vip/openclaw

网关约定（与 /docs 一致）

统一通过 HTTPS 访问网关，使用发放的 token 与业务别名 api，以及各接口要求的业务参数。成功时 JSON 中 code === 0，业务数据多在 data 字段。

网关地址：

POST https://api.level2.vip/api/gateway
Content-Type: application/x-www-form-urlencoded
（或等价的 query 拼接；与开发者文档说明一致）

在 OpenClaw 中的推荐配置思路

将「基础 URL / 根地址」设为当前站点根，例如 https://api.level2.vip；实际请求路径为 /api/gateway。
将平台 Token 存于 OpenClaw 的「密钥 / 环境变量」类配置中，勿写进可被他人读取的公开仓库或日志。
每次调用在 body 或 query 中携带 token、api，再附带该 api 所需的业务参数（如 ts_code、date 等），命名与接口目录中一致。
若 OpenClaw 支持「执行 Python / 自定义脚本」，可直接按本页「Python（requests）传参」一节使用 params（GET）或 data（POST 表单）携带 token、api 与业务参数。
若 OpenClaw 支持「工具描述」，建议写明：仅允许 GET/POST 至本站网关、禁止把 Token 转发到第三方域名。

最小请求示例

将 YOUR_TOKEN 换成真实 Token；api 换成你要调用的别名（示例为 stock_realtime）。

curl -sS "https://api.level2.vip/api/gateway" \
  -d "token=YOUR_TOKEN" \
  -d "api=stock_realtime" \
  -d "ts_code=600519"

Python（requests）传参 — 给 OpenClaw 内脚本 / 工具用

若 OpenClaw 支持执行 Python，可用官方 requests 库：网关固定为下方 GATEWAY；每次请求必须带 token、api，其余键名与接口目录 / 开发者文档中该接口一致。

GET：业务参数放在 params={...}，会编码进 URL 查询串（与文档里「query」试调等价）。
POST：使用 data={...}（默认即 application/x-www-form-urlencoded），与上方 curl -d 等价。
建议 Token 从环境变量读取（如 os.environ["LIANGMAI_TOKEN"]），勿硬编码进可被导出的对话或仓库。

import os
import requests

GATEWAY = "https://api.level2.vip/api/gateway"
TOKEN = os.environ.get("LIANGMAI_TOKEN", "YOUR_TOKEN")

# 方式一：GET + query 参数（常用，易排查 URL）
r = requests.get(
    GATEWAY,
    params={
        "token": TOKEN,
        "api": "stock_realtime",
        "ts_code": "600519",
    },
    timeout=30,
)
j = r.json()
print("HTTP", r.status_code, "code", j.get("code"), "keys", list(j.keys()))

# 方式二：POST + 表单 body（与 curl -d 一致）
r2 = requests.post(
    GATEWAY,
    data={
        "token": TOKEN,
        "api": "stock_realtime",
        "ts_code": "600519",
    },
    timeout=30,
)
print(r2.json())

若 OpenClaw 仅允许填「URL + 原始 Body」，可把 token、api 及业务参数拼成 application/x-www-form-urlencoded 一行，或改用 GET 并把键值放进查询串。其他接口只需改 api 与 params/data 内字段，仍以文档为准。

错误与排查

常见 code：401（Token 无效或过期）、404（别名未开放）、422（缺参）、429（限流或 IP 策略）等，详见开发者文档底部「常见错误码」与试调说明。

若 OpenClaw 侧报 TLS、超时或 DNS 错误，请在本机或部署环境用同一 URL 先 curl 验证，再检查代理与防火墙。

量脉金融数据平台 · /openclaw