OpenClaw技能调用入门指南：从零开始掌握核心API与实战技巧

2次阅读

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

OpenClaw 技能调用主要应用于智能客服、自动化流程等场景。例如，当用户需要查询订单状态时，可以通过调用 OpenClaw 的订单查询技能，快速获取相关信息。这类技能调用通常需要处理用户输入、生成响应并返回结果，整个过程高效且自动化。

技能(Skill)：指 OpenClaw 平台上封装好的功能模块，比如天气查询、订单处理等。每个技能都有唯一的 ID 和调用接口。
技能槽(Slot)：技能调用时需要填充的参数，比如查询天气时需要提供城市名。
会话 ID(SessionID)：用于标识一次完整的对话流程，确保上下文连贯性。

调用流程通常如下：
1. 用户发起请求
2. 系统解析请求并填充技能槽
3. 调用对应技能
4. 返回响应结果

import requests
import json

# OAuth2 鉴权
def get_access_token(client_id, client_secret):
    token_url = "https://api.openclaw.com/oauth2/token"
    payload = {
        "grant_type": "client_credentials",
        "client_id": client_id,
        "client_secret": client_secret
    }
    response = requests.post(token_url, data=payload)
    return response.json().get("access_token")

# 构建请求体
def call_skill(access_token, skill_id, slots):
    api_url = f"https://api.openclaw.com/skills/{skill_id}/execute"
    headers = {"Authorization": f"Bearer {access_token}",
        "X-Request-ID": "your_unique_request_id",
        "Content-Type": "application/json"
    }
    payload = {
        "slots": slots,
        "session_id": "your_session_id"
    }
    response = requests.post(api_url, headers=headers, json=payload)
    return response.json()

# 示例调用
access_token = get_access_token("your_client_id", "your_client_secret")
result = call_skill(access_token, "weather_query", {"city": "Beijing"})
print(result)

import okhttp3.*;
import java.io.IOException;

public class OpenClawClient {private final OkHttpClient client = new OkHttpClient();

    public String getAccessToken(String clientId, String clientSecret) throws IOException {RequestBody formBody = new FormBody.Builder()
                .add("grant_type", "client_credentials")
                .add("client_id", clientId)
                .add("client_secret", clientSecret)
                .build();

        Request request = new Request.Builder()
                .url("https://api.openclaw.com/oauth2/token")
                .post(formBody)
                .build();

        try (Response response = client.newCall(request).execute()) {return parseAccessToken(response.body().string());
        }
    }

    public String callSkill(String accessToken, String skillId, String slotsJson) throws IOException {
        RequestBody body = RequestBody.create(
                slotsJson,
                MediaType.parse("application/json")
        );

        Request request = new Request.Builder()
                .url("https://api.openclaw.com/skills/" + skillId + "/execute")
                .addHeader("Authorization", "Bearer" + accessToken)
                .addHeader("X-Request-ID", "your_unique_request_id")
                .post(body)
                .build();

        try (Response response = client.newCall(request).execute()) {return response.body().string();}
    }
}

常见的错误码包括：
– 401：鉴权失败
– 404：技能不存在
– 429：请求频率过高
– 500：服务器内部错误

建议在代码中添加对应的错误处理逻辑，比如重试机制或降级策略。

同步调用：适用于实时性要求高的场景，比如用户在线等待结果。
异步调用：适用于处理时间较长的任务，比如批量数据处理。可以通过回调 URL 或轮询方式获取结果。

使用令牌桶算法控制请求频率，以下是一个简单的 Python 实现：

import time

class TokenBucket:
    def __init__(self, capacity, refill_rate):
        self.capacity = capacity
        self.tokens = capacity
        self.refill_rate = refill_rate
        self.last_refill = time.time()

    def consume(self, tokens=1):
        self.refill()
        if self.tokens >= tokens:
            self.tokens -= tokens
            return True
        return False

    def refill(self):
        now = time.time()
        elapsed = now - self.last_refill
        self.tokens = min(self.capacity, self.tokens + elapsed * self.refill_rate)
        self.last_refill = now