基础能力 SKILL (适用于搜索、规划、数据可视化等) 最后更新时间: 2026年03月13日

Skill 让 AI 助手学会新技能。OpenClaw 通过安装不同的 Skill，AI 助手可以获得特定领域的专业能力，在对话中自动识别用户意图并调用对应的 Skill 来完成任务。

高德地图目前提供了两个核心 Skill：

快速安装使用

基础能力

amap-jsapi-skill - 前端地图开发技能

该 Skill 涵盖高德地图 JS API v2.0 (WebGL) 的完整开发能力：

• 地图生命周期管理：加载器引入、安全密钥配置、Map 实例创建与销毁
• 3D 视图控制：缩放（zoom）、平移（center）、俯仰（pitch）、旋转（rotation）
• 覆盖物绘制：点标记（Marker）、海量标注（LabelMarker）、信息窗体（InfoWindow）、右键菜单（ContextMenu）
• 矢量图形：折线（Polyline）、多边形（Polygon）、圆（Circle）、贝塞尔曲线（BezierCurve）、椭圆（Ellipse）、矩形（Rectangle）
• 图层管理：标准图层、卫星图层、路网图层、3D 楼块、WMS/WMTS、Canvas 图层、GLCustomLayer（Three.js 集成）
• 事件系统：点击、拖拽、缩放等交互事件的监听与响应
• LBS 服务插件：地理编码/逆地理编码、路径规划（驾车/步行/公交）、POI 搜索与输入提示
• 工具类：测距工具、鼠标绘制工具、图形编辑器（多边形/折线/圆/椭圆/矩形编辑）

amap-lbs-skill - LBS 综合服务技能

该 Skill 基于高德开放平台的能力，提供开箱即用的地理信息服务：

• POI 搜索：关键词搜索、城市限定、类型筛选
• 周边搜索：基于坐标和半径的周边地点搜索
• 路径规划：步行、驾车、骑行、公交四种出行方式
• 智能旅游规划：自动搜索兴趣点并规划游览路线
• 热力图可视化：将地理坐标数据以热力图形式展示
• 地图链接生成：一键生成高德地图搜索/导航链接
• 配置持久化：API Key 本地存储管理

场景一：搜索能力

搜索是地图应用中最高频的需求。两个 Skill 从不同维度提供了搜索能力。

前端搜索(amap-jsapi-skill)

通过 JS API 的 PlaceSearch 和 AutoComplete 插件，在前端页面中实现交互式搜索体验。

适用场景：需要在自己的网页中嵌入地图搜索功能，用户可以在页面上直接搜索并查看结果。

核心 API：

代码示例：

AMapLoader.load({
    key: '您的Key',
    version: '2.0',
    plugins: ['AMap.PlaceSearch']
}).then((AMap) => {
    const map = new AMap.Map('container', { zoom: 13 });
    const placeSearch = new AMap.PlaceSearch({
        pageSize: 10,
        city: '北京',
        citylimit: true,
        map: map  // 搜索结果自动标注到地图
    });
    placeSearch.search('餐厅', function(status, result) {
        if (status === 'complete') {
            console.log('搜索结果：', result.poiList.pois);
        }
    });
});

开放平台的接口能力搜索(amap-lbs-skill)

通过高德开放平台的接口能力进行搜索，直接返回结构化数据或生成地图链接。

适用场景：对话式交互中快速搜索地点。

场景 1：关键词直接搜索

用户搜索一个明确的类别或地点，直接生成高德地图搜索链接可视化查看。

用户：搜美食
生成：https://www.amap.com/search?query=美食

场景 2：基于位置的周边搜索

用户搜索某个位置周边的地点，需要先通过地理编码获取坐标，再拼接搜索链接。

执行流程：

1. 解析输入：拆分出「位置」和「搜索类别」
2. 地理编码：调用 API 获取位置坐标
3. 生成链接：拼接带坐标的周边搜索链接

用户：西直门周边美食
步骤1 → 位置: 西直门, 类别: 美食
步骤2 → 坐标: 116.353138,39.939385
步骤3 → https://ditu.amap.com/search?query=美食&query\_type=RQBXY&longitude=116.353138&latitude=39.939385&range=1000

场景 3：POI 详细搜索(脚本方式)

支持更多参数和筛选条件的详细搜索：

# 基础搜索
node scripts/poi-search.js --keywords=肯德基 --city=北京

# 周边搜索
node scripts/poi-search.js --keywords=酒店 --location=116.397428,39.90923 --radius=1000

场景二：规划能力

规划能力覆盖日常出行路线规划和旅游行程规划两大方向。

前端路径规划(amap-jsapi-skill)

通过 JS API 的路径规划插件，在地图上直接展示规划结果。

核心 API：

智能旅游规划(amap-lbs-skill)

自动搜索兴趣点并规划游览路线，一站式生成旅游方案。

使用示例：

# 北京一日游：景点 + 美食 + 酒店
node scripts/travel-planner.js --city=北京 --interests=景点,美食,酒店

# 杭州步行游览
node scripts/travel-planner.js --city=杭州 --interests=西湖,美食,茶馆 --routeType=walking

# 上海驾车游览
node scripts/travel-planner.js --city=上海 --interests=外滩,南京路,城隍庙 --routeType=driving

功能特点：

• 自动搜索指定城市的兴趣点（每类最多 5 个）
• 按顺序规划各兴趣点之间的路线
• 支持多种出行方式（步行/驾车/骑行/公交）

场景三：数据可视化能力

数据可视化帮助用户将地理数据直观地展示在地图上。

前端可视化(amap-jsapi-skill)

通过 JS API 提供丰富的可视化图层能力：

核心图层：

其他可视化能力：

• 卫星图层：AMap.TileLayer.Satellite — 展示卫星影像
• 路况图层：AMap.TileLayer.Traffic — 实时路况信息
• 楼块图层：AMap.Buildings — 3D 建筑物展示
• 室内地图：AMap.IndoorMap — 室内楼层地图

在线热力图（amap-lbs-skill）

提供零代码的热力图生成能力，只需提供数据 URL 即可生成可视化链接。

URL 格式：

https://a.amap.com/jsapi_demo_show/static/openclaw/heatmap.html?mapStyle={地图风格}&dataUrl={数据地址(URL编码)}

参数说明：

使用示例：

用户：帮我用这份数据生成热力图，用暗黑模式
数据：https://a.amap.com/Loca/static/loca-v2/demos/mock_data/hz_house_order.json

生成链接：
https://a.amap.com/jsapi_demo_show/static/openclaw/heatmap.html?mapStyle=grey&dataUrl=https%3A%2F%2Fa.amap.com%2FLoca%2Fstatic%2Floca-v2%2Fdemos%2Fmock_data%2Fhz_house_order.json

点击链接即可直接查看热力图效果，无需编写任何代码。

Skill 的选择建议

amap-jsapi-skill

• 环境要求：Node.js
• 必需配置：AMAP_JSAPI_KEY（高德 Web 端开发者 Key）
• 安全密钥：v2.0 起必须配置 securityJsCode，生产环境建议使用代理服务器

amap-lbs-skill

• 环境要求：Node.js、axios
• 必需配置：AMAP_WEBSERVICE_KEY（高德 Web Service Key）
• 配置方式：环境变量 / 命令行参数 / config.json / 首次运行自动提示

Key 获取方式

1. 访问 高德开放平台 注册账号
2. 进入 控制台 创建应用
3. 根据需要创建 Web 端 Key（JS API 用）或 Web 服务 Key（Web Service 用）

OpenClaw 安装 Skill 教程：

以安装 amap-jsapi-skill（高德地图 JSAPI 技能）为例

Skill 通过 ClawHub 平台分发，安装简单，开箱即用。

前置准备

确认你已安装 OpenClaw，然后安装 ClawHub CLI：

npm install -g clawhub

验证安装：

clawhub --version

第一步：在 ClawHub 上找到 Skill

访问 Skill 页面查看详情：

amap-jsapi-skill — ClawHub

页面上会显示 Skill 的：

1. 名称：amap-jsapi-skill
2. 作者：amap
3. 版本：1.0.3
4. 描述：高德地图 JSAPI v2.0 (WebGL) 开发技能

第二步：安装 Skill

在终端中运行：

clawhub install amap-jsapi-skill

如果需要安装指定版本：

clawhub install amap-jsapi-skill --version 1.0.3

安装完成后，Skill 文件会出现在你的 OpenClaw workspace 的 skills/ 目录下。

备注：

第三步：验证安装

查看已安装的 Skill 列表：

clawhub list

你应该能看到 amap-jsapi-skill 出现在列表中。

第四步: 注册配置高德key

https://lbs.amap.com/api/javascript-api-v2/prerequisites 注册AMAP_JSAPI_KEY

https://lbs.amap.com/api/webservice/create-project-and-key注册AMAP_WEBSERVICE_KEY

https://console.amap.com/dev/key/app 查看并负责注册的key

最后将生成的key保持到openclaw skill 配置中

第五步：开始使用

直接在 OpenClaw 对话中使用这个 Skill 的能力，例如：

OpenClaw 会自动识别并调用对应的 Skill，按 SKILL.md 中的指引为你生成代码或执行操作。

更新 Skill

未来如果 Skill 有新版本，运行：

clawhub update amap-jsapi-skill

更新全部已安装的 Skill：

clawhub update --all

卸载 / 管理

目前通过删除 skills/amap-jsapi-skill/ 目录即可移除该 Skill。