{"id":"a20f559d-21c9-4771-b081-7354efdd5458","entityType":"agent","slug":"clawhub-yinguobing-qweather-skill","name":"和风天气","canonicalUrl":"https://www.xpersona.co/agent/clawhub-yinguobing-qweather-skill","canonicalPath":"/agent/clawhub-yinguobing-qweather-skill","generatedAt":"2026-10-11T17:44:47.545Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T13:54:54.935Z","emptyReason":null},"description":"查询全球城市或者经纬度位置的实时天气、天气预报、空气质量等信息的技能。当用户询问某个城市或者经纬度的天气、气温、降雨、风向、空气质量时调用。 Skill: 和风天气 Owner: yinguobing Summary: 查询全球城市或者经纬度位置的实时天气、天气预报、空气质量等信息的技能。当用户询问某个城市或者经纬度的天气、气温、降雨、风向、空气质量时调用。 Tags: latest:0.5.0 Version history: v0.5.0 | 2026-04-24T10:44:22.465Z | user Version 0.5.0 introduces improved geographic flexibility and documentation updates. - 支持通过经纬度查询全球位置天气，描述文本及参数说明中均已补充（不仅限城市）。 - 新增 geo reverse（经纬度反查行政区划）命令行用法示例。 - 说明文档精简了安装方法；curl+install.sh 安装指引移至官方文档。 - description 字段更新，明确支持城市或经纬度查","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s17agm6vdkdqvmtmkvr7f6xvzn84sj6s:qweather-skill","sourceUrl":"https://clawhub.ai/yinguobing/qweather-skill","homepage":"https://clawhub.ai/yinguobing/skills/qweather-skill","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/yinguobing/qweather-skill","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/yinguobing/skills/qweather-skill","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"查询全球城市或者经纬度位置的实时天气、天气预报、空气质量等信息的技能。当用户询问某个城市或者经纬度的天气、气温、降雨、风向、空气质量时调用。 Skill: 和风天气 Owner: yinguobing Summary: 查询全球城市或者经纬度位置的实时天气、天气预报、空气质量等信息的技能。当用户询问某个城市或者经纬度的"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T13:54:54.935Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T13:54:54.935Z","emptyReason":null},"stars":null,"forks":null,"downloads":1054,"packageName":null,"latestVersion":"0.5.0","tractionLabel":"1.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T13:54:54.924Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T13:54:54.935Z","lastCrawledAt":"2026-10-11T13:54:54.924Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T13:54:54.924Z","lastVerifiedAt":null,"highlights":[{"version":"0.5.0","createdAt":"2026-04-24T10:44:22.465Z","changelog":"Version 0.5.0 introduces improved geographic flexibility and documentation updates. - 支持通过经纬度查询全球位置天气，描述文本及参数说明中均已补充（不仅限城市）。 - 新增 geo reverse（经纬度反查行政区划）命令行用法示例。 - 说明文档精简了安装方法；curl+install.sh 安装指引移至官方文档。 - description 字段更新，明确支持城市或经纬度查询。","fileCount":3,"zipByteSize":3673},{"version":"0.4.0","createdAt":"2026-04-20T14:56:36.709Z","changelog":"**Command-line interface (CLI) structure updated for improved usability and flexibility** - CLI entry point renamed from qweather to qw; all commands and help now reference qw. - Command structure refactored to use commands and subcommands (e.g., weather now, weather daily, geo city-lookup) replacing global flag-based dispatch. - Binary install path updated to provide qw (not qweather) after installation. - All main query types (weather, grid, air, indices, geo, etc.) now use consistent subcommand syntax and explicit argument patterns. - Added multiple ways to specify location: --city, --location-id, or --lon/--lat; these options are mutually exclusive. - Documentation, examples, and quick-reference sections fully updated to match the new CLI structure.","fileCount":2,"zipByteSize":2472},{"version":"0.3.1","createdAt":"2026-04-19T14:40:45.158Z","changelog":"- Renamed skill from qweather-skill to qweather. - Upgraded version from 0.2.0 to 0.3.0. - Switched installation method to Cargo and provided curl + shell installer; removed pip-related instructions. - Updated authentication to require JWT environment variables and removed API key fallback. - Changed primary credential to QWEATHER_PRIVATE_KEY. - Updated CLI command from qweather-skill to qweather. - Removed Python API documentation and instructions; CLI documentation only. - Adjusted install metadata to use Cargo.","fileCount":2,"zipByteSize":2160},{"version":"0.1.1","createdAt":"2026-04-16T12:55:00.497Z","changelog":"- Added missing version, homepage, and metadata fields to SKILL.md. - Declared required environment variables and primary credential for better environment and deployment management. - No changes to core functionality or code; documentation and metadata updates only.","fileCount":3,"zipByteSize":2991},{"version":"0.1.0","createdAt":"2026-04-16T12:30:08.911Z","changelog":"qweather-skill v0.1.0 - Initial release with global city real-time weather, forecast, and air quality queries via command line. - Supports both JWT and API KEY authentication, configured by environment variables. - Provides rich CLI commands: realtime weather, daily/hourly forecasts, minutely precipitation (China-only), air quality, indices, warnings, sun/moon/solar info, and grid weather. - Flexible query parameters (e.g., --type, --days, --hours, --date, --tz, --alt) with clear usage limits by type. - Advanced features (POI search, air monitoring stations) available via Python API only.","fileCount":3,"zipByteSize":2756}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17agm6vdkdqvmtmkvr7f6xvzn84sj6s:qweather-skill","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yinguobing-qweather-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yinguobing-qweather-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yinguobing-qweather-skill/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-yinguobing-qweather-skill/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-yinguobing-qweather-skill/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-yinguobing-qweather-skill/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T17:44:47.545Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yinguobing-qweather-skill/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yinguobing-qweather-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yinguobing-qweather-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-yinguobing-qweather-skill/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T13:54:54.935Z","emptyReason":null},"readme":"Skill: 和风天气\n\nOwner: yinguobing\n\nSummary: 查询全球城市或者经纬度位置的实时天气、天气预报、空气质量等信息的技能。当用户询问某个城市或者经纬度的天气、气温、降雨、风向、空气质量时调用。\n\nTags: latest:0.5.0\n\nVersion history:\n\nv0.5.0 | 2026-04-24T10:44:22.465Z | user\n\nVersion 0.5.0 introduces improved geographic flexibility and documentation updates.\n\n- 支持通过经纬度查询全球位置天气，描述文本及参数说明中均已补充（不仅限城市）。\n- 新增 geo reverse（经纬度反查行政区划）命令行用法示例。\n- 说明文档精简了安装方法；curl+install.sh 安装指引移至官方文档。\n- description 字段更新，明确支持城市或经纬度查询。\n\nv0.4.0 | 2026-04-20T14:56:36.709Z | user\n\n**Command-line interface (CLI) structure updated for improved usability and flexibility**\n\n- CLI entry point renamed from qweather to qw; all commands and help now reference qw.\n- Command structure refactored to use commands and subcommands (e.g., weather now, weather daily, geo city-lookup) replacing global flag-based dispatch.\n- Binary install path updated to provide qw (not qweather) after installation.\n- All main query types (weather, grid, air, indices, geo, etc.) now use consistent subcommand syntax and explicit argument patterns.\n- Added multiple ways to specify location: --city, --location-id, or --lon/--lat; these options are mutually exclusive.\n- Documentation, examples, and quick-reference sections fully updated to match the new CLI structure.\n\nv0.3.1 | 2026-04-19T14:40:45.158Z | user\n\n- Renamed skill from qweather-skill to qweather.\n- Upgraded version from 0.2.0 to 0.3.0.\n- Switched installation method to Cargo and provided curl + shell installer; removed pip-related instructions.\n- Updated authentication to require JWT environment variables and removed API key fallback.\n- Changed primary credential to QWEATHER_PRIVATE_KEY.\n- Updated CLI command from qweather-skill to qweather.\n- Removed Python API documentation and instructions; CLI documentation only.\n- Adjusted install metadata to use Cargo.\n\nv0.1.1 | 2026-04-16T12:55:00.497Z | user\n\n- Added missing version, homepage, and metadata fields to SKILL.md.\n- Declared required environment variables and primary credential for better environment and deployment management.\n- No changes to core functionality or code; documentation and metadata updates only.\n\nv0.1.0 | 2026-04-16T12:30:08.911Z | user\n\nqweather-skill v0.1.0\n\n- Initial release with global city real-time weather, forecast, and air quality queries via command line.\n- Supports both JWT and API KEY authentication, configured by environment variables.\n- Provides rich CLI commands: realtime weather, daily/hourly forecasts, minutely precipitation (China-only), air quality, indices, warnings, sun/moon/solar info, and grid weather.\n- Flexible query parameters (e.g., --type, --days, --hours, --date, --tz, --alt) with clear usage limits by type.\n- Advanced features (POI search, air monitoring stations) available via Python API only.\n\nArchive index:\n\nArchive v0.5.0: 3 files, 3673 bytes\n\nFiles: skill-card.md (2177b), SKILL.md (4874b), _meta.json (133b)\n\nFile v0.5.0:SKILL.md\n\n---\nname: qweather\nversion: 0.5.0\ndescription: 查询全球城市或者经纬度位置的实时天气、天气预报、空气质量等信息的技能。当用户询问某个城市或者经纬度的天气、气温、降雨、风向、空气质量时调用。\nhomepage: https://github.com/yinguobing/qweather-skill\nrequired_env_vars:\n  - QWEATHER_KID\n  - QWEATHER_PROJECT_ID\n  - QWEATHER_PRIVATE_KEY\n  - QWEATHER_BASE_URL\n  - QWEATHER_GEO_URL\nprimary_credential: QWEATHER_PRIVATE_KEY\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"QWEATHER_KID\",\"QWEATHER_PROJECT_ID\",\"QWEATHER_PRIVATE_KEY\",\"QWEATHER_BASE_URL\",\"QWEATHER_GEO_URL\"]},\"primaryEnv\":\"QWEATHER_PRIVATE_KEY\",\"homepage\":\"https://github.com/yinguobing/qweather-skill\",\"install\":[{\"id\":\"qweather\",\"kind\":\"cargo\",\"package\":\"qweather\",\"bins\":[\"qw\"],\"label\":\"Install qweather via cargo\"}]}}\n---\n\n# 和风天气查询技能\n\n基于和风天气（QWeather）API，提供全球城市的天气查询能力。\n\n## 安装\n使用Cargo安装：\n```bash\ncargo install qweather\n```\n\n源码安装\n```bash\ncargo install --git https://github.com/yinguobing/qweather-skill.git\n```\n\n如果需要使用curl + install.sh安装请参考官方文档：\n```url\nhttps://github.com/yinguobing/qweather-skill\n```\n\n## 身份认证\n\n使用 JWT 身份认证，**必须**配置以下环境变量：\n\n```bash\nexport QWEATHER_KID=\"YOUR_KID\"\nexport QWEATHER_PROJECT_ID=\"YOUR_PROJECT_ID\"\nexport QWEATHER_PRIVATE_KEY=\"/path/to/qweather/private.pem\"\nexport QWEATHER_BASE_URL=\"https://your-host.qweatherapi.com/v7\"\nexport QWEATHER_GEO_URL=\"https://your-host.qweatherapi.com/geo/v2\"\n```\n\n详情可在[和风天气控制台](https://console.qweather.com/project)获取。\n\n## CLI 使用\n\n全局入口为 `qw`。通过命令+子命令提供具体功能。\n\n### 常用查询\n\n```bash\n# 地理位置\nqw geo city-lookup 北京\nqw geo reverse --lon 113.4695 --lat 23.1895    # 经纬度反查行政区划\nqw geo top-city --range cn\nqw geo poi-lookup 故宫 --type scenic\nqw geo poi-range 116.40,39.90 --type scenic --radius 10\n\n# 实时天气\nqw weather now --city 北京\n\n# 未来N天预报（daily 仅支持 3,7,10,15,30）\nqw weather daily --city 北京\nqw weather daily 7 --city 北京\n\n# 逐小时预报（hourly 仅支持 24,72,168）\nqw weather hourly --city 北京\nqw weather hourly 72 --city 北京\n\n# 格点天气（基于经纬度的高分辨率数据）\nqw grid now --lon 116.40 --lat 39.90\nqw grid daily --lon 116.40 --lat 39.90\nqw grid daily 7 --lon 116.40 --lat 39.90\nqw grid hourly --lon 116.40 --lat 39.90\n\n# 分钟级降水（仅中国地区）\nqw precipitation --lon 116.40 --lat 39.90\n\n# 生活指数\nqw indices --city 北京\nqw indices --city 北京 --days 3d\n\n# 天气预警\nqw warning --city 北京\n\n# 空气质量\nqw air now --city 北京\nqw air daily --city 北京\nqw air daily 5 --city 北京\nqw air hourly --city 北京\nqw air station --city 北京\n\n# 日出日落（--date 必选，格式 yyyyMMdd，最多未来 60 天）\nqw sun --city 北京 --date 20260416\n\n# 月升月落和月相（--date 必选，格式 yyyyMMdd，最多未来 60 天）\nqw moon --city 北京 --date 20260416\n\n# 太阳高度角（--date 必选；--time 格式 HHmm；--tz 时区偏移如 0800；-alt 海拔高度米）\nqw solar --lon 116.40 --lat 39.90 --date 20260416 --time 1200 --tz 0800 --alt 43\n```\n\n### 定位方式\n\n所有需要地理定位的命令支持以下三种方式（互斥，三选一）：\n- `--city <name>`：城市名称，自动调用 geo API 解析为 Location ID 和坐标\n- `--location-id <id>`：直接使用 Location ID\n- `--lon <float>` + `--lat <float>`：经纬度坐标（必须同时提供）\n\n### 命令行参数速查\n\n**全局参数**（所有命令共享）：\n- `--kid` / `--project-id` / `--private-key` / `--base-url` / `--geo-url`：覆盖环境变量\n- `--lang`：语言（默认 `zh`）\n\n**各命令专属参数**：\n- `weather daily [DAYS]`：`3|7|10|15|30`（默认 3）\n- `weather hourly [HOURS]`：`24|72|168`（默认 24）\n- `grid daily [DAYS]`：`3|7`（默认 3）\n- `grid hourly [HOURS]`：`24|72`（默认 24）\n- `air hourly [HOURS]`：`24|72`（默认 24）\n- `air daily [DAYS]`：`1|3|5`（默认 3）\n- `indices --days <1d|3d>`（默认 `1d`）\n- `sun --date yyyyMMdd` / `moon --date yyyyMMdd`\n- `solar --date yyyyMMdd --time HHmm --tz 偏移 --alt 海拔`\n\n### 参数限制\n\n| 命令 | 参数 | 限制说明 |\n|------|------|---------|\n| `weather daily` | `[DAYS]` | 仅支持 `3,7,10,15,30` |\n| `weather hourly` | `[HOURS]` | 仅支持 `24,72,168` |\n| `grid daily` | `[DAYS]` | 仅支持 `3,7` |\n| `grid hourly` | `[HOURS]` | 仅支持 `24,72` |\n| `air daily` | `[DAYS]` | 仅支持 `1,3,5` |\n| `air hourly` | `[HOURS]` | 仅支持 `24,72` |\n| `sun` / `moon` | `--date` | 必选，格式 `yyyyMMdd`，**仅未来 60 天内（含今天）** |\n| `solar` | `--date` / `--time` / `--tz` / `--alt` | 全部必填 |\n\nFile v0.5.0:_meta.json\n\n{\n  \"ownerId\": \"kn742kd3851e0k7gs45485q35x84s5nv\",\n  \"slug\": \"qweather-skill\",\n  \"version\": \"0.5.0\",\n  \"publishedAt\": 1777027462465\n}\n\nFile v0.5.0:skill-card.md\n\n## Description:\n\nProvides QWeather-powered lookups for current weather, forecasts, geolocation, precipitation, lifestyle indices, warnings, air quality, sunrise and sunset, moon phase, and solar angle by city, location ID, or coordinates.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[yinguobing](https://clawhub.ai/user/yinguobing)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and external users can use this skill to configure and run QWeather CLI queries for weather, geolocation, forecast, air quality, astronomy, and related environmental data. It is useful when an agent needs concrete shell commands and credential setup guidance for weather lookups.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill requires installing an external Cargo binary before use.\n\nMitigation: Install only trusted or reviewed versions of the qweather package or repository, and prefer a pinned version where possible.\n\nRisk: The skill requires QWeather credentials, including QWEATHER_PRIVATE_KEY.\n\nMitigation: Limit QWeather environment variables to the runtime environment where the CLI runs and avoid exposing private key material in prompts, logs, or shared shells.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/yinguobing/skills/qweather-skill)\n- [qweather-skill homepage](https://github.com/yinguobing/qweather-skill)\n- [QWeather Console](https://console.qweather.com/project)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown with inline shell commands and environment variable examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires QWeather credentials and the qw CLI installed from the qweather Cargo package or repository.]\n\n## Skill Version(s):\n\n0.5.0 (source: frontmatter and server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v0.4.0: 2 files, 2472 bytes\n\nFiles: SKILL.md (4824b), _meta.json (133b)\n\nFile v0.4.0:SKILL.md\n\n---\nname: qweather\nversion: 0.4.0\ndescription: 查询全球城市实时天气、天气预报、空气质量等信息的技能。当用户询问某个城市的天气、气温、降雨、风向、空气质量时调用。\nhomepage: https://github.com/yinguobing/qweather-skill\nrequired_env_vars:\n  - QWEATHER_KID\n  - QWEATHER_PROJECT_ID\n  - QWEATHER_PRIVATE_KEY\n  - QWEATHER_BASE_URL\n  - QWEATHER_GEO_URL\nprimary_credential: QWEATHER_PRIVATE_KEY\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"QWEATHER_KID\",\"QWEATHER_PROJECT_ID\",\"QWEATHER_PRIVATE_KEY\",\"QWEATHER_BASE_URL\",\"QWEATHER_GEO_URL\"]},\"primaryEnv\":\"QWEATHER_PRIVATE_KEY\",\"homepage\":\"https://github.com/yinguobing/qweather-skill\",\"install\":[{\"id\":\"qweather\",\"kind\":\"cargo\",\"package\":\"qweather\",\"bins\":[\"qw\"],\"label\":\"Install qweather via cargo\"}]}}\n---\n\n# 和风天气查询技能\n\n基于和风天气（QWeather）API，提供全球城市的天气查询能力。\n\n## 安装\n\n使用curl + install.sh安装：\n```bash\ncurl -sSL https://raw.githubusercontent.com/yinguobing/qweather-skill/main/install.sh | bash\n```\n\n使用Cargo安装可执行文件：\n```bash\ncargo install qweather\n```\n安装后二进制名为 `qw`。\n\n\n源码安装\n```bash\ncargo install --git https://github.com/yinguobing/qweather-skill.git\n```\n\n## 身份认证\n\n使用 JWT 身份认证，**必须**配置以下环境变量：\n\n```bash\nexport QWEATHER_KID=\"YOUR_KID\"\nexport QWEATHER_PROJECT_ID=\"YOUR_PROJECT_ID\"\nexport QWEATHER_PRIVATE_KEY=\"/path/to/qweather/private.pem\"\nexport QWEATHER_BASE_URL=\"https://your-host.qweatherapi.com/v7\"\nexport QWEATHER_GEO_URL=\"https://your-host.qweatherapi.com/geo/v2\"\n```\n\n详情可在[和风天气控制台](https://console.qweather.com/project)获取。\n\n## CLI 使用\n\n全局入口为 `qw`。通过命令+子命令提供具体功能。\n\n### 常用查询\n\n```bash\n# 地理位置\nqw geo city-lookup 北京\nqw geo top-city --range cn\nqw geo poi-lookup 故宫 --type scenic\nqw geo poi-range 116.40,39.90 --type scenic --radius 10\n\n# 实时天气\nqw weather now --city 北京\n\n# 未来N天预报（daily 仅支持 3,7,10,15,30）\nqw weather daily --city 北京\nqw weather daily 7 --city 北京\n\n# 逐小时预报（hourly 仅支持 24,72,168）\nqw weather hourly --city 北京\nqw weather hourly 72 --city 北京\n\n# 格点天气（基于经纬度的高分辨率数据）\nqw grid now --lon 116.40 --lat 39.90\nqw grid daily --lon 116.40 --lat 39.90\nqw grid daily 7 --lon 116.40 --lat 39.90\nqw grid hourly --lon 116.40 --lat 39.90\n\n# 分钟级降水（仅中国地区）\nqw precipitation --lon 116.40 --lat 39.90\n\n# 生活指数\nqw indices --city 北京\nqw indices --city 北京 --days 3d\n\n# 天气预警\nqw warning --city 北京\n\n# 空气质量\nqw air now --city 北京\nqw air daily --city 北京\nqw air daily 5 --city 北京\nqw air hourly --city 北京\nqw air station --city 北京\n\n# 日出日落（--date 必选，格式 yyyyMMdd，最多未来 60 天）\nqw sun --city 北京 --date 20260416\n\n# 月升月落和月相（--date 必选，格式 yyyyMMdd，最多未来 60 天）\nqw moon --city 北京 --date 20260416\n\n# 太阳高度角（--date 必选；--time 格式 HHmm；--tz 时区偏移如 0800；-alt 海拔高度米）\nqw solar --lon 116.40 --lat 39.90 --date 20260416 --time 1200 --tz 0800 --alt 43\n```\n\n### 定位方式\n\n所有需要地理定位的命令支持以下三种方式（互斥，三选一）：\n- `--city <name>`：城市名称，自动调用 geo API 解析为 Location ID 和坐标\n- `--location-id <id>`：直接使用 Location ID\n- `--lon <float>` + `--lat <float>`：经纬度坐标（必须同时提供）\n\n### 命令行参数速查\n\n**全局参数**（所有命令共享）：\n- `--kid` / `--project-id` / `--private-key` / `--base-url` / `--geo-url`：覆盖环境变量\n- `--lang`：语言（默认 `zh`）\n\n**各命令专属参数**：\n- `weather daily [DAYS]`：`3|7|10|15|30`（默认 3）\n- `weather hourly [HOURS]`：`24|72|168`（默认 24）\n- `grid daily [DAYS]`：`3|7`（默认 3）\n- `grid hourly [HOURS]`：`24|72`（默认 24）\n- `air hourly [HOURS]`：`24|72`（默认 24）\n- `air daily [DAYS]`：`1|3|5`（默认 3）\n- `indices --days <1d|3d>`（默认 `1d`）\n- `sun --date yyyyMMdd` / `moon --date yyyyMMdd`\n- `solar --date yyyyMMdd --time HHmm --tz 偏移 --alt 海拔`\n\n### 参数限制\n\n| 命令 | 参数 | 限制说明 |\n|------|------|---------|\n| `weather daily` | `[DAYS]` | 仅支持 `3,7,10,15,30` |\n| `weather hourly` | `[HOURS]` | 仅支持 `24,72,168` |\n| `grid daily` | `[DAYS]` | 仅支持 `3,7` |\n| `grid hourly` | `[HOURS]` | 仅支持 `24,72` |\n| `air daily` | `[DAYS]` | 仅支持 `1,3,5` |\n| `air hourly` | `[HOURS]` | 仅支持 `24,72` |\n| `sun` / `moon` | `--date` | 必选，格式 `yyyyMMdd`，**仅未来 60 天内（含今天）** |\n| `solar` | `--date` / `--time` / `--tz` / `--alt` | 全部必填 |\n\nFile v0.4.0:_meta.json\n\n{\n  \"ownerId\": \"kn742kd3851e0k7gs45485q35x84s5nv\",\n  \"slug\": \"qweather-skill\",\n  \"version\": \"0.4.0\",\n  \"publishedAt\": 1776696996709\n}\n\nArchive v0.3.1: 2 files, 2160 bytes\n\nFiles: SKILL.md (4278b), _meta.json (133b)\n\nFile v0.3.1:SKILL.md\n\n---\nname: qweather\nversion: 0.3.0\ndescription: 查询全球城市实时天气、天气预报、空气质量等信息的技能。当用户询问某个城市的天气、气温、降雨、风向、空气质量时调用。\nhomepage: https://github.com/yinguobing/qweather-skill\nrequired_env_vars:\n  - QWEATHER_KID\n  - QWEATHER_PROJECT_ID\n  - QWEATHER_PRIVATE_KEY\n  - QWEATHER_BASE_URL\n  - QWEATHER_GEO_URL\nprimary_credential: QWEATHER_PRIVATE_KEY\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"QWEATHER_KID\",\"QWEATHER_PROJECT_ID\",\"QWEATHER_PRIVATE_KEY\",\"QWEATHER_BASE_URL\",\"QWEATHER_GEO_URL\"]},\"primaryEnv\":\"QWEATHER_PRIVATE_KEY\",\"homepage\":\"https://github.com/yinguobing/qweather-skill\",\"install\":[{\"id\":\"qweather\",\"kind\":\"cargo\",\"package\":\"qweather\",\"bins\":[\"qweather\"],\"label\":\"Install qweather via cargo\"}]}}\n---\n\n# 和风天气查询技能\n\n基于和风天气（QWeather）API，提供全球城市的天气查询能力。\n\n## 安装\n\n使用curl + install.sh安装：\n```bash\ncurl -sSL https://raw.githubusercontent.com/yinguobing/qweather-skill/main/install.sh | bash\n```\n\n使用Cargo安装可执行文件：\n```bash\ncargo install qweather\n```\n\n\n源码安装\n```bash\ncargo install --git https://github.com/yinguobing/qweather-skill.git\n```\n\n## 身份认证\n\n使用 JWT 身份认证，**必须**配置以下环境变量：\n\n```bash\nexport QWEATHER_KID=\"YOUR_KID\"\nexport QWEATHER_PROJECT_ID=\"YOUR_PROJECT_ID\"\nexport QWEATHER_PRIVATE_KEY=\"/path/to/qweather/private.pem\"\nexport QWEATHER_BASE_URL=\"https://your-host.qweatherapi.com/v7\"\nexport QWEATHER_GEO_URL=\"https://your-host.qweatherapi.com/geo/v2\"\n```\n\n详情可在[和风天气控制台](https://console.qweather.com/project)获取。\n\n## CLI 使用\n\n全局入口为 `qweather`。所有查询都会自动完成城市定位。\n\n### 常用查询\n\n```bash\n# 实时天气（默认）\nqweather 北京\n\n# 未来N天预报（daily 仅支持 3,7,10,15,30）\nqweather 北京 --type daily --days 3\n\n# 逐小时预报（hourly 仅支持 24,72,168）\nqweather 北京 --type hourly --hours 24\n\n# 空气质量实时数据\nqweather 北京 --type air\n\n# 生活指数\nqweather 北京 --type indices --index-days 1d\n\n# 天气预警\nqweather 北京 --type warning\n\n# 分钟级降水（仅中国地区，自动获取经纬度）\nqweather 北京 --type minutely\n\n# 日出日落（--date 必选，格式 yyyyMMdd，最多未来 60 天）\nqweather 北京 --type sun --date 20260416\n\n# 月升月落和月相（--date 必选，格式 yyyyMMdd，最多未来 60 天）\nqweather 北京 --type moon --date 20260416\n\n# 太阳高度角（--date 必选；--time 格式 HHmm；--tz 时区偏移如 0800；-alt 海拔高度米）\nqweather 北京 --type solar --date 20260416 --time 1200 --tz 0800 --alt 43\n\n# 格点天气（基于经纬度的高分辨率数据）\nqweather 北京 --type grid-now\nqweather 北京 --type grid-daily --days 3\nqweather 北京 --type grid-hourly --hours 24\n\n# 空气质量预报\nqweather 北京 --type air-daily --days 5\nqweather 北京 --type air-hourly --hours 72\n```\n\n### 命令行参数速查\n\n- `--type {now,daily,hourly,air,indices,minutely,warning,sun,moon,solar,grid-now,grid-daily,grid-hourly,air-daily,air-hourly}`\n- `--days N`：用于 daily / grid-daily / air-daily\n- `--hours N`：用于 hourly / grid-hourly / air-hourly\n- `--index-days {1d,3d}`：用于 indices\n- `--date yyyyMMdd`：用于 sun / moon / solar（**最多未来 60 天，含今天**）\n- `--time HHmm` / `--tz 0800` / `--alt 海拔`：用于 solar\n- `--kid` / `--project-id` / `--private-key` / `--base-url` / `--geo-url`：覆盖环境变量\n\n### 参数限制\n\n| 参数 | 适用 `--type` | 限制说明 |\n|------|--------------|----------|\n| `--days` | `daily` | 仅支持 `3,7,10,15,30` |\n| `--days` | `grid-daily` | 仅支持 `3,7` |\n| `--days` | `air-daily` | 仅支持 `1,3,5` |\n| `--hours` | `hourly` | 仅支持 `24,72,168` |\n| `--hours` | `grid-hourly` | 仅支持 `24,72` |\n| `--hours` | `air-hourly` | 仅支持 `24,72` |\n| `--date` | `sun` / `moon` | 必选，格式 `yyyyMMdd`，**仅未来 60 天内（含今天）** |\n| `--date` | `solar` | 必选，格式 `yyyyMMdd` |\n| `--time` | `solar` | 必选，格式 `HHmm` |\n| `--tz` | `solar` | 必选，时区偏移，如 `0800`、`-0530` |\n| `--alt` | `solar` | 必选，海拔高度（米） |\n\nFile v0.3.1:_meta.json\n\n{\n  \"ownerId\": \"kn742kd3851e0k7gs45485q35x84s5nv\",\n  \"slug\": \"qweather-skill\",\n  \"version\": \"0.3.1\",\n  \"publishedAt\": 1776609645158\n}\n\nArchive v0.1.1: 3 files, 2991 bytes\n\nFiles: references/python-api.md (980b), SKILL.md (4550b), _meta.json (133b)\n\nFile v0.1.1:SKILL.md\n\n---\nname: qweather-skill\nversion: 0.2.0\ndescription: 查询全球城市实时天气、天气预报、空气质量等信息的技能。当用户询问某个城市的天气、气温、降雨、风向、空气质量时调用。\nhomepage: https://github.com/yinguobing/qweather-skill\nrequired_env_vars:\n  - QWEATHER_KID\n  - QWEATHER_PROJECT_ID\n  - QWEATHER_PRIVATE_KEY\n  - QWEATHER_BASE_URL\n  - QWEATHER_GEO_URL\n  - QWEATHER_API_KEY\nprimary_credential: QWEATHER_API_KEY\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"QWEATHER_KID\",\"QWEATHER_PROJECT_ID\",\"QWEATHER_PRIVATE_KEY\",\"QWEATHER_BASE_URL\",\"QWEATHER_GEO_URL\",\"QWEATHER_API_KEY\"]},\"primaryEnv\":\"QWEATHER_API_KEY\",\"homepage\":\"https://github.com/yinguobing/qweather-skill\",\"install\":[{\"id\":\"qweather-skill\",\"kind\":\"uv\",\"package\":\"qweather-skill\",\"bins\":[\"qweather-skill\"],\"label\":\"Install qweather-skill via uv\"}]}}\n---\n\n# 和风天气查询技能\n\n基于和风天气（QWeather）API，提供全球城市的天气查询能力。\n\n## 安装\n\n```bash\npip install qweather-skill==0.2.0\n```\n\n## 身份认证\n\n### JWT（默认，推荐）\n\n**必须**配置以下环境变量，详情可在[和风天气控制台](https://console.qweather.com/project)获取。：\n\n```bash\nexport QWEATHER_KID=\"your_kid\"\nexport QWEATHER_PROJECT_ID=\"your_project_id\"\nexport QWEATHER_PRIVATE_KEY=\"/path/to/your/private.pem\"\nexport QWEATHER_BASE_URL=\"https://your-host.qweatherapi.com/v7\"\nexport QWEATHER_GEO_URL=\"https://your-host.qweatherapi.com/geo/v2\"\n```\n\n### API KEY（回退）\n\n当 JWT 不可用时自动回退：\n\n```bash\nexport QWEATHER_API_KEY=\"your_api_key\"\n```\n\n## CLI 使用\n\n全局入口为 `qweather-skill`。所有查询都会自动完成城市定位。\n\n### 常用查询\n\n```bash\n# 实时天气（默认）\nqweather-skill 北京\n\n# 未来N天预报（daily 仅支持 3,7,10,15,30）\nqweather-skill 北京 --type daily --days 3\n\n# 逐小时预报（hourly 仅支持 24,72,168）\nqweather-skill 北京 --type hourly --hours 24\n\n# 空气质量实时数据\nqweather-skill 北京 --type air\n\n# 生活指数\nqweather-skill 北京 --type indices --index-days 1d\n\n# 天气预警\nqweather-skill 北京 --type warning\n\n# 分钟级降水（仅中国地区，自动获取经纬度）\nqweather-skill 北京 --type minutely\n\n# 日出日落（--date 必选，格式 yyyyMMdd，最多未来 60 天）\nqweather-skill 北京 --type sun --date 20260416\n\n# 月升月落和月相（--date 必选，格式 yyyyMMdd，最多未来 60 天）\nqweather-skill 北京 --type moon --date 20260416\n\n# 太阳高度角（--date 必选；--time 格式 HHmm；--tz 时区偏移如 0800；-alt 海拔高度米）\nqweather-skill 北京 --type solar --date 20260416 --time 1200 --tz 0800 --alt 43\n\n# 格点天气（基于经纬度的高分辨率数据）\nqweather-skill 北京 --type grid-now\nqweather-skill 北京 --type grid-daily --days 3\nqweather-skill 北京 --type grid-hourly --hours 24\n\n# 空气质量预报\nqweather-skill 北京 --type air-daily --days 5\nqweather-skill 北京 --type air-hourly --hours 72\n```\n\n### 命令行参数速查\n\n- `--type {now,daily,hourly,air,indices,minutely,warning,sun,moon,solar,grid-now,grid-daily,grid-hourly,air-daily,air-hourly}`\n- `--days N`：用于 daily / grid-daily / air-daily\n- `--hours N`：用于 hourly / grid-hourly / air-hourly\n- `--index-days {1d,3d}`：用于 indices\n- `--date yyyyMMdd`：用于 sun / moon / solar（**最多未来 60 天，含今天**）\n- `--time HHmm` / `--tz 0800` / `--alt 海拔`：用于 solar\n- `--key` / `--kid` / `--project-id` / `--private-key` / `--base-url` / `--geo-url`：覆盖环境变量\n\n### 参数限制\n\n| 参数 | 适用 `--type` | 限制说明 |\n|------|--------------|----------|\n| `--days` | `daily` | 仅支持 `3,7,10,15,30` |\n| `--days` | `grid-daily` | 仅支持 `3,7` |\n| `--days` | `air-daily` | 仅支持 `3,5,7` |\n| `--hours` | `hourly` | 仅支持 `24,72,168` |\n| `--hours` | `grid-hourly` | 仅支持 `24,72` |\n| `--hours` | `air-hourly` | 仅支持 `24,72` |\n| `--date` | `sun` / `moon` | 必选，格式 `yyyyMMdd`，**仅未来 60 天内（含今天）** |\n| `--date` | `solar` | 必选，格式 `yyyyMMdd` |\n| `--time` | `solar` | 必选，格式 `HHmm` |\n| `--tz` | `solar` | 必选，时区偏移，如 `0800`、`-0530` |\n| `--alt` | `solar` | 必选，海拔高度（米） |\n\n## 非 CLI 功能\n\n以下功能没有 CLI 支持，需要使用 Python API。详见 [references/python-api.md](references/python-api.md)：\n\n- **POI 搜索**：`GeoAPI.poi_lookup()`、`GeoAPI.poi_range()`\n- **空气质量监测站**：`AirAPI.station()`\n\nFile v0.1.1:_meta.json\n\n{\n  \"ownerId\": \"kn742kd3851e0k7gs45485q35x84s5nv\",\n  \"slug\": \"qweather-skill\",\n  \"version\": \"0.1.1\",\n  \"publishedAt\": 1776344100497\n}\n\nFile v0.1.1:references/python-api.md\n\n# Python API 补充\n\n当需要 POI 搜索或空气质量监测站数据时使用 Python API。\n\n## 基础用法模板\n\n```python\nimport asyncio\nfrom qweather_skill import QWeatherClient, QWeatherConfig\n\nasync def main():\n    config = QWeatherConfig()  # 读取环境变量\n    async with QWeatherClient(config) as client:\n        # 使用各 API 类\n        pass\n\nasyncio.run(main())\n```\n\n## POI 搜索\n\n```python\nfrom qweather_skill.geo import GeoAPI\n\ngeo = GeoAPI(client)\n\n# 关键字搜索（如景点、机场、火车站）\nresp = await geo.poi_lookup(\"故宫\", type=\"scenic\", city=\"北京\")\nfor poi in resp.poi:\n    print(poi.name, poi.adm1)\n\n# 坐标范围搜索附近 POI\nresp = await geo.poi_range(\"116.40,39.90\", type=\"scenic\", radius=5)\nfor poi in resp.poi:\n    print(poi.name, poi.adm1)\n```\n\n## 空气质量监测站\n\n```python\nfrom qweather_skill.air import AirAPI\n\nair = AirAPI(client)\nresp = await air.station(\"station_id\")\nprint(resp.now.pm2p5, resp.now.pm10)\n```\n\nArchive v0.1.0: 3 files, 2756 bytes\n\nFiles: references/python-api.md (980b), SKILL.md (3899b), _meta.json (133b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: qweather-skill\ndescription: 查询全球城市实时天气、天气预报、空气质量等信息的技能。当用户询问某个城市的天气、气温、降雨、风向、空气质量时调用。\n---\n\n# 和风天气查询技能\n\n基于和风天气（QWeather）API，提供全球城市的天气查询能力。\n\n## 安装\n\n```bash\npip install qweather-skill==0.2.0\n```\n\n## 身份认证\n\n### JWT（默认，推荐）\n\n**必须**配置以下环境变量，详情可在[和风天气控制台](https://console.qweather.com/project)获取。：\n\n```bash\nexport QWEATHER_KID=\"your_kid\"\nexport QWEATHER_PROJECT_ID=\"your_project_id\"\nexport QWEATHER_PRIVATE_KEY=\"/path/to/your/private.pem\"\nexport QWEATHER_BASE_URL=\"https://your-host.qweatherapi.com/v7\"\nexport QWEATHER_GEO_URL=\"https://your-host.qweatherapi.com/geo/v2\"\n```\n\n### API KEY（回退）\n\n当 JWT 不可用时自动回退：\n\n```bash\nexport QWEATHER_API_KEY=\"your_api_key\"\n```\n\n## CLI 使用\n\n全局入口为 `qweather-skill`。所有查询都会自动完成城市定位。\n\n### 常用查询\n\n```bash\n# 实时天气（默认）\nqweather-skill 北京\n\n# 未来N天预报（daily 仅支持 3,7,10,15,30）\nqweather-skill 北京 --type daily --days 3\n\n# 逐小时预报（hourly 仅支持 24,72,168）\nqweather-skill 北京 --type hourly --hours 24\n\n# 空气质量实时数据\nqweather-skill 北京 --type air\n\n# 生活指数\nqweather-skill 北京 --type indices --index-days 1d\n\n# 天气预警\nqweather-skill 北京 --type warning\n\n# 分钟级降水（仅中国地区，自动获取经纬度）\nqweather-skill 北京 --type minutely\n\n# 日出日落（--date 必选，格式 yyyyMMdd，最多未来 60 天）\nqweather-skill 北京 --type sun --date 20260416\n\n# 月升月落和月相（--date 必选，格式 yyyyMMdd，最多未来 60 天）\nqweather-skill 北京 --type moon --date 20260416\n\n# 太阳高度角（--date 必选；--time 格式 HHmm；--tz 时区偏移如 0800；-alt 海拔高度米）\nqweather-skill 北京 --type solar --date 20260416 --time 1200 --tz 0800 --alt 43\n\n# 格点天气（基于经纬度的高分辨率数据）\nqweather-skill 北京 --type grid-now\nqweather-skill 北京 --type grid-daily --days 3\nqweather-skill 北京 --type grid-hourly --hours 24\n\n# 空气质量预报\nqweather-skill 北京 --type air-daily --days 5\nqweather-skill 北京 --type air-hourly --hours 72\n```\n\n### 命令行参数速查\n\n- `--type {now,daily,hourly,air,indices,minutely,warning,sun,moon,solar,grid-now,grid-daily,grid-hourly,air-daily,air-hourly}`\n- `--days N`：用于 daily / grid-daily / air-daily\n- `--hours N`：用于 hourly / grid-hourly / air-hourly\n- `--index-days {1d,3d}`：用于 indices\n- `--date yyyyMMdd`：用于 sun / moon / solar（**最多未来 60 天，含今天**）\n- `--time HHmm` / `--tz 0800` / `--alt 海拔`：用于 solar\n- `--key` / `--kid` / `--project-id` / `--private-key` / `--base-url` / `--geo-url`：覆盖环境变量\n\n### 参数限制\n\n| 参数 | 适用 `--type` | 限制说明 |\n|------|--------------|----------|\n| `--days` | `daily` | 仅支持 `3,7,10,15,30` |\n| `--days` | `grid-daily` | 仅支持 `3,7` |\n| `--days` | `air-daily` | 仅支持 `3,5,7` |\n| `--hours` | `hourly` | 仅支持 `24,72,168` |\n| `--hours` | `grid-hourly` | 仅支持 `24,72` |\n| `--hours` | `air-hourly` | 仅支持 `24,72` |\n| `--date` | `sun` / `moon` | 必选，格式 `yyyyMMdd`，**仅未来 60 天内（含今天）** |\n| `--date` | `solar` | 必选，格式 `yyyyMMdd` |\n| `--time` | `solar` | 必选，格式 `HHmm` |\n| `--tz` | `solar` | 必选，时区偏移，如 `0800`、`-0530` |\n| `--alt` | `solar` | 必选，海拔高度（米） |\n\n## 非 CLI 功能\n\n以下功能没有 CLI 支持，需要使用 Python API。详见 [references/python-api.md](references/python-api.md)：\n\n- **POI 搜索**：`GeoAPI.poi_lookup()`、`GeoAPI.poi_range()`\n- **空气质量监测站**：`AirAPI.station()`\n\nFile v0.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn742kd3851e0k7gs45485q35x84s5nv\",\n  \"slug\": \"qweather-skill\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1776342608911\n}\n\nFile v0.1.0:references/python-api.md\n\n# Python API 补充\n\n当需要 POI 搜索或空气质量监测站数据时使用 Python API。\n\n## 基础用法模板\n\n```python\nimport asyncio\nfrom qweather_skill import QWeatherClient, QWeatherConfig\n\nasync def main():\n    config = QWeatherConfig()  # 读取环境变量\n    async with QWeatherClient(config) as client:\n        # 使用各 API 类\n        pass\n\nasyncio.run(main())\n```\n\n## POI 搜索\n\n```python\nfrom qweather_skill.geo import GeoAPI\n\ngeo = GeoAPI(client)\n\n# 关键字搜索（如景点、机场、火车站）\nresp = await geo.poi_lookup(\"故宫\", type=\"scenic\", city=\"北京\")\nfor poi in resp.poi:\n    print(poi.name, poi.adm1)\n\n# 坐标范围搜索附近 POI\nresp = await geo.poi_range(\"116.40,39.90\", type=\"scenic\", radius=5)\nfor poi in resp.poi:\n    print(poi.name, poi.adm1)\n```\n\n## 空气质量监测站\n\n```python\nfrom qweather_skill.air import AirAPI\n\nair = AirAPI(client)\nresp = await air.station(\"station_id\")\nprint(resp.now.pm2p5, resp.now.pm10)\n```","readmeExcerpt":"Skill: 和风天气 Owner: yinguobing Summary: 查询全球城市或者经纬度位置的实时天气、天气预报、空气质量等信息的技能。当用户询问某个城市或者经纬度的天气、气温、降雨、风向、空气质量时调用。 Tags: latest:0.5.0 Version history: v0.5.0 | 2026-04-24T10:44:22.465Z | user Version 0.5.0 introduces improved geographic flexibility and documentation updates. - 支持通过经纬度查询全球位置天气，描述文本及参数说明中均已补充（不仅限城市）。 - 新增 geo reverse（经纬度反查行政区划）命令行用法示例。 - 说明文档精简了安装方法；curl+install.sh 安装指引移至官方文档。 - description 字段更新，明确支持城市或经纬度查","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"cargo install qweather"},{"language":"bash","snippet":"cargo install --git https://github.com/yinguobing/qweather-skill.git"},{"language":"url","snippet":"https://github.com/yinguobing/qweather-skill"},{"language":"bash","snippet":"export QWEATHER_KID=\"YOUR_KID\"\nexport QWEATHER_PROJECT_ID=\"YOUR_PROJECT_ID\"\nexport QWEATHER_PRIVATE_KEY=\"/path/to/qweather/private.pem\"\nexport QWEATHER_BASE_URL=\"https://your-host.qweatherapi.com/v7\"\nexport QWEATHER_GEO_URL=\"https://your-host.qweatherapi.com/geo/v2\""},{"language":"bash","snippet":"# 地理位置\nqw geo city-lookup 北京\nqw geo reverse --lon 113.4695 --lat 23.1895    # 经纬度反查行政区划\nqw geo top-city --range cn\nqw geo poi-lookup 故宫 --type scenic\nqw geo poi-range 116.40,39.90 --type scenic --radius 10\n\n# 实时天气\nqw weather now --city 北京\n\n# 未来N天预报（daily 仅支持 3,7,10,15,30）\nqw weather daily --city 北京\nqw weather daily 7 --city 北京\n\n# 逐小时预报（hourly 仅支持 24,72,168）\nqw weather hourly --city 北京\nqw weather hourly 72 --city 北京\n\n# 格点天气（基于经纬度的高分辨率数据）\nqw grid now --lon 116.40 --lat 39.90\nqw grid daily --lon 116.40 --lat 39.90\nqw grid daily 7 --lon 116.40 --lat 39.90\nqw grid hourly --lon 116.40 --lat 39.90\n\n# 分钟级降水（仅中国地区）\nqw precipitation --lon 116.40 --lat 39.90\n\n# 生活指数\nqw indices --city 北京\nqw indices --city 北京 --days 3d\n\n# 天气预警\nqw warning --city 北京\n\n# 空气质量\nqw air now --city 北京\nqw air daily --city 北京\nqw air daily 5 --city 北京\nqw air hourly --city 北京\nqw air station --city 北京\n\n# 日出日落（--date 必选，格式 yyyyMMdd，最多未来 60 天）\nqw sun --city 北京 --date 20260416\n\n# 月升月落和月相（--date 必选，格式 yyyyMMdd，最多未来 60 天）\nqw moon --city 北京 --date 20260416\n\n# 太阳高度角（--date 必选；--time 格式 HHmm；--tz 时区偏移如 0800；-alt 海拔高度米）\nqw solar --lon 116.40 --lat 39.90 --date 20260416 --time 1200 --tz 0800 --alt 43"},{"language":"bash","snippet":"curl -sSL https://raw.githubusercontent.com/yinguobing/qweather-skill/main/install.sh | bash"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: qweather\nversion: 0.5.0\ndescription: 查询全球城市或者经纬度位置的实时天气、天气预报、空气质量等信息的技能。当用户询问某个城市或者经纬度的天气、气温、降雨、风向、空气质量时调用。\nhomepage: https://github.com/yinguobing/qweather-skill\nrequired_env_vars:\n  - QWEATHER_KID\n  - QWEATHER_PROJECT_ID\n  - QWEATHER_PRIVATE_KEY\n  - QWEATHER_BASE_URL\n  - QWEATHER_GEO_URL\nprimary_credential: QWEATHER_PRIVATE_KEY\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"QWEATHER_KID\",\"QWEATHER_PROJECT_ID\",\"QWEATHER_PRIVATE_KEY\",\"QWEATHER_BASE_URL\",\"QWEATHER_GEO_URL\"]},\"primaryEnv\":\"QWEATHER_PRIVATE_KEY\",\"homepage\":\"https://github.com/yinguobing/qweather-skill\",\"install\":[{\"id\":\"qweather\",\"kind\":\"cargo\",\"package\":\"qweather\",\"bins\":[\"qw\"],\"label\":\"Install qweather via cargo\"}]}}\n---\n\n# 和风天气查询技能\n\n基于和风天气（QWeather）API，提供全球城市的天气查询能力。\n\n## 安装\n使用Cargo安装：\n```bash\ncargo install qweather\n```\n\n源码安装\n```bash\ncargo install --git https://github.com/yinguobing/qweather-skill.git\n```\n\n如果需要使用curl + install.sh安装请参考官方文档：\n```url\nhttps://github.com/yinguobing/qweather-skill\n```\n\n## 身份认证\n\n使用 JWT 身份认证，**必须**配置以下环境变量：\n\n```bash\nexport QWEATHER_KID=\"YOUR_KID\"\nexport QWEATHER_PROJECT_ID=\"YOUR_PROJECT_ID\"\nexport QWEATHER_PRIVATE_KEY=\"/path/to/qweather/private.pem\"\nexport QWEATHER_BASE_URL=\"https://your-host.qweatherapi.com/v7\"\nexport QWEATHER_GEO_URL=\"https://your-host.qweatherapi.com/geo/v2\"\n```\n\n详情可在[和风天气控制台](https://console.qweather.com/project)获取。\n\n## CLI 使用\n\n全局入口为 `qw`。通过命令+子命令提供具体功能。\n\n### 常用查询\n\n```bash\n# 地理位置\nqw geo city-lookup 北京\nqw geo reverse --lon 113.4695 --lat 23.1895    # 经纬度反查行政区划\nqw geo top-city --range cn\nqw geo poi-lookup 故宫 --type scenic\nqw geo poi-range 116.40,39.90 --type scenic --radius 10\n\n# 实时天气\nqw weather now --city 北京\n\n# 未来N天预报（daily 仅支持 3,7,10,15,30）\nqw weather daily --city 北京\nqw weather daily 7 --city 北京\n\n# 逐小时预报（hourly 仅支持 24,72,168）\nqw weather hourly --city 北京\nqw weather hourly 72 --city 北京\n\n# 格点天气（基于经纬度的高分辨率数据）\nqw grid now --lon 116.40 --lat 39.90\nqw grid daily --lon 116.40 --lat 39.90\nqw grid daily 7 --lon 116.40 --lat 39.90\nqw grid hourly --lon 116.40 --lat 39.90\n\n# 分钟级降水（仅中国地区）\nqw precipitation --lon 116.40 --lat 39.90\n\n# 生活指数\nqw indices --city 北京\nqw indices --city 北京 --days 3d\n\n# 天气预警\nqw warning --city 北京\n\n# 空气质量\nqw air now --city 北京\nqw air daily --city 北京\nqw air daily 5 --city 北京\nqw air hourly --city 北京\nqw air station --city 北京\n\n# 日出日落（--date 必选，格式 yyyyMMdd，最多未来 60 天）\nqw sun --city 北京 --date 20260416\n\n# 月升月落和月相（--date 必选，格式 yyyyMMdd，最多未来 60 天）\nqw moon --city 北京 --date 20260416\n\n# 太阳高度角（--date 必选；--time 格式 HHmm；--tz 时区偏移如 0800；-alt 海拔高度米）\nqw solar --lon 116.40 --lat 39.90 --date 20260416 --time 1200 --tz 0800 --alt 43\n```\n\n### 定位方式\n\n所有需要地理定位的命令支持以下三种方式（互斥，三选一）：\n- `--city <name>`：城市名称，自动调用 geo API 解析为 Location ID 和坐标\n- `--location-id <id>`：直接使用 Location ID\n- `--lon <float>` + `--lat <float>`：经纬度坐标（必须同时提供）\n\n### 命令行参数速查\n\n**全局参数**（所有命令共享）：\n- `--kid` / `--project-id` / `--private-key` / `--base-url` / `--geo-url`：覆盖环境变量\n- `--lang`：语言（默认 `zh`）\n\n**各命令专属参数**：\n- `weather daily [DAYS]`：`3|7|10|15|30`（默认 3）\n- `weather hourly [HOURS]`：`24|72|1"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn742kd3851e0k7gs45485q35x84s5nv\",\n  \"slug\": \"qweather-skill\",\n  \"version\": \"0.5.0\",\n  \"publishedAt\": 1777027462465\n}"},{"path":"skill-card.md","content":"## Description:\n\nProvides QWeather-powered lookups for current weather, forecasts, geolocation, precipitation, lifestyle indices, warnings, air quality, sunrise and sunset, moon phase, and solar angle by city, location ID, or coordinates.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[yinguobing](https://clawhub.ai/user/yinguobing)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and external users can use this skill to configure and run QWeather CLI queries for weather, geolocation, forecast, air quality, astronomy, and related environmental data. It is useful when an agent needs concrete shell commands and credential setup guidance for weather lookups.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill requires installing an external Cargo binary before use.\n\nMitigation: Install only trusted or reviewed versions of the qweather package or repository, and prefer a pinned version where possible.\n\nRisk: The skill requires QWeather credentials, including QWEATHER_PRIVATE_KEY.\n\nMitigation: Limit QWeather environment variables to the runtime environment where the CLI runs and avoid exposing private key material in prompts, logs, or shared shells.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/yinguobing/skills/qweather-skill)\n- [qweather-skill homepage](https://github.com/yinguobing/qweather-skill)\n- [QWeather Console](https://console.qweather.com/project)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown with inline shell commands and environment variable examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires QWeather credentials and the qw CLI installed from the qweather Cargo package or repository.]\n\n## Skill Version(s):\n\n0.5.0 (source: frontmatter and server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"查询全球城市或者经纬度位置的实时天气、天气预报、空气质量等信息的技能。当用户询问某个城市或者经纬度的天气、气温、降雨、风向、空气质量时调用。 Skill: 和风天气 Owner: yinguobing Summary: 查询全球城市或者经纬度位置的实时天气、天气预报、空气质量等信息的技能。当用户询问某个城市或者经纬度的天气、气温、降雨、风向、空气质量时调用。 Tags: latest:0.5.0 Version history: v0.5.0 | 2026-04-24T10:44:22.465Z | user Version 0.5.0 introduces improved geographic flexibility and documentation updates. - 支持通过经纬度查询全球位置天气，描述文本及参数说明中均已补充（不仅限城市）。 - 新增 geo reverse（经纬度反查行政区划）命令行用法示例。 - 说明文档精简了安装方法；curl+install.sh 安装指引移至官方文档。 - description 字段更新，明确支持城市或经纬度查","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1006,"uniquenessScore":53,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T13:54:54.935Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T13:54:54.935Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T17:44:47.545Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}