← Back to Skills Marketplace
310
Downloads
3
Stars
0
Active Installs
12
Versions
Install in OpenClaw
/install life-query
Description
日常生活信息查询助手。快递物流跟踪（顺丰/圆通/中通/韵达/京东）、实时和历史汇率换算（30 种货币）、 全国各省油价查询（92/95/柴油）、全球城市天气预报（当前+多日+逐小时）。 当用户提到"查快递"、"快递单号"、"物流"、"汇率"、"换算"、"美元人民币"、"油价"、"加油"、 "92号多少钱"、"天气...
README (SKILL.md)
Life Query — 日常生活查询助手
快递物流跟踪、实时汇率换算、全国油价查询、全球天气预报。四合一日常信息查询。
前置条件
- 必需：
curl、python3（系统自带即可） - 可选：自有快递100凭证（不配也能用免费额度；配置后直连快递100，不经过第三方）
路由决策
根据用户意图选择接口，所有接口通过 bash {baseDir}/scripts/run.sh call \x3C接口名> 调用：
| 用户意图 | 接口 | 关键参数 | 备注 |
|---|---|---|---|
| 发了快递单号、问物流在哪 | courier-track |
--trackingNumber \x3C单号> |
可选 --carrierCode 指定快递公司 |
| 没给单号 | — | — | 追问用户要单号 |
| "100美元换多少人民币"、问汇率 | exchange-rate |
--from USD --to CNY --amount 100 |
默认 USD→CNY |
| "最近一周日元走势" | exchange-rate |
--from JPY --to CNY --startDate --endDate |
时间序列 |
| "今天油价多少"、"加油" | oil-price |
默认全国 | 可选 --city 北京 指定省份 |
| "北京最近几次油价调整" | oil-price |
--city 北京 --pageSize 5 |
历史记录 |
| "北京天气怎么样" | weather |
--city 北京 |
没提城市则追问 |
| "明天会下雨吗"、"这周气温" | weather |
--city \x3C城市> --days 3 |
多日预报 |
| "逐小时天气" | weather |
--city \x3C城市> --detail |
含 hourly 数据 |
| 同时问多个 | 分别调用 | — | 单个接口失败不影响其他 |
所有接口支持 --format table（人类可读）或 --format json（默认）。
调用示例
# 快递查询（自动识别快递公司）
bash {baseDir}/scripts/run.sh call courier-track --trackingNumber SF1234567890
# 汇率换算
bash {baseDir}/scripts/run.sh call exchange-rate --from CNY --to USD,EUR,JPY --amount 100
# 历史汇率走势
bash {baseDir}/scripts/run.sh call exchange-rate --from USD --to CNY --startDate 2026-03-01 --endDate 2026-03-10
# 全国油价（表格）
bash {baseDir}/scripts/run.sh call oil-price --format table
# 指定省份油价
bash {baseDir}/scripts/run.sh call oil-price --city 北京
# 天气预报（3天）
bash {baseDir}/scripts/run.sh call weather --city Shanghai --days 3 --format table
# 列出所有接口
bash {baseDir}/scripts/run.sh list
常用货币代码：CNY（人民币）、USD（美元）、EUR（欧元）、JPY（日元）、GBP（英镑）、HKD（港币）、KRW（韩元）。
错误处理
| 现象 | 处理 |
|---|---|
missing_parameter |
提示用户提供缺少的参数（单号/城市/币种） |
| curl 超时或返回非 0 | 告知用户"XX 服务暂时不可用"，建议稍后重试 |
| 单号查询返回空 data | 提示用户核实单号，建议检查位数和字母 |
| 快递公司识别失败（carrierName 为空） | 追问用户快递公司，用 --carrierCode 指定 |
| 不支持的货币代码（返回 404） | 提示检查货币代码，给出常用代码列表 |
| 城市名无法识别 | 建议换英文城市名或检查拼写 |
| python3 未安装 | 提示用户安装 python3 |
外部服务声明
| 接口 | 端点 | 发送的数据 | 凭证 |
|---|---|---|---|
| courier-track（免费） | api.fenxianglife.com |
仅快递单号 | 无 |
| courier-track（自有凭证） | poll.kuaidi100.com |
快递单号 + 签名 | 环境变量直连，不经过第三方 |
| exchange-rate | api.frankfurter.app |
货币代码、金额 | 无 |
| oil-price | datacenter-web.eastmoney.com |
省份名 | 无 |
| weather | wttr.in |
城市名 | 无 |
配置自有快递100凭证后自动切换直连通道：
export KUAIDI100_KEY=你的授权Key
export KUAIDI100_CUSTOMER=你的Customer编码
更新
npx clawhub@latest update life-query
Usage Guidance
This skill appears to do what it says: it runs local shell scripts that call the listed web APIs (frankfurter.app, wttr.in, datacenter-web.eastmoney.com) to answer user queries. Before installing, consider: 1) Privacy: if you don't provide your own KUAIDI100_KEY/CUSTOMER, package tracking numbers will be sent to api.fenxianglife.com (a third-party proxy) — review that domain's privacy/trustworthiness if you consider tracking numbers sensitive. 2) Required tools: the scripts expect curl and python3 to be available. 3) If you plan to supply KUAIDI100 credentials, only do so in a trusted environment. 4) You can review the included scripts (scripts/*.sh) yourself to confirm behavior; install only if you accept the external endpoints used or prefer to set direct credentials.
Capability Analysis
Type: OpenClaw Skill
Name: life-query
Version: 2.0.0
The 'life-query' skill provides legitimate utility for tracking packages, checking exchange rates, oil prices, and weather. The implementation follows safe coding practices, such as using Python's 'sys.argv' and environment variables to handle external data, which mitigates shell injection risks. Sensitive credentials (Kuaidi100 keys) are handled correctly, being sent only to the official service provider and not to the third-party proxy (api.fenxianglife.com) used for the free tier. No evidence of malicious intent, data exfiltration, or harmful prompt injection was found.
Capability Assessment
Purpose & Capability
Name/description (快递/汇率/油价/天气) aligns with the included scripts and declared endpoints (kuaidi100/poll, fenxianglife proxy, frankfurter.app, eastmoney, wttr.in). There are no unexpected binaries or unrelated credentials required.
Instruction Scope
Runtime instructions call local bash scripts which only perform network requests to the listed services and format output. The courier-track script will send the tracking number to api.fenxianglife.com when no KUAIDI100 credentials are set — this is coherent with the described 'free proxy' but is a privacy consideration (tracking numbers are PII-like). Scripts do not read arbitrary local files or other environment variables.
Install Mechanism
No install spec (instruction-only with bundled scripts). No downloads or archive extraction at install time; all code shipped in the skill package. Low install risk.
Credentials
No required environment variables are declared; the only optional credentials are KUAIDI100_KEY and KUAIDI100_CUSTOMER to enable direct kuaidi100 queries. That is proportionate to the courier feature. No other SECRET/TOKEN env vars are requested.
Persistence & Privilege
always is false, skill is user-invocable and not force-included. Scripts do not modify other skills or system-wide settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install life-query - After installation, invoke the skill by name or use
/life-query - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.0
合并 apis/ 到 scripts/，优化 SKILL.md 结构和双语 README
v1.7.0
安全重构：courier-track 改为双通道架构，有凭证直连快递100、无凭证走免费代理，用户 API Key 绝不经过第三方。移除 YAML 驱动引擎和 pyyaml 依赖。
v1.6.0
新增天气查询功能：支持全球城市天气（当前天气+多日预报+逐小时详情），数据源 wttr.in，零配置开箱即用
v1.5.0
description 触发词从12个扩充到23个，新增使用场景、决策流程、错误处理表、输出示例，结构全面优化
v1.4.0
完善 SKILL.md：增加决策流程图、输出示例、错误处理表、ClawHub 元数据、前置条件说明
v1.3.1
docs: 添加 changelog，记录快递查询接口修复
v1.3.0
新增汇率查询（ECB 数据源，30种货币）和全国油价查询（东方财富/发改委数据源）；快递100凭证支持环境变量配置
v1.2.1
说明免费查询额度，补充快递100自定义凭证配置指引
v1.2.0
声明外部端点 fenxianglife.com，移除 .env 文件加载逻辑，添加 homepage
v1.1.0
移除硬编码 API Key，优化 description 适配语义搜索，清理开发者内部文档
v1.0.1
- Added a Chinese-language README (README.zh.md) for improved accessibility.
- SKILL.md description updated to English for broader audience clarity; no functional changes.
v1.0.0
Initial release. Supports courier tracking via Kuaidi100 API.
Metadata
Frequently Asked Questions
What is Life Query?
日常生活信息查询助手。快递物流跟踪（顺丰/圆通/中通/韵达/京东）、实时和历史汇率换算（30 种货币）、 全国各省油价查询（92/95/柴油）、全球城市天气预报（当前+多日+逐小时）。 当用户提到"查快递"、"快递单号"、"物流"、"汇率"、"换算"、"美元人民币"、"油价"、"加油"、 "92号多少钱"、"天气... It is an AI Agent Skill for Claude Code / OpenClaw, with 310 downloads so far.
How do I install Life Query?
Run "/install life-query" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Life Query free?
Yes, Life Query is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Life Query support?
Life Query is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Life Query?
It is built and maintained by eamanc (@eamanc-lab); the current version is v2.0.0.
More Skills