OpenClaw实战指南之10分钟接入高德地图Skill：附完整配置教程

在高德开放平台完成账号注册与开发者认证，是调用地图API的首要流程，此操作仅对新注册用户生效。

一、登录并创建应用

访问「高德开放平台控制台」https://console.amap.com/dev/id/phone，注册账号，该任务仅面向新用户，老用户无法参与。

填写相关资料完成开发者注册。

登录成功后，需进行个人实名认证，如下图所示，可选择支付宝快速认证方式：

认证通过后进入管理控制台：

进入 应用管理 → 点击 创建新应用

填写必填项目，点击创建

二、完成网页端调用skill

生成网页地图所需的key

在「我的应用」中选择刚创建的应用 → 点击 添加 Key：

选择添加Key，参照下图填写应用名称等信息 → 提交创建

注意：Web端（JS API）（名称可能略有不同，但必须选择“网页/JS API”类别）

创建成功后，复制生成的 Key（一串字母数字组合）。

三、使用openclaw完成skill调用

1、环境前置要求

系统：Mac / Linux

Node.js 版本：v20+ 推荐v22/v24（必须支持ES Module）

包管理：npm

网络：建议使用国内镜像，无需特殊网络环境

2、第一步：Node.js 环境统一配置（必做）

2.1 安装nvm版本管理器

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

重启终端

2.2 安装指定高版本Node

nvm install 22
nvm use 22
nvm alias default 22

验证

node -v
npm -v

3、全局安装 OpenClaw 核心程序

切换国内镜像提速

npm config set registry https://registry.npmmirror.com

静默跳过前置脚本安装（解决预安装报错）

npm install -g openclaw --ignore-scripts

验证安装成功

openclaw --version

输出版本号即表示安装完成

4、 OpenClaw 初始化引导配置（onboard 流程）

执行初始化向导

openclaw onboard

全程标准选择流程（手册固定答案）

1. 安全协议说明：输入 Yes 确认继续
2. 部署模式：选择 QuickStart 快速部署
3. 网关默认配置：端口18789、本地回环、Token鉴权直接默认下一步
4. 大模型服务商选择：选择 Skip for now（暂不配置AI大模型）
5. 通讯渠道配置：选择 Skip for now（暂不对接聊天机器人渠道）
6. 即时技能配置：选择 No 暂不引导安装技能
7. 钩子脚本配置：空格选中 Skip for now 回车跳过
8. 运行模式：默认选中 Hatch in Terminal 终端模式，回车确认

初始化完成标识

终端出现本地就绪提示，代表基础环境初始化完毕。

5、OpenClaw 网关服务启停管理

启动后台网关服务

openclaw gateway run

提示already running代表已后台常驻

查看网关运行状态

openclaw gateway status

打开Web可视化控制面板

openclaw dashboard

自动唤起浏览器访问：http://127.0.0.1:18789/

停止后台网关服务（手册必备）

# 终止运行
launchctl stop io.openclaw.gateway
# 取消开机自启
launchctl unload ~/Library/LaunchAgents/io.openclaw.gateway.plist

6、Skill 技能安装两种方式

Web面板可视化安装

打开控制面板 http://127.0.0.1:18789/

进入 Skills 技能管理 页面

搜索目标技能名称

点击 Install 安装 → 填写第三方平台密钥 → Save保存

点击 Enable 启用技能，状态变为已启用

7、终端交互式对话调用

openclaw chat

直接输入业务指令，程序自动匹配已启用Skill执行任务

帮我用高德地图 JSAPI 创建一个带标记点的地图

常见报错统一解决方案

SyntaxError: Unexpected token import

1. 原因：Node版本过低
2. 解决：升级至Node22+，nvm切换生效

peer dependencies 依赖警告

解决：安装时加 --ignore-scripts 忽略对等依赖

Unrecognized key 配置项不存在

1. 原因：全局config不支持自定义业务密钥
2. 解决：改用技能目录内.env配置

大模型鉴权失败 auth failed

解决：初始化跳过大模型、不绑定AI服务，纯本地运行Skill

网关提示已在运行

按照上述流程操作即可完成高德地图API调用与OpenClaw技能部署，若遇网关运行提示，执行停止服务命令后重启即可。