Openclaw용 OpenAI-Compatible LLM Gateway

17개 이상의 최첨단 AI 모델을 지원하고 USDC 종량제 결제를 제공하는 키리스, 드롭인 OpenAI-Compatible Gateway입니다.

colinhughes2121
v1.0.0
Jun 22, 2026
0
419
0

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.

npx clawhub@latest install openai-compatible-llm-gateway

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌
~/.openclaw/skills/
워크스페이스
<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.

Clawhub를 사용해서 openai-compatible-llm-gateway 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

OpenAI-Compatible LLM Gateway란 무엇인가요?

OpenAI-Compatible LLM Gateway는 현대적인 워크플로우를 위해 LLM 라우팅을 간소화하도록 설계된 혁신적인 개발자 도구입니다. 17개 이상의 주요 AI 모델(GPT, Claude, Gemini, DeepSeek, Llama, Kimi, Qwen 포함)을 지원하며, 등록, API keys 또는 구독료 없이 표준 chat completions 엔드포인트를 제공합니다. 이 솔루션은 Openclaw Skills를 활용하여 AI agents를 강력한 모델에 동적으로 연결하려는 개발자에게 완벽합니다.

여러 벤더의 keys를 관리하는 대신, 이 게이트웨이는 x402 프로토콜(Base 또는 Solana 기반)을 통해 USDC로 직접 종량제 결제를 하거나 사전 충전된 keys를 통해 결제할 수 있습니다. 단순히 base URL을 변경하는 것만으로 모든 표준 OpenAI 클라이언트에 대한 드롭인 대체재 역할을 하며, 마찰 없는 배포를 가능하게 합니다.

OpenAI-Compatible LLM Gateway 활용 사례

  • 키리스(Keyless) Agent 실행: Openclaw Skills 기반의 AI agents가 마스터 LLM api keys를 미리 설정하거나 노출하지 않고도 작업을 실행할 수 있도록 합니다.
  • 세밀한 종량제 비용 산정: 비대한 월간 약정 대신 USDC 소액 결제를 사용하여 앱에서 생성된 정확한 completions에 대해서만 비용을 지불합니다.
  • 드롭인 클라이언트 업그레이드: 기존 애플리케이션의 OpenAI SDK base URL을 교체하여 Claude, DeepSeek, Gemini와 같은 대체 최첨단 모델에 즉시 액세스할 수 있습니다.

OpenAI-Compatible LLM Gateway 작동 원리

  1. 라우팅 선택: OpenAI 클라이언트 또는 SDK base_url 설정을 https://api.gocreativeai.com/v1으로 변경합니다.
  2. Payload 발송: 대상 모델 및 프롬프트 구조를 포함하여 /v1/chat/completions로 표준 POST 요청을 보냅니다.
  3. 결제 핸드셰이크: HTTP 402 챌린지를 수신하면 Base 또는 Solana 플랫폼의 x402 지원 Web3 지갑을 통해 동적으로 결제하거나, 인증 헤더에 사전 충전된 key를 전달합니다.
  4. 응답 전달: OpenAI의 JSON 형식 사양과 일치하는 표준 규격의 chat completion 응답 payload를 수신합니다.

OpenAI-Compatible LLM Gateway 설정 가이드

이 게이트웨이를 Openclaw Skills 워크플로우에 통합하는 과정은 매우 간단합니다. 아래와 같이 SDK base URL을 업데이트하세요:

from openai import OpenAI

# Configure client with the gateway base URL
client = OpenAI(
    base_url="https://api.gocreativeai.com/v1", 
    api_key="gck_<your-key>"
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Summarize this in one line: ..."}],
)
print(resp.choices[0].message.content)

또는 curl을 통해 쿼리할 수 있습니다:

curl -X POST https://api.gocreativeai.com/v1/chat/completions \
  -H "Authorization: Bearer gck_<your-key>" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"hi"}]}'

OpenAI-Compatible LLM Gateway 데이터 스키마 및 분류 체계

이 게이트웨이는 OpenAI v1 API 엔드포인트와 호환되는 표준화된 request/response schemas를 지원합니다. 다음 엔드포인트와 구조가 지원됩니다:

Endpoints & Dynamic Pricing

Endpoint Path Method Description Est. Cost (USDC)
/v1/chat/completions POST 표준 chat completions (stream: false 설정) $0.02 / call
/v1/models GET 지원되는 17개 모델의 실시간 목록 검색 무료
/v1/ai/eco/{prompt} GET 저비용 completion 단축키 $0.005 / call
/v1/ai/ask/{prompt} GET 표준 completion 단축키 $0.02 / call
/v1/ai/pro/{prompt} GET 최첨단 completion 단축키 (Claude/GPT-5) $0.08 / call
/v1/ai/ultra/{prompt} GET 최고 등급 추론 completion (Opus) $0.25 / call

Model Mappings

지원되는 모델은 gpt-4o-mini, claude-3-opus, gemini-flash, deepseek-chat을 포함하여 17개 옵션에 걸쳐 있습니다. 알 수 없는 모델 이름은 자동으로 적절한 기본값으로 라우팅됩니다.

OpenAI-Compatible LLM Gateway 고급 기능

  • 이중 Web3 결제 프로토콜: 기본 x402 규정 준수를 활용하여 Solana 또는 Base 네트워크에서 거래 흐름을 동적으로 완료합니다.
  • 통합 엔터프라이즈 툴킷: SEC 보고서 및 회사 정보 보강 서비스와 같은 350개 이상의 데이터 및 규정 준수 도구가 번들로 제공되는 통합 API 경로의 이점을 누리세요.
  • 제로 속도 제한: 전통적인 API 사용 제한에 걸리거나 복잡한 등급 업그레이드를 거치지 않고도 자동화된 워크플로우를 무한정 확장하세요.

SKILL.md


로드 중

관련 Openclaw 스킬

METADATA

Github Stars: 0
forks: 0

추천*