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

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

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

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

peer dependencies 依赖警告

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

Unrecognized key 配置项不存在

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

openai 鉴权失败 auth failed

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

网关提示已在运行

解决：执行停止服务命令后重新启动