← Back to Skills Marketplace
655
Downloads
2
Stars
2
Active Installs
3
Versions
Install in OpenClaw
/install metric-query
Description
构建指标平台（语义层）的指标数据查询 API 请求。当用户需要查询指标数据、构造指标查询API请求体、使用同环比/占比/排名/时间限定等快速计算、定义临时指标、设置维度筛选过滤条件时，必须使用此 Skill。 触发场景包括但不限于：用户提到"查询指标"、"指标API"、"指标数据"、"语义层查询"、"metric...
Usage Guidance
Before installing, confirm you trust aloudata.com and are comfortable storing a CAN_API_KEY for the Gateway in your agent environment. This skill will read that env var and make outbound requests to gateway.can.aloudata.com to discover metrics and execute queries — ensure the API key has appropriate (least) privileges and rotate it if you suspect misuse. If you do not use Aloudata CAN, do not provide a CAN_API_KEY. Monitor network activity and API usage for unexpected calls.
Capability Analysis
Type: OpenClaw Skill
Name: metric-query
Version: 1.0.2
The metric-query skill bundle is a legitimate tool designed to help an AI agent construct complex JSON payloads for the Aloudata CAN metrics gateway API. It contains extensive documentation and 'iron rules' to ensure the agent generates valid queries, handles relative time correctly using NOW(), and avoids common logic errors in data analysis. While the skill requires 'env:read' for an API key and 'network:outbound' to 'gateway.can.aloudata.com', these permissions are strictly aligned with its stated purpose, and no evidence of data exfiltration, malicious execution, or harmful prompt injection was found in SKILL.md or _meta.json.
Capability Assessment
Purpose & Capability
Name/description match the runtime instructions: the SKILL.md describes how to discover metrics/dimensions via the Aloudata CAN Gateway and then construct the metrics query JSON. The declared requirement (CAN_API_KEY) and the domain whitelist (gateway.can.aloudata.com) are exactly what this purpose needs.
Instruction Scope
SKILL.md instructs only to call the Gateway search and query endpoints, read the CAN_API_KEY env var, and construct JSON per a clear set of rules. It does not instruct reading unrelated files, other env vars, or sending data to endpoints outside gateway.can.aloudata.com. The doc explicitly forbids guessing metric names and mandates Gateway lookups first.
Install Mechanism
Instruction-only skill with no install spec and no code files — nothing is written to disk or downloaded during install, which minimizes installation risk.
Credentials
Only one required environment variable (CAN_API_KEY) is declared and used; this is expected for authenticating to the Gateway. The SKILL.md documents where the user should store the key (~/.openclaw/.env). There are no additional unrelated credentials requested.
Persistence & Privilege
always is false and the skill is user-invocable; autonomous invocation is allowed (platform default). The skill does not request permanent/system-wide privileges or attempt to modify other skills or agent configs.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install metric-query - After installation, invoke the skill by name or use
/metric-query - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
No functional changes introduced in this version.
- Updated SKILL.md to add explicit metadata fields: permissions, env_vars, domain_whitelist, version, author, homepage, metadata.openclaw.
- No code or logic modifications.
- No API or behavior changes.
v1.0.1
**Changelog for metric-query 1.0.1**
- Added _meta.json for enhanced metadata management.
- Gateway API Key使用方法更正：示例命令改为从环境变量 $CAN_API_KEY 读取，而非硬编码为 {your-api-key}，需在本地配置 .env 文件。
- 优化文档内容，细化了 curl 用法示例，强调所有调用必须使用环境变量方式传递 API Key。
v1.0.0
Initial release of metric-query: an API skill for metric data querying.
- Enables construction of metric data query API requests, including defining temporary metrics, filters, time constraints, quick calculations (YoY/MoM/Proportion/Ranking), and dimensional filtering.
- Must use Gateway API to search for metric and dimension info before building any query—strictly prohibits guessing names from memory.
- Comprehensive rules (九条铁律) ensure correct JSON formation, API usage, and prevent logical/query errors (e.g., date handling, metric registration, calculation chaining, filter misuse, etc.).
- Rejects any query if metric/dimension context is insufficient or user intention doesn't match a data query.
- Provides detailed API examples and strict guidelines for building requests and using authentication.
Metadata
Frequently Asked Questions
What is Aloudata CAN SKILLS - metric-query?
构建指标平台（语义层）的指标数据查询 API 请求。当用户需要查询指标数据、构造指标查询API请求体、使用同环比/占比/排名/时间限定等快速计算、定义临时指标、设置维度筛选过滤条件时，必须使用此 Skill。 触发场景包括但不限于：用户提到"查询指标"、"指标API"、"指标数据"、"语义层查询"、"metric... It is an AI Agent Skill for Claude Code / OpenClaw, with 655 downloads so far.
How do I install Aloudata CAN SKILLS - metric-query?
Run "/install metric-query" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Aloudata CAN SKILLS - metric-query free?
Yes, Aloudata CAN SKILLS - metric-query is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Aloudata CAN SKILLS - metric-query support?
Aloudata CAN SKILLS - metric-query is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Aloudata CAN SKILLS - metric-query?
It is built and maintained by jackyujun (@jackyujun); the current version is v1.0.2.
More Skills