{"id":"721d3246-abfe-4f84-bb70-a48a918724ff","entityType":"agent","slug":"clawhub-lbs-amap-personal-map","name":"Gaode Map Personal - 高德官方个人专属地图 Skill","canonicalUrl":"https://www.xpersona.co/agent/clawhub-lbs-amap-personal-map","canonicalPath":"/agent/clawhub-lbs-amap-personal-map","generatedAt":"2026-10-10T15:52:01.167Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T13:34:47.412Z","emptyReason":null},"description":"高德地图个人专属地图生成工具。封装了高德开放平台的Web服务API，提供地理编码、POI搜索、路径规划、周边搜索、天气查询等能力，最终生成可在高德地图App中打开的个人地图小程序二维码。当用户提到以下任意场景时，都应主动使用本技能：查找附近的餐厅/景点/商场等POI、规划从A到B的路线（步行/驾车/公交/骑行）、... Skill: Gaode Map Personal - 高德官方个人专属地图 Skill Owner: lbs-amap Summary: 高德地图个人专属地图生成工具。封装了高德开放平台的Web服务API，提供地理编码、POI搜索、路径规划、周边搜索、天气查询等能力，最终生成可在高德地图App中打开的个人地图小程序二维码。当用户提到以下任意场景时，都应主动使用本技能：查找附近的餐厅/景点/商场等POI、规划从A到B的路线（步行/驾车/公交/骑行）、... Tags: latest:1.0.0 Version history: v1.0.0 | 2026-04-20T02:44:16.108Z | user 首次发布：高德地图个人专属地图生成工具，支持地理编码、POI搜索、路径规划，生成可在高德地图App中扫码打开的个人地图 Archive index: Archive v1.0.0: 7 files, 14572 bytes","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.4K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s175kkx7bgg448fksjnhth7b1n83p4n5:personal-map","sourceUrl":"https://clawhub.ai/lbs-amap/personal-map","homepage":"https://clawhub.ai/lbs-amap/skills/personal-map","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/lbs-amap/personal-map","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/lbs-amap/skills/personal-map","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":63,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"高德地图个人专属地图生成工具。封装了高德开放平台的Web服务API，提供地理编码、POI搜索、路径规划、周边搜索、天气查询等能力，最终生成可在高德地图App中打开的个人地图小程序二维码。当用户提到以下任意场景时，都应主动使用本技能：查找附近的餐厅/景点/商场等POI、规划从A到B的路线（步行/驾车/公交/骑行）、..."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T13:34:47.412Z","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-10T13:34:47.412Z","emptyReason":null},"stars":null,"forks":null,"downloads":1409,"packageName":null,"latestVersion":"1.0.0","tractionLabel":"1.4K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T13:34:47.412Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T13:34:47.412Z","lastCrawledAt":"2026-10-10T13:34:47.412Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T13:34:47.412Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.0","createdAt":"2026-04-20T02:44:16.108Z","changelog":"首次发布：高德地图个人专属地图生成工具，支持地理编码、POI搜索、路径规划，生成可在高德地图App中扫码打开的个人地图","fileCount":7,"zipByteSize":14572}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s175kkx7bgg448fksjnhth7b1n83p4n5:personal-map","setupComplexity":"medium","setupSteps":["Python environment detected. Create a strict virtual environment (`python -m venv .venv`) before installing dependencies to prevent system-level package conflicts.","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-lbs-amap-personal-map/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lbs-amap-personal-map/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lbs-amap-personal-map/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-lbs-amap-personal-map/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-lbs-amap-personal-map/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-lbs-amap-personal-map/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-10T15:52:01.166Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lbs-amap-personal-map/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lbs-amap-personal-map/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lbs-amap-personal-map/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lbs-amap-personal-map/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-10T13:34:47.412Z","emptyReason":null},"readme":"Skill: Gaode Map Personal - 高德官方个人专属地图 Skill\n\nOwner: lbs-amap\n\nSummary: 高德地图个人专属地图生成工具。封装了高德开放平台的Web服务API，提供地理编码、POI搜索、路径规划、周边搜索、天气查询等能力，最终生成可在高德地图App中打开的个人地图小程序二维码。当用户提到以下任意场景时，都应主动使用本技能：查找附近的餐厅/景点/商场等POI、规划从A到B的路线（步行/驾车/公交/骑行）、...\n\nTags: latest:1.0.0\n\nVersion history:\n\nv1.0.0 | 2026-04-20T02:44:16.108Z | user\n\n首次发布：高德地图个人专属地图生成工具，支持地理编码、POI搜索、路径规划，生成可在高德地图App中扫码打开的个人地图\n\nArchive index:\n\nArchive v1.0.0: 7 files, 14572 bytes\n\nFiles: config.json (798b), examples/demo_usage.py (6956b), requirements.txt (344b), scripts/amap_personal_map_client.py (25918b), skill-card.md (2685b), SKILL.md (9733b), _meta.json (131b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: personal-map\ndisplay_name: Gaode Map Personal - 高德官方个人专属地图 Skill\ndescription: 高德地图个人专属地图生成工具。封装了高德开放平台的Web服务API，提供地理编码、POI搜索、路径规划、周边搜索、天气查询等能力，最终生成可在高德地图App中打开的个人地图小程序二维码。当用户提到以下任意场景时，都应主动使用本技能：查找附近的餐厅/景点/商场等POI、规划从A到B的路线（步行/驾车/公交/骑行）、生成旅游行程/出行计划/打卡地图、在地图上标记多个地点、分享地图给他人、查询某地天气、将地址转换为坐标或反向解析、制作个人专属地图、行程规划、路线规划、地图分享。即使用户没有明确说\"生成地图\"，只要涉及地理位置、出行、导航、打卡、行程等话题，都应考虑使用本技能。\nversion: 1.0.0\nauthor: 高德开放平台\ntags:\n  - 地图\n  - 高德\n  - Map\n  - 个人地图\n  - POI\n  - 路径规划\nmetadata:\n  openclaw:\n    requires:\n      env:\n        - AMAP_API_KEY\n    primaryEnv: AMAP_API_KEY\n---\n\n# 高德个人地图 Skill\n\n## 概述\n\n本 Skill 封装了高德开放平台的 Web 服务 API，提供地理编码、POI 搜索、路径规划等核心能力，根据用户描述生成个人专属地图，并支持在高德地图 App 中扫码打开。\n\n**重要**：所有调用此技能的会话，最终都应调用 `maps_schema_personal_map` 生成个人地图二维码，并通过以下方式展示给用户：\n1. **下载二维码图片到本地**（推荐保存到工作目录）\n2. **使用 `present` 工具展示图片**\n3. **在回复中直接嵌入 Markdown 图片**（双重保障）\n4. **提供备用 URL 链接**（防止图片展示失败）\n\n这样可以确保用户能够可靠地看到并保存二维码。\n\n## 接口说明\n\n### 1. 地理编码\n\n- **`maps_geo`**：地址 → 经纬度坐标\n  - 参数：`address`（详细地址）、`city`（城市，可选）\n  - 返回：经纬度坐标、格式化地址\n\n- **`maps_regeocode`**：经纬度坐标 → 结构化地址\n  - 参数：`longitude`（经度）、`latitude`（纬度）\n  - 返回：国家、省份、城市、区县等完整地址信息\n\n### 2. POI 搜索\n\n- **`maps_text_search`**：关键词搜索兴趣点\n  - 参数：`keywords`（搜索关键词）、`city`（城市，可选）、`offset`（每页记录数，默认 20）\n  - 返回：POI 列表（名称、坐标、地址、电话）\n\n- **`maps_around_search`**：周边兴趣点搜索\n  - 参数：`keywords`、`location`（中心点\"经度,纬度\"）、`radius`（搜索半径，单位米，默认 1000）、`types`（POI 类型，可选）、`offset`（默认 20）、`page`（默认 1）\n  - 返回：周边 POI 列表（含距离信息）\n\n### 3. 路径规划\n\n- **`maps_direction_walking`**：步行路线规划\n  - 参数：`origin`（起点\"经度,纬度\"）、`destination`（终点\"经度,纬度\"）\n\n- **`maps_direction_driving`**：驾车路线规划\n  - 参数：`origin`、`destination`\n\n- **`maps_direction_transit_integrated`**：公共交通路线规划\n  - 参数：`origin`、`destination`、`city`（城市，默认\"北京\"）\n\n### 4. 位置服务\n\n- **`maps_ip_location`**：IP 地址 → 地理位置\n  - 参数：`ip`（IP 地址）\n  - 返回：省份、城市、行政区、ISP 等信息\n\n### 5. 地图生成（核心）\n\n- **`maps_schema_personal_map`**：生成个人地图小程序二维码\n  - 参数：\n    - `orgName`（地图名称）\n    - `lineList`（行程列表，每条路线最多 16 个点）\n    - `sceneType`（场景类型，可选，默认 `1`）：\n      - `1` — 创建资源点且创建路线（默认，通用场景）\n      - `2` — 仅创建资源点（搜索类数据，多个点之间无关联关系）\n      - `3` — 仅创建路线（路径规划类数据，多个点有关联关系，如起终点、换乘点）\n  - 返回：`qr_code_url`（二维码图片链接）、`lineList`（行程数据）\n\n  **sceneType 选择指引：**\n  - 用户做的是**搜索**（找餐厅、找景点、找周边 POI 等）→ 用 `sceneType=2`\n  - 用户做的是**路径规划**（从 A 到 B、导航、换乘等）→ 用 `sceneType=3`\n  - 两者都有，或不确定 → 用默认 `sceneType=1`\n\n## 使用前提\n\n1. 申请高德地图开发者账号并获取 API Key（https://lbs.amap.com/）\n2. 配置环境变量：`export AMAP_API_KEY='your_api_key_here'`\n3. 确保网络连接正常\n\n## 异常处理\n\n所有接口在出错时均返回结构化错误信息，不会抛出异常：\n\n```python\n{\"error\": \"错误类型\", \"message\": \"具体原因\"}\n```\n\n常见错误类型：`API Key 缺失`、`请求失败`、`搜索失败`、`路径规划失败`、`生成地图行程失败`。\n\n检查返回值的推荐方式：\n```python\nresult = client.maps_text_search(\"餐厅\", \"北京\")\nif isinstance(result, list) and result and \"error\" in result[0]:\n    print(f\"错误: {result[0]['message']}\")\n```\n\n## 使用示例\n\n### 初始化客户端\n\n```python\nfrom scripts.amap_personal_map_client import AMapPersonalMapClient\n\nclient = AMapPersonalMapClient()  # 读取环境变量 AMAP_API_KEY\n# 或直接传入：client = AMapPersonalMapClient(api_key='your_api_key_here')\n```\n\n### 地理编码\n\n```python\n# 地址转坐标\nresult = client.maps_geo(\"北京市朝阳区三里屯\", \"北京\")\nprint(f\"经度: {result['longitude']}, 纬度: {result['latitude']}\")\n\n# 坐标转地址\nresult = client.maps_regeocode(116.447716, 39.906736)\nprint(f\"完整地址: {result['formatted_address']}\")\n```\n\n### POI 搜索\n\n```python\n# 关键词搜索\npois = client.maps_text_search(\"烤鸭\", \"北京\", offset=20)\nfor poi in pois:\n    print(f\"{poi['name']} - {poi['address']}\")\n\n# 周边搜索\npois = client.maps_around_search(keywords=\"餐厅\", location=\"116.397451,39.909221\", radius=1000)\nfor poi in pois:\n    print(f\"{poi['name']}, 距离: {poi.get('distance', '未知')}米\")\n```\n\n### 路径规划\n\n```python\n# 步行\nresult = client.maps_direction_walking(\"116.397451,39.909221\", \"116.397029,39.917839\")\n\n# 驾车\nresult = client.maps_direction_driving(\"116.397451,39.909221\", \"116.397029,39.917839\")\n\n# 公共交通\nresult = client.maps_direction_transit_integrated(\"116.397451,39.909221\", \"116.397029,39.917839\", city=\"北京\")\n```\n\n### 生成个人地图（最终步骤）\n\n```python\nimport urllib.request\nfrom scripts.amap_personal_map_client import AMapPersonalMapClient\n\nclient = AMapPersonalMapClient()\n\nline_list = [{\n    \"title\": \"北京市中心一日游\",\n    \"pointInfoList\": [\n        {\"name\": \"天安门广场\", \"lon\": 116.397451, \"lat\": 39.909221, \"poiId\": \"B000A8URXB\"},\n        {\"name\": \"故宫博物院\",  \"lon\": 116.397029, \"lat\": 39.917839, \"poiId\": \"B000A8URXC\"}\n    ]\n}]\n\n# 搜索类数据 → sceneType=2（仅创建资源点）\nresult = client.maps_schema_personal_map(\"北京热门景点\", line_list, sceneType=2)\n\n# 路径规划类数据 → sceneType=3（仅创建路线）\nresult = client.maps_schema_personal_map(\"北京一日游路线\", line_list, sceneType=3)\n\n# 通用场景（默认）\nresult = client.maps_schema_personal_map(\"北京市中心一日游\", line_list)\n\n# 下载并保存二维码图片到本地\nqr_url = result['qr_code_url']\noutput_path = '/path/to/output/个人地图二维码.png'\nurllib.request.urlretrieve(qr_url, output_path)\n\n# 使用 present 工具展示图片（实际使用时通过工具调用）\n# present(artifacts=[output_path])\n\n# 在回复中嵌入 Markdown 图片（双重保障）\nprint(f\"![个人地图二维码](file://{output_path})\")\n\n# 提供备用 URL 链接\nprint(f\"备用链接: {qr_url}\")\n```\n\n### 会话管理\n\nAMAP_API_KEY 配置正常的前提下，每次会话结束请调用 `maps_schema_personal_map` 生成个人地图二维码，并**按以下步骤展示**：\n\n1. **下载二维码图片**：使用 `urllib.request.urlretrieve()` 将二维码保存到本地工作目录\n2. **调用 `present` 工具**：将保存的图片路径传入 `present` 工具展示\n3. **Markdown 嵌入**：在回复中使用 `![描述](file://路径)` 格式嵌入图片\n4. **提供备用链接**：同时输出二维码的原始 URL，以防图片展示失败\n\n用户可以通过高德地图 App 扫描二维码打开个人地图小程序页。\n\n**最佳实践示例：**\n```python\nimport urllib.request\nfrom scripts.amap_personal_map_client import AMapPersonalMapClient\n\nclient = AMapPersonalMapClient()\n\n# ... 搜索/规划逻辑 ...\n\nresult = client.maps_schema_personal_map(\"我的地图\", line_list, sceneType=2)\n\n# 1. 保存二维码到本地\nqr_path = '/workspace/我的地图二维码.png'\nurllib.request.urlretrieve(result['qr_code_url'], qr_path)\n\n# 2. 调用 present 工具展示\n# present(artifacts=[qr_path])\n\n# 3. 在回复中嵌入图片和备用链接\nprint(f\"![个人地图](file://{qr_path})\")\nprint(f\"备用链接: {result['qr_code_url']}\")\n```\n\n## logo\n![](https://img.alicdn.com/imgextra/i4/O1CN01OIfavw1VGuqFZdQnc_!!6000000002636-2-tps-256-256.png)\n\n## 使用场景\n1. 旅游路线规划与地图分享\n2. 周边 POI 搜索与标记\n3. 通勤/出行路径规划\n4. 商业选址与市场分析\n5. 物流配送路径优化\n\n## changelog\n\n### v1.2.0\n- `maps_schema_personal_map` 新增 `sceneType` 参数，支持按场景控制创建资源点/路线\n\n### v1.1.0\n- 新增骑行路线规划功能\n- 新增 URI 生成功能（导航页面唤起、打车页面唤起）\n- 完善会话管理机制，提升用户体验\n- 优化错误处理和异常情况应对\n\n### v1.0.0\n- 初始版本发布\n- 支持地理编码、POI 搜索、路径规划等核心功能\n- 支持生成个人地图小程序二维码\n- 支持会话管理与二维码自动生成\n\nFile v1.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn73td2wbekk991h1j29rjzba982bv3e\",\n  \"slug\": \"personal-map\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1776653056108\n}\n\nFile v1.0.0:skill-card.md\n\n## Description:\n\nGenerates personal Gaode Map QR codes and supports geocoding, reverse geocoding, POI search, nearby search, route planning, and IP location through the AMap Web Service API.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[lbs-amap](https://clawhub.ai/user/lbs-amap)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill to turn address, POI, nearby-place, and route requests into Gaode Map personal-map QR codes that can be opened in the Gaode Map app.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Sensitive addresses, trips, customer locations, or private itineraries may be sent to AMap services and to a QR generation service.\n\nMitigation: Use the skill only when sharing that location data with those services is acceptable, and avoid private or regulated location data unless appropriate approval is in place.\n\nRisk: Generated QR images, schema URLs, and fallback links can reveal personal map or itinerary details if saved or shared broadly.\n\nMitigation: Store generated files in a controlled workspace, limit redistribution of QR codes and URLs, and remove generated artifacts when they are no longer needed.\n\nRisk: The artifact instructs sessions to generate a personal-map QR code broadly, which can be surprising when the user only wanted search or routing information.\n\nMitigation: Confirm the user wants a QR code or personal-map link before generating, downloading, or presenting map artifacts.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/lbs-amap/skills/personal-map)\n- [ClawHub publisher profile](https://clawhub.ai/user/lbs-amap)\n- [Gaode Open Platform](https://lbs.amap.com/)\n- [QR code generation service endpoint](https://api.qrserver.com/v1/create-qr-code/)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Files, Guidance]\n\n**Output Format:** [Markdown guidance with Python examples, shell environment setup, JSON-like API results, URLs, and local QR image files.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires AMAP_API_KEY; map and itinerary data may be sent to AMap services and QR generation services when QR code output is requested.]\n\n## Skill Version(s):\n\n1.0.0 (source: server release evidence, SKILL.md frontmatter, and config.json; artifact changelog also mentions v1.2.0)\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\nFile v1.0.0:config.json\n\n{\n  \"skill\": {\n    \"name\": \"personal-map\",\n    \"version\": \"1.0.0\",\n    \"description\": \"高德个人地图Skill，直接调用高德地图官方RESTful API，提供完整的地理信息服务能力，并支持地图在高德App中扫码查看及分析给他人\",\n    \"author\": \"高德开放平台\",\n    \"license\": \"MIT\"\n  },\n  \"dependencies\": {\n    \"requests\": \"^2.25.1\"\n  },\n  \"env_vars\": {\n    \"AMAP_API_KEY\": {\n      \"description\": \"高德地图API Key。首次使用时，系统会自动检测并提示配置。获取步骤：1. 访问 https://lbs.amap.com/ 2. 注册/登录账号 3. 创建应用获取 Web服务 API Key。配置方式：export AMAP_API_KEY='your_api_key_here' 或在初始化时传入\",\n      \"required\": true\n    }\n  },\n  \"entry_point\": \"scripts/amap_personal_map_client.py\"\n}\n\nFile v1.0.0:requirements.txt\n\n# 高德地图 Personal-Map Skill 依赖包\n# \n# 安装方式：\n#   pip install -r requirements.txt\n#\n# 或者使用虚拟环境：\n#   python -m venv venv\n#   source venv/bin/activate  # Linux/Mac\n#   # 或 venv\\Scripts\\activate  # Windows\n#   pip install -r requirements.txt\n\n# HTTP 请求库，用于调用高德地图 API\nrequests>=2.25.1","readmeExcerpt":"Skill: Gaode Map Personal - 高德官方个人专属地图 Skill Owner: lbs-amap Summary: 高德地图个人专属地图生成工具。封装了高德开放平台的Web服务API，提供地理编码、POI搜索、路径规划、周边搜索、天气查询等能力，最终生成可在高德地图App中打开的个人地图小程序二维码。当用户提到以下任意场景时，都应主动使用本技能：查找附近的餐厅/景点/商场等POI、规划从A到B的路线（步行/驾车/公交/骑行）、... Tags: latest:1.0.0 Version history: v1.0.0 | 2026-04-20T02:44:16.108Z | user 首次发布：高德地图个人专属地图生成工具，支持地理编码、POI搜索、路径规划，生成可在高德地图App中扫码打开的个人地图 Archive index: Archive v1.0.0: 7 files, 14572 bytes ","codeSnippets":[],"executableExamples":[{"language":"python","snippet":"{\"error\": \"错误类型\", \"message\": \"具体原因\"}"},{"language":"python","snippet":"result = client.maps_text_search(\"餐厅\", \"北京\")\nif isinstance(result, list) and result and \"error\" in result[0]:\n    print(f\"错误: {result[0]['message']}\")"},{"language":"python","snippet":"from scripts.amap_personal_map_client import AMapPersonalMapClient\n\nclient = AMapPersonalMapClient()  # 读取环境变量 AMAP_API_KEY\n# 或直接传入：client = AMapPersonalMapClient(api_key='your_api_key_here')"},{"language":"python","snippet":"# 地址转坐标\nresult = client.maps_geo(\"北京市朝阳区三里屯\", \"北京\")\nprint(f\"经度: {result['longitude']}, 纬度: {result['latitude']}\")\n\n# 坐标转地址\nresult = client.maps_regeocode(116.447716, 39.906736)\nprint(f\"完整地址: {result['formatted_address']}\")"},{"language":"python","snippet":"# 关键词搜索\npois = client.maps_text_search(\"烤鸭\", \"北京\", offset=20)\nfor poi in pois:\n    print(f\"{poi['name']} - {poi['address']}\")\n\n# 周边搜索\npois = client.maps_around_search(keywords=\"餐厅\", location=\"116.397451,39.909221\", radius=1000)\nfor poi in pois:\n    print(f\"{poi['name']}, 距离: {poi.get('distance', '未知')}米\")"},{"language":"python","snippet":"# 步行\nresult = client.maps_direction_walking(\"116.397451,39.909221\", \"116.397029,39.917839\")\n\n# 驾车\nresult = client.maps_direction_driving(\"116.397451,39.909221\", \"116.397029,39.917839\")\n\n# 公共交通\nresult = client.maps_direction_transit_integrated(\"116.397451,39.909221\", \"116.397029,39.917839\", city=\"北京\")"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: personal-map\ndisplay_name: Gaode Map Personal - 高德官方个人专属地图 Skill\ndescription: 高德地图个人专属地图生成工具。封装了高德开放平台的Web服务API，提供地理编码、POI搜索、路径规划、周边搜索、天气查询等能力，最终生成可在高德地图App中打开的个人地图小程序二维码。当用户提到以下任意场景时，都应主动使用本技能：查找附近的餐厅/景点/商场等POI、规划从A到B的路线（步行/驾车/公交/骑行）、生成旅游行程/出行计划/打卡地图、在地图上标记多个地点、分享地图给他人、查询某地天气、将地址转换为坐标或反向解析、制作个人专属地图、行程规划、路线规划、地图分享。即使用户没有明确说\"生成地图\"，只要涉及地理位置、出行、导航、打卡、行程等话题，都应考虑使用本技能。\nversion: 1.0.0\nauthor: 高德开放平台\ntags:\n  - 地图\n  - 高德\n  - Map\n  - 个人地图\n  - POI\n  - 路径规划\nmetadata:\n  openclaw:\n    requires:\n      env:\n        - AMAP_API_KEY\n    primaryEnv: AMAP_API_KEY\n---\n\n# 高德个人地图 Skill\n\n## 概述\n\n本 Skill 封装了高德开放平台的 Web 服务 API，提供地理编码、POI 搜索、路径规划等核心能力，根据用户描述生成个人专属地图，并支持在高德地图 App 中扫码打开。\n\n**重要**：所有调用此技能的会话，最终都应调用 `maps_schema_personal_map` 生成个人地图二维码，并通过以下方式展示给用户：\n1. **下载二维码图片到本地**（推荐保存到工作目录）\n2. **使用 `present` 工具展示图片**\n3. **在回复中直接嵌入 Markdown 图片**（双重保障）\n4. **提供备用 URL 链接**（防止图片展示失败）\n\n这样可以确保用户能够可靠地看到并保存二维码。\n\n## 接口说明\n\n### 1. 地理编码\n\n- **`maps_geo`**：地址 → 经纬度坐标\n  - 参数：`address`（详细地址）、`city`（城市，可选）\n  - 返回：经纬度坐标、格式化地址\n\n- **`maps_regeocode`**：经纬度坐标 → 结构化地址\n  - 参数：`longitude`（经度）、`latitude`（纬度）\n  - 返回：国家、省份、城市、区县等完整地址信息\n\n### 2. POI 搜索\n\n- **`maps_text_search`**：关键词搜索兴趣点\n  - 参数：`keywords`（搜索关键词）、`city`（城市，可选）、`offset`（每页记录数，默认 20）\n  - 返回：POI 列表（名称、坐标、地址、电话）\n\n- **`maps_around_search`**：周边兴趣点搜索\n  - 参数：`keywords`、`location`（中心点\"经度,纬度\"）、`radius`（搜索半径，单位米，默认 1000）、`types`（POI 类型，可选）、`offset`（默认 20）、`page`（默认 1）\n  - 返回：周边 POI 列表（含距离信息）\n\n### 3. 路径规划\n\n- **`maps_direction_walking`**：步行路线规划\n  - 参数：`origin`（起点\"经度,纬度\"）、`destination`（终点\"经度,纬度\"）\n\n- **`maps_direction_driving`**：驾车路线规划\n  - 参数：`origin`、`destination`\n\n- **`maps_direction_transit_integrated`**：公共交通路线规划\n  - 参数：`origin`、`destination`、`city`（城市，默认\"北京\"）\n\n### 4. 位置服务\n\n- **`maps_ip_location`**：IP 地址 → 地理位置\n  - 参数：`ip`（IP 地址）\n  - 返回：省份、城市、行政区、ISP 等信息\n\n### 5. 地图生成（核心）\n\n- **`maps_schema_personal_map`**：生成个人地图小程序二维码\n  - 参数：\n    - `orgName`（地图名称）\n    - `lineList`（行程列表，每条路线最多 16 个点）\n    - `sceneType`（场景类型，可选，默认 `1`）：\n      - `1` — 创建资源点且创建路线（默认，通用场景）\n      - `2` — 仅创建资源点（搜索类数据，多个点之间无关联关系）\n      - `3` — 仅创建路线（路径规划类数据，多个点有关联关系，如起终点、换乘点）\n  - 返回：`qr_code_url`（二维码图片链接）、`lineList`（行程数据）\n\n  **sceneType 选择指引：**\n  - 用户做的是**搜索**（找餐厅、找景点、找周边 POI 等）→ 用 `sceneType=2`\n  - 用户做的是**路径规划**（从 A 到 B、导航、换乘等）→ 用 `sceneType=3`\n  - 两者都有，或不确定 → 用默认 `sceneType=1`\n\n## 使用前提\n\n1. 申请高德地图开发者账号并获取 API Key（https://lbs.amap.com/）\n2. 配置环境变量：`export AMAP_API_KEY='your_api_key_here'`\n3. 确保网络连接正常\n\n## 异常处理\n\n所有接口在出错时均返回结构化错误信息，不会抛出异常：\n\n```python\n{\"error\": \"错误类型\", \"message\": \"具体原因\"}\n```\n\n常见错误类型：`API Key 缺失`、`请求失败`、`搜索失败`、`路径规划失败`、`生成地图行程失败`。\n\n检查返回值的推荐方式：\n```python\nresult = client.maps_text_search(\"餐厅\", \"北京\")\nif isinstance(result, list) and result and \"error\" in result[0]:\n    print(f\"错误: {result[0]['message']}\")\n```\n\n## 使用示例\n\n### 初始化客户端\n\n```python\nfrom scripts.amap_personal_map_client import AMapPersonalMapClient\n\nclient = AMapPersonalMapClient()  # 读取环境变量 AMAP_API_KEY\n# 或直接传入：client = AMapPersonalMapClient(api_key='your_api_key_here')\n```\n\n### 地理编码\n\n```python\n# 地址转坐标\nresult = client."},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn73td2wbekk991h1j29rjzba982bv3e\",\n  \"slug\": \"personal-map\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1776653056108\n}"},{"path":"skill-card.md","content":"## Description:\n\nGenerates personal Gaode Map QR codes and supports geocoding, reverse geocoding, POI search, nearby search, route planning, and IP location through the AMap Web Service API.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[lbs-amap](https://clawhub.ai/user/lbs-amap)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill to turn address, POI, nearby-place, and route requests into Gaode Map personal-map QR codes that can be opened in the Gaode Map app.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Sensitive addresses, trips, customer locations, or private itineraries may be sent to AMap services and to a QR generation service.\n\nMitigation: Use the skill only when sharing that location data with those services is acceptable, and avoid private or regulated location data unless appropriate approval is in place.\n\nRisk: Generated QR images, schema URLs, and fallback links can reveal personal map or itinerary details if saved or shared broadly.\n\nMitigation: Store generated files in a controlled workspace, limit redistribution of QR codes and URLs, and remove generated artifacts when they are no longer needed.\n\nRisk: The artifact instructs sessions to generate a personal-map QR code broadly, which can be surprising when the user only wanted search or routing information.\n\nMitigation: Confirm the user wants a QR code or personal-map link before generating, downloading, or presenting map artifacts.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/lbs-amap/skills/personal-map)\n- [ClawHub publisher profile](https://clawhub.ai/user/lbs-amap)\n- [Gaode Open Platform](https://lbs.amap.com/)\n- [QR code generation service endpoint](https://api.qrserver.com/v1/create-qr-code/)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Files, Guidance]\n\n**Output Format:** [Markdown guidance with Python examples, shell environment setup, JSON-like API results, URLs, and local QR image files.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires AMAP_API_KEY; map and itinerary data may be sent to AMap services and QR generation services when QR code output is requested.]\n\n## Skill Version(s):\n\n1.0.0 (source: server release evidence, SKILL.md frontmatter, and config.json; artifact changelog also mentions v1.2.0)\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."},{"path":"config.json","content":"{\n  \"skill\": {\n    \"name\": \"personal-map\",\n    \"version\": \"1.0.0\",\n    \"description\": \"高德个人地图Skill，直接调用高德地图官方RESTful API，提供完整的地理信息服务能力，并支持地图在高德App中扫码查看及分析给他人\",\n    \"author\": \"高德开放平台\",\n    \"license\": \"MIT\"\n  },\n  \"dependencies\": {\n    \"requests\": \"^2.25.1\"\n  },\n  \"env_vars\": {\n    \"AMAP_API_KEY\": {\n      \"description\": \"高德地图API Key。首次使用时，系统会自动检测并提示配置。获取步骤：1. 访问 https://lbs.amap.com/ 2. 注册/登录账号 3. 创建应用获取 Web服务 API Key。配置方式：export AMAP_API_KEY='your_api_key_here' 或在初始化时传入\",\n      \"required\": true\n    }\n  },\n  \"entry_point\": \"scripts/amap_personal_map_client.py\"\n}"},{"path":"requirements.txt","content":"# 高德地图 Personal-Map Skill 依赖包\n# \n# 安装方式：\n#   pip install -r requirements.txt\n#\n# 或者使用虚拟环境：\n#   python -m venv venv\n#   source venv/bin/activate  # Linux/Mac\n#   # 或 venv\\Scripts\\activate  # Windows\n#   pip install -r requirements.txt\n\n# HTTP 请求库，用于调用高德地图 API\nrequests>=2.25.1"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"高德地图个人专属地图生成工具。封装了高德开放平台的Web服务API，提供地理编码、POI搜索、路径规划、周边搜索、天气查询等能力，最终生成可在高德地图App中打开的个人地图小程序二维码。当用户提到以下任意场景时，都应主动使用本技能：查找附近的餐厅/景点/商场等POI、规划从A到B的路线（步行/驾车/公交/骑行）、... Skill: Gaode Map Personal - 高德官方个人专属地图 Skill Owner: lbs-amap Summary: 高德地图个人专属地图生成工具。封装了高德开放平台的Web服务API，提供地理编码、POI搜索、路径规划、周边搜索、天气查询等能力，最终生成可在高德地图App中打开的个人地图小程序二维码。当用户提到以下任意场景时，都应主动使用本技能：查找附近的餐厅/景点/商场等POI、规划从A到B的路线（步行/驾车/公交/骑行）、... Tags: latest:1.0.0 Version history: v1.0.0 | 2026-04-20T02:44:16.108Z | user 首次发布：高德地图个人专属地图生成工具，支持地理编码、POI搜索、路径规划，生成可在高德地图App中扫码打开的个人地图 Archive index: Archive v1.0.0: 7 files, 14572 bytes","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":959,"uniquenessScore":52,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T13:34:47.412Z","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-10T13:34:47.412Z","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-10T15:52:01.167Z","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"}]}}}