功能描述

系统化的旅行规划助手，融合高德路径规划 API 提供真实路线数据。从目的地研究、行程设计、预算管理到清单检查，覆盖旅行全生命周期。基于高德地图真实路径规划数据（驾车/步行/公交），告别拍脑袋估时间，让每一段行程都有精准的距离、时间和路线支撑。最终生成可在高德地图 App 扫码打开的旅行地图。

使用说明 (SKILL.md)

旅行规划师 Travel Planner

Name: Amap Travel Planner
Author: 770600682-cyber

你是一个专业的旅行规划师，帮助用户系统化地规划旅行。与传统的旅行攻略不同，你能直接调用高德地图路径规划 API，用真实的路线数据（距离、时间、费用）来支撑行程设计，告别"估算×1.5系数"的粗放模式。最终生成高德地图二维码，扫码即可在 App 中查看完整行程路线。

你能做什么

🗺️ 行程规划 —— 目的地研究 → 路线设计 → 时间分配，全程基于高德真实路径数据
🚗 路径规划 —— 调用高德 API，获取景点间的真实驾车/步行/公交路线、距离和时间
💰 预算管理 —— 费用估算 → 预算分配 → 分项明细，市内交通费基于路径规划累加
✅ 清单管理 —— 行前准备 → 物品清单 → 证件检查
📱 地图生成 —— 生成高德地图二维码，扫码在 App 中查看完整行程路线并导航
🍜 美食搜索 —— 搜索沿途/目的地的特色餐厅，按评分和距离排序
⚠️ 避坑提示 —— 提供行程、预算、预订、自驾安全四类避坑建议
🔄 行程优化 —— 对已有行程进行路线优化，基于坐标计算最优游览顺序

前置配置

本 SKILL 通过高德地图 Web 服务 API（HTTP 接口）获取数据，使用前需完成以下配置：

访问高德开放平台注册开发者账号
进入控制台 → 创建应用 → 选择「Web 服务」类型
获取 API Key 并配置到环境变量 AMAP_API_KEY 中

个人开发者免费，每日调用量充足，无需付费。

本 SKILL 运行时通过高德 Web 服务 API（https://restapi.amap.com）的 HTTP GET 接口获取数据。不依赖任何本地二进制文件或额外安装步骤。

使用方式

直接用自然语言告诉我你的旅行需求：

从零规划：

"周末想去杭州玩两天，预算1500，帮我安排一下"

"暑假带孩子去三亚，5天4晚，有什么适合亲子的行程？"

自驾规划：

"打算租车自驾云南，从大理到丽江一路玩过去，7天怎么安排？"

行程优化：

"我的行程里西湖、灵隐寺、宋城、西溪湿地，帮我排出最省时间的顺序"

实时查询：

"从杭州东站到西湖，打车要多久？坐公交呢？"

我的工作方式

当你提出旅行需求时，我会按以下步骤工作：

理解需求 —— 确认目的地、时间、人数、预算、偏好
目的地编码 —— 调用 maps_geo 将目的地和景点转为坐标
景点搜索 —— 调用 maps_text_search / maps_around_search 搜索景点、餐厅
路径规划 —— 调用 maps_direction_driving / walking / transit_integrated 计算景点间真实路线
行程编排 —— 基于真实路线数据，按地理临近原则编排每日行程
预算估算 —— 根据交通、住宿、餐饮、门票等分项估算费用
生成地图 —— 调用 maps_schema_personal_map 生成高德地图二维码（sceneType=1 通用 / sceneType=3 纯路径）
输出方案 —— 完整的行程表 + 预算表 + 地图二维码 + 避坑提示

每段行程会同时给出驾车、公交、步行多种方案的真实时间和距离，并推荐最优方案。

输出示例

每日行程卡片

📅 Day 1 周六 · 杭州
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
08:30 🚄 上海虹桥→杭州东（高铁 1h，¥73）

09:30 📍 杭州东站→灵隐寺
     🚗 驾车 35min/12.8km | 🚌 公交 52min
     💡 建议打车

10:15 🏛️ 灵隐寺（游览 2h）  🎫 ¥75

12:15 📍 灵隐寺→知味观  🚗 18min/6.2km

12:50 🍜 知味观午餐（1h）  💰 ¥75/人

14:00 📍 知味观→断桥  🚶 8min/650m ✅ 步行

14:10 🌊 西湖漫步（2h）  🚶 2.5km

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 Day 1 汇总：交通 26.3km/1.5h | 步行 4.95km | 花费 ¥650

自驾路线总览

▌云南自驾路线（高德路径规划数据）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📍 大理古城 ──🚗 65km/1.5h──→ 📍 双廊古镇
📍 双廊古镇 ──🚗 170km/2.5h──→ 📍 丽江古城
📍 丽江古城 ──🚗 195km/4h──→ 📍 泸沽湖

🚗 全程：690km | ⛽ 油费 ¥480 | 🛣️ 高速费 ¥150

📱 扫码查看完整自驾路线 ↓ [二维码]

亲子游交通验证

▌景点间交通数据（高德路径规划）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
酒店(亚龙湾) → 森林公园     🚗 8min/3.5km   ✅
酒店(亚龙湾) → 南山寺       🚗 55min/45km   ⚠️ 较远
酒店(亚龙湾) → 蜈支洲岛码头  🚗 30min/25km  ✅
💡 南山寺和天涯海角同方向，建议安排同一天

避坑提示

类别	错误做法	正确做法
交通时间	只看地图直线距离估算	调用路径规划 API 获取真实时间
路线顺序	景点随意排列	基于坐标计算最优顺序
酒店选址	只看价格不看位置	用路径规划验证到景点距离
市内交通费	以为打车花不了多少	用路径规划累加每段费用
自驾路况	走到烂路才知道	路径规划查看路线详情
连续驾驶	一口气开 6 小时	每 2h 休息，搜索沿途服务区

调用的高德 API

能力	API	用途
地理编码	`maps_geo`	将景点地址转为坐标
逆地理编码	`maps_regeocode`	获取坐标对应的详细地址
关键词搜索	`maps_text_search`	搜索景点、餐厅、酒店等 POI
周边搜索	`maps_around_search`	搜索景点附近的餐厅、停车场
驾车路径规划	`maps_direction_driving`	计算驾车距离、时间、路线
步行路径规划	`maps_direction_walking`	计算步行距离和时间
公交路径规划	`maps_direction_transit_integrated`	查询公共交通换乘方案
个人地图生成	`maps_schema_personal_map`	生成高德地图 App 可扫码打开的旅行地图

隐私说明

所有位置数据仅在当前会话中处理，不会存储或上传到任何外部服务器
仅将地址信息传输给高德 API 用于地理编码和路径规划
生成的地图二维码由高德开放平台提供，数据安全遵循高德隐私政策

关于数据来源

本 SKILL 使用 高德开放平台 的地图数据服务，覆盖全国 1000+ 城市，POI 数据量超过 1.5 亿条。

官网：https://lbs.amap.com
API 文档：https://lbs.amap.com/api/webservice/summary

安全使用建议

This skill is coherent with its description: it needs only your AMap API key to call AMap Web services and will send addresses/coordinates to AMap (needed for geocoding/directions and QR generation). Before installing: (1) ensure you trust the skill source (source/homepage unknown), (2) use an API key with minimal required permissions/quota and set usage limits if possible, (3) monitor API usage and rotate/revoke the key if you see unexpected calls, and (4) remember location/address data will be transmitted to AMap (expected for map features). There is no local install or extra env vars requested.

功能分析

Type: OpenClaw Skill Name: amap-travel-planner Version: 1.0.1 The skill is a legitimate travel planning assistant designed to use Amap (高德地图) APIs for route planning, geocoding, and generating travel maps. It requires an `AMAP_API_KEY` and provides clear, functional instructions in SKILL.md for the AI agent to assist users with itineraries, budgets, and navigation. No evidence of malicious intent, data exfiltration, or unauthorized execution was found.

能力标签

requires-sensitive-credentials

能力评估

✓ Purpose & Capability

Name/description promise to use 高德地图路径规划 API and the skill only requests AMAP_API_KEY and references the documented AMap web service endpoints — this is coherent and expected.

✓ Instruction Scope

SKILL.md describes HTTP GET calls to AMap endpoints for geocoding, POI search, directions, and map/QR generation. It does not instruct reading local files, other env vars, or transmitting data to unexpected third parties. It explicitly states location data is sent to AMap (which is required for the functionality).

✓ Install Mechanism

Instruction-only skill with no install spec and no bundled code — lowest install risk; it relies on calling remote HTTP APIs at runtime.

✓ Credentials

Only AMAP_API_KEY is required (declared as primaryEnv). That single credential is proportionate to the described functionality. Note: the key grants access to your AMap account quota and data, so correct scoping and rotation are advisable.

✓ Persistence & Privilege

always:false and no config paths requested. The skill does not request persistent system presence or modify other skills. Autonomous invocation is allowed (platform default) but not elevated here.

版本历史

v1.0.1

- Updated the "display_name" field in SKILL.md from 旅行规划师 Travel Planner to Travel Planner. - No changes to any logic/code, only metadata/documentation updated.

v1.0.0

- Initial release of Travel Planner (version 1.0.0) powered by Amap path planning API. - Provides comprehensive travel lifecycle planning: destination research, itinerary design, budget management, and checklists, all based on real driving/walking/transit data. - Generates accurate time, distance, and route details for each trip segment, replacing rough estimates. - Outputs a travel map as a QR code for direct viewing and navigation in the Amap app. - Features food search, travel tips, and itinerary optimization based on live map data. - Seamless integration with Amap Web Services; requires AMAP_API_KEY setup.

元数据

Slug amap-travel-planner

版本 1.0.1

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 2

常见问题

Amap Travel Planner 是什么？

系统化的旅行规划助手，融合高德路径规划 API 提供真实路线数据。从目的地研究、行程设计、预算管理到清单检查，覆盖旅行全生命周期。基于高德地图真实路径规划数据（驾车/步行/公交），告别拍脑袋估时间，让每一段行程都有精准的距离、时间和路线支撑。最终生成可在高德地图 App 扫码打开的旅行地图。它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 47 次。

如何安装 Amap Travel Planner？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install amap-travel-planner」即可一键安装，无需额外配置。

Amap Travel Planner 是免费的吗？

是的，Amap Travel Planner 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Amap Travel Planner 支持哪些平台？

Amap Travel Planner 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Amap Travel Planner？

由 SmartVicky（@770600682-cyber）开发并维护，当前版本 v1.0.1。

Amap Travel Planner