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

一、登录并创建应用

先说几个关键点。要用高德地图的API，第一步当然是注册账号。打开「高德开放平台控制台」https://console.amap.com/dev/id/phone，注册账号——注意，这个任务只对新用户有效，老用户就别白费力气了。

填好信息，注册成为开发者。登录成功后，需要完成个人实名认证，下面这张图是流程，可以选择支付宝快速认证：

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

接下来，进入

，点击 ：

——这一步没什么好犹豫的，照着填就行。

二、完成网页端调用skill

创建网页地图需要的key。在「我的应用」里选中刚创建的应用，点击

：

选择添加Key，按照截图填写应用名称等信息，然后提交创建。这里必须提醒的是：一定要选

（名称可能略有差异，但必须选“网页/JS API”这一类），选错了后面没法用。

创建成功后，复制生成的 Key（一串字母数字），这就是你的通行证。

三、使用openclaw完成skill调用

1、环境前置要求

系统：Mac / Linux

Node.js 版本：

（必须支持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/

进入

页面

搜索目标技能名称

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

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

7、终端交互式对话调用

openclaw chat

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

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

常见报错统一解决方案

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

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

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

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

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