适用于 Openclaw 的 Subscan API 查询技能

一种通过 Subscan API 查询多链区块链数据的专业 AI 技能，具有自动端点路由和智能错误处理功能。

carlhong

v1.0.0

2026年4月14日

安装

基本信息

Skill.md

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。


                  npx clawhub@latest install subscan-api

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式

~/.openclaw/skills/

工作区

<project>/skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。


                  请帮我使用 Clawhub 安装 subscan-api。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

更倾向于下载？

获取包含原生技能文件的ZIP压缩包。

什么是 Subscan API 查询技能？

Subscan API 查询技能是一个复杂的集成工具，旨在将自然语言提示转换为精确的区块链数据查询。它充当用户与 Subscan 索引的大量数据之间的桥梁，支持 Polkadot、Ethereum 和 Kusama 等多个网络上的 185 个以上端点。通过利用本地化的 swagger 文档和优化的路由表，它确保技术查询能以高精度和高速度得到解析。

该技能专为开发人员和研究人员打造，自动化了手动 API 调用的复杂性。它处理从 API key 管理和网络名称规范化到复杂的 JSON 正文构建的所有事务。无论您是在寻找特定的交易哈希、账户余额还是治理详情，此 Openclaw Skills 组件都为链上探索提供了一个简化的界面。

Subscan API 查询技能应用场景

跨不同区块链网络跟踪实时转账和交易。
获取详细的账户信息、质押奖励和余额历史记录。
监控治理提案、投票状态和链上身份数据。
出于调试或研究目的审计特定区块详情和外部数据。

Subscan API 查询技能工作原理

该技能检查本地保存的 Subscan API key，如果没有找到，则提示在 pro.subscan.io 注册。
它分析用户的自然语言请求，将关键词与高频路由表 (routing.yaml) 进行匹配。
如果在快速路径中没有找到匹配项，它将回退到完整的 Swagger 目录以识别正确的 API 端点。
它识别所需的参数，询问用户缺失的信息（一次一个字段），并规范化网络名称（例如，将 'dot' 转换为 'polkadot'）。
该技能通过 Python 脚本执行身份验证后的请求并处理原始 JSON 响应。
数据被格式化为可读的 Markdown 表格或对象列表呈现给用户，并内置了针对速率限制或网络抖动的自动重试逻辑。

Subscan API 查询技能配置指南

要开始使用 Subscan API 技能，请确保您拥有来自 Subscan Pro 门户的 API key。将该技能安装到您的环境中，并使用以下命令配置您的凭据：

# 检查 API key 是否已配置
python3 "$SKILL_DIR/scripts/subscan_api.py" check-key

# 保存新的 API key
python3 "$SKILL_DIR/scripts/subscan_api.py" save-key <YOUR_SUBSCAN_API_KEY>

Subscan API 查询技能数据架构与分类体系

该技能利用结构化参考系统来确保准确性并最大限度地减少延迟。数据组织如下：

文件	描述
`routing.yaml`	将关键词映射到特定 API 路由的高频查找表。
`endpoint-details.yaml`	包含参数要求、正文模板和优先响应 key。
`swagger.yaml`	用于回退的所有 185+ 个受支持 Subscan 端点的综合目录。
`subscan_api.py`	处理 CLI 交互和 HTTP 请求的核心执行脚本。