OpenClaw实战：如何通过自定义skill.md文件调用外部API

1次阅读

共计 1562 个字符，预计需要花费 4 分钟才能阅读完成。

OpenClaw 是一个低代码技能开发平台，允许开发者通过编写简单的配置文件来快速创建可复用的功能模块（称为 Skill）。skill.md 文件是定义这些功能模块的核心配置文件，采用 YAML 格式，包含了技能名称、描述、输入输出参数、API 端点等信息。通过 skill.md 文件，开发者可以轻松集成外部 API，而无需关心底层实现细节。

对于新手来说，创建自定义 skill 时常常会遇到以下问题：

YAML 格式错误：由于缩进不正确或缺少必要字段，导致文件无法被正确解析。
API 认证失败：未正确配置 OAuth2.0 或其他认证方式，导致 API 调用被拒绝。
参数映射错误：输入输出参数定义不匹配，导致数据无法正确传递。

一个完整的 skill.md 文件通常包含以下几个部分：

metadata：定义技能的基本信息，如名称、描述、版本等。
input：定义技能的输入参数及其类型。
output：定义技能的输出参数及其类型。
endpoints：定义技能调用的外部 API 端点及其认证方式。

在 endpoints 部分，需要明确定义 API 的 URL、请求方法（GET/POST 等）、认证方式（如 OAuth2.0、API Key 等）以及请求头和请求体（如果需要）。

如果 API 需要认证，务必在 skill.md 文件中正确声明认证方式。例如，对于 OAuth2.0 认证，需要提供 client_id、client_secret 和 token_url 等字段。

以下是一个调用天气 API 的 skill.md 示例：

# skill.md
metadata:
  name: weather_lookup
  description: Fetches current weather data for a given location
  version: 1.0.0

input:
  - name: location
    type: string
    description: City name or ZIP code
    required: true

output:
  - name: temperature
    type: number
    description: Current temperature in Celsius
  - name: conditions
    type: string
    description: Weather conditions (e.g., sunny, rainy)

endpoints:
  - url: https://api.weatherapi.com/v1/current.json
    method: GET
    authentication:
      type: api_key
      key: key
      value: YOUR_API_KEY
    query_params:
      q: "{{input.location}}"