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

一、登录并创建应用

打开「高德开放平台控制台」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

网关提示已在运行

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