前言¶
給 Agent 安排出行相關任務時,常見的做法是自己寫一段腳本去調高德 Web 服務 API:先找文檔、再拼 URL、然後處理簽名和返回結構。這部分工作重複且瑣碎,而且每次換任務都要重寫一遍。下面介紹的這個 Skill 把這幾件事收斂成一個可複用的最小單元:Agent 在需要地點搜索、天氣查詢或路線規劃時直接調用,不用每次重新對接。
這是什麼¶
高德地圖 (Amap) 是一個面向 Agent 的 Skill,定位是「使用高德地圖 Web 服務 API 進行地點搜索、天氣查詢和路線規劃」。它由企業(enterprise)來源發佈,維護者爲 RealQ,當前版本 1.0.0,歸屬 life-service 分類。
它解決的問題很直接:讓 Agent 在對話或任務流程中發起高德地圖相關的查詢,而不需要使用者自己維護 API 調用代碼。Skill 標籤中帶有 requires_api_key=true,說明它依賴外部密鑰才能工作。
核心功能¶
Skill 的能力範圍與高德地圖 Web 服務 API 的能力範圍一致,目前包含三項:
1、地點搜索:按關鍵字或條件檢索地點,拿到位置信息。
2、天氣查詢:查詢指定位置的天氣情況。
3、路線規劃:在起終點之間規劃路線。
三項能力都建立在高德地圖 Web 服務 API 之上,因此返回結果的字段、精度和可用範圍由該 API 決定,Skill 本身不額外提供數據。
安裝與啓用¶
Skill 通過 SkillHub 分發,座標爲 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-amap。
需要說明的是:在已抓取的官方資料中,沒有給出具體的安裝命令、安裝目錄和配置字段名稱,因此這裏不臆造命令。下面只列出啓用前必須確認的兩件事。
前置條件一,密鑰。Skill 標籤標明 requires_api_key=true,需要自備高德地圖 Web 服務 API 的 Key,並在 Skill 的配置中填入。配置項的具體名稱以官方 SKILL.md 爲準。
前置條件二,運行環境。這類 Skill 基於通用 SKILL.md 格式,能否加載取決於你使用的 Agent 宿主(如 Cursor、Codex CLI、Claude Code 等)是否支持該格式。已抓取資料中沒有針對具體宿主的差異化說明,所以這裏不做分別描述。
拿到安裝命令的可靠方式是打開下面的官方地址,在 SkillHub 頁面中按頁面提示操作。
官方地址:https://www.skillhub.cn/skills/org-eyw2ohcx/sundial-org-awesome-openclaw-skills-amap
API 地址:https://api.skillhub.cn/org-eyw2ohcx/sundial-org-awesome-openclaw-skills-amap
典型用法¶
安裝並配好密鑰之後,就可以把任務交給 Agent 了。下面三類請求分別對應 Skill 的三項能力(這裏是示例請求,實際返回內容以調用時的接口結果爲準):
幫我搜一下「杭州西湖附近的停車場」。
幫我查一下杭州今天的天氣。
幫我規劃從北京西站到首都機場的駕車路線。
使用方式與調用其它高德 Web 服務 API 相同:Agent 側發起查詢,Skill 負責把請求落到對應的接口上。地點搜索、天氣查詢和路線規劃分別對應高德地圖 Web 服務的不同接口,Skill 內部做了歸類。
適用場景與注意¶
適合的場景:已經在用 Agent 處理出行、差旅、同城配送、地點篩選這類任務,希望省去手寫高德 API 調用代碼;或者想在同一套對話流程裏同時用到搜索、天氣和路線三類信息。
需要注意的幾點:
1、密鑰是必須的。沒有配 Key,Skill 無法工作,請提前準備好高德地圖 Web 服務 API 的 Key。
2、能力邊界就是高德地圖 Web 服務 API 的邊界。它不提供與高德地圖無關的地理能力,也不保證數據實時性超出該 API 的範圍。
3、路線規劃的具體參數(如出行方式、避讓條件)取決於所調用接口的支持情況,超出接口支持的參數不會被 Skill 自行處理。
4、截至抓取時,Skill 頁面顯示安裝數爲 0、評分 100000、下載 1074。安裝數爲 0 不代表 Skill 不可用,但說明它目前的採用情況還沒有公開數據支撐,建議先在小範圍任務裏驗證返回結果是否符合預期。
小結¶
高德地圖 (Amap) Skill 的價值在於把高德地圖 Web 服務 API 的地點搜索、天氣查詢和路線規劃三項能力打包成一個可直接被 Agent 調用的單元,省去使用者自己寫對接代碼的成本。它由 RealQ 維護,企業來源發佈,當前版本 1.0.0,需要自備 API Key。官方地址:https://www.skillhub.cn/skills/org-eyw2ohcx/sundial-org-awesome-openclaw-skills-amap