← Back to Skills Marketplace
138
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install travel-planner-amap
Description
智能旅行攻略规划师。根据用户提供的出行信息(人数、男女比例、关系、出发地、目的地、日期、天数), 直接调用高德地图 REST API 获取实时路线、POI、距离等数据,生成完整的个性化旅行攻略。 攻略包含:创意名称、出行方式建议(含当地租车判断)、分时段行程(早午晚三餐均有具体推荐)、 景点推荐(含高铁站→景点距...
Usage Guidance
This skill appears to implement a legitimate AMap-based travel planner, but check two things before installing: (1) confirm the skill actually requires and will use an AMAP_KEY — the registry metadata and SKILL.md disagree (registry shows no env, SKILL.md requires AMAP_KEY). Do not proceed until you see the manifest updated or the publisher explains the discrepancy. (2) Ensure the runtime environment has python3 and that you create an AMap Web Service key with restrictive permissions and IP whitelist as the instructions recommend; avoid storing the key in shell rc files — use temporary exports or a short-lived credential. Also ask the publisher why 'curl' is listed as a requirement when the examples use python; unused requirements may indicate sloppy packaging. If you need to limit blast radius further, create an API key scoped only to the minimal AMap endpoints the skill needs, and test the skill in a restricted sandbox first.
Capability Analysis
Type: OpenClaw Skill
Name: travel-planner-amap
Version: 2.0.1
The travel-planner-amap skill is a legitimate tool for generating travel itineraries using the Amap (高德地图) REST API. The implementation in skill.md follows security best practices by passing user-provided strings (like addresses) through environment variables and using Python's urllib.parse.urlencode to prevent shell injection. It correctly handles the AMAP_KEY and provides helpful security advice to the user regarding API key management.
Capability Assessment
Purpose & Capability
The skill's stated purpose (calling 高德/AMap REST APIs to build travel plans) aligns with the runtime instructions which repeatedly call AMap endpoints and require an AMAP_KEY. However the registry metadata provided earlier claimed 'Required env vars: none' while the SKILL.md declares AMAP_KEY as required — this mismatch is unexpected and should be resolved.
Instruction Scope
SKILL.md stays within its stated purpose: it collects travel details from the user, constructs URL-encoded queries, and calls AMap REST APIs via short Python snippets. It explicitly avoids shell concatenation for user inputs and recommends IP whitelisting and limiting service permissions for the API key. The instructions do not attempt to read unrelated files or other credentials.
Install Mechanism
This is an instruction-only skill with no install spec and no code files, so nothing is written to disk by the skill itself. That is the lowest-risk install model.
Credentials
The runtime requires an AMAP_KEY (appropriate for AMap API usage), which is reasonable. But the registry-level metadata omitted required env vars while SKILL.md marks AMAP_KEY required — this inconsistency is concerning. Also the SKILL.md lists 'requires: curl' alongside python3, yet the shown runtime snippets use python urllib.request rather than curl; 'curl' may be an unnecessary or incorrect requirement.
Persistence & Privilege
The skill does not request always:true and contains no instructions to modify other skills or system-wide configs. It uses ephemeral environment variables in one-off commands and recommends not persisting the API key in shell configs.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install travel-planner-amap - After installation, invoke the skill by name or use
/travel-planner-amap - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.1
▎ Hi, I've updated the travel-planner skill and the SKILL.md frontmatter now explicitly declares:
▎
▎ - env: AMAP_KEY (required)
▎ - requires: curl, python3
▎
▎ However, the OpenClaw scanner still reports "registry metadata omits the declared requirements," which
▎ suggests the registry is reading a cached version of the old metadata rather than the current SKILL.md.
▎
▎ Could you re-index this skill or confirm whether the registry metadata updates automatically on
▎ republish? The SKILL.md content and the scanner's capability analysis are consistent — only the
▎ registry summary appears stale.
▎
▎ Thank you.
v2.0.0
Initial release.
- 旅行攻略规划功能上线:根据用户信息调用高德地图REST API,生成专属行程、餐饮和住宿推荐
- 新增高德API Key自动检查,未配置时友好指引
- 收集用户必需出行信息和偏好,遵循“一次性打包提问”原则
- 使用curl和python3组合,实时获取路线、景点、餐厅、酒店数据
- 明确输出模板,含路线、分时段行程、费用、物品清单、注意事项等
- 支持出行方式智能建议(含租车判断)、创意行程命名,适配多种出行场景
v1.0.1
v1.0.1 — 重大更新:由 CLI/GUI 切换为直接调用高德 REST API,流程更简洁高效
- 直接集成高德地图 REST API,无需 amap-gui/CLI 环境,配置仅需 AMAP_KEY(Web服务)。
- 数据采集、路线、POI、酒店、餐厅等全部通过 REST API 实时获取并以具体 shell/curl 示例展示。
- 新增「高铁站→景点距离」与跨景点评估,智能判断是否建议当地租车。
- 行程细化增加早餐和高铁/站点信息,三餐均有地点和具体推荐。
- 优化出行方式建议、住宿方案推荐与费用估算,流程更清晰,逻辑更智能。
v1.0.0
- Initial release of Travel Planner-amap (v1.0.0), an intelligent travel itinerary planner.
- Generates personalized travel guides using real-time data from amap-cli-skill, including routes, POIs, and weather.
- Output includes creative trip name, detailed itinerary, recommended attractions, must-visit spots, dining and hotel suggestions (with room types based on group type), packing list, tips, and cost summary.
- Provides detailed setup instructions for environment and API Key configuration.
- Guides users to provide complete trip information and clarifies interaction flow for efficient planning.
Metadata
Frequently Asked Questions
What is travel planner amap?
智能旅行攻略规划师。根据用户提供的出行信息(人数、男女比例、关系、出发地、目的地、日期、天数), 直接调用高德地图 REST API 获取实时路线、POI、距离等数据,生成完整的个性化旅行攻略。 攻略包含:创意名称、出行方式建议(含当地租车判断)、分时段行程(早午晚三餐均有具体推荐)、 景点推荐(含高铁站→景点距... It is an AI Agent Skill for Claude Code / OpenClaw, with 138 downloads so far.
How do I install travel planner amap?
Run "/install travel-planner-amap" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is travel planner amap free?
Yes, travel planner amap is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does travel planner amap support?
travel planner amap is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created travel planner amap?
It is built and maintained by bifang988 (@bifang988); the current version is v2.0.1.
More Skills