APIMaster.ai
APIMaster.ai 문서
Quick startAPIMaster.aiMarketplace

OpenClaw와 APIMaster.ai

Windows 또는 macOS에 OpenClaw를 설치하고, openclaw onboard의 Custom Provider를 통해 APIMaster를 연결한 후 웹 대시보드에서 채팅하세요.

OpenClaw는 웹 채팅 UI를 갖춘 로컬 AI 에이전트 플랫폼입니다. openclaw onboard → Custom Provider를 통해 APIMaster.ai(OpenAI 호환)를 연결하세요.

먼저 API 키를 받으세요. 아래에서 플레이스홀더 your_apimaster_key를 사용하세요.

전제 조건

  • Windows, macOS 또는 Linux
  • Node.js 22.19+ (Node 24 권장; 설치 프로그램이 필요시 업그레이드함)
  • APIMaster API 키 준비

1단계 — 설치

설치 후 일반적으로 Starting setup… (onboard)이 표시됩니다. 설치만 하고 나중에 구성하려면 아래의 Install without onboard를 참조하세요.

Windows (PowerShell)

powershell -c "irm https://openclaw.ai/install.ps1 | iex"

설치 성공 (Windows 예시)

macOS (Terminal)

  1. Terminal.app(또는 iTerm)을 엽니다.
  2. 공식 설치 프로그램을 실행합니다(OpenClaw 문서):
curl -fsSL https://openclaw.ai/install.sh | bash

macOS에서 스크립트는 다음을 수행합니다:

  • Apple Silicon과 Intel을 감지합니다
  • 누락된 경우 Homebrew를 설치합니다(Administrator 계정 필요)
  • 필요시 Homebrew를 통해 Node 24(또는 다른 빌드 ≥ 22.19)를 설치합니다
  • openclaw CLI를 설치하고 일반적으로 onboard를 시작합니다

Node를 먼저 확인하세요(선택 사항):

node --version   # v22.19+ 필요, v24.x 권장

onboard 없이 설치하기:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

그런 다음 준비가 되면 openclaw onboard를 실행하세요.

macOS 구성 경로:

항목 경로
구성 ~/.openclaw/openclaw.json
작업 공간 ~/.openclaw/workspace
세션 ~/.openclaw/agents/main/sessions

아래 스크린샷은 Windows에서 가져온 것이지만 CLI onboard 흐름은 macOS에서 동일합니다(Custom Provider, Base URL, Skip channel 등).

Linux / WSL2

macOS와 동일:

curl -fsSL https://openclaw.ai/install.sh | bash

선택적 백그라운드 Gateway:

openclaw onboard --install-daemon

(macOS: LaunchAgent · Linux: systemd user service)

2단계 — openclaw onboard

언제든지 실행하여 (재)구성:

openclaw onboard

macOS에서는 동일한 Terminal 세션을 사용하세요. 지속적인 Gateway를 원한다면:

openclaw onboard --install-daemon
  1. 보안 알림 → Yes
  2. Model/auth provider → Custom Provider (OpenAI 또는 Anthropic 호환 엔드포인트)

Custom Provider (macOS에서도 동일)

  1. 입력:
필드 값
API Base URL https://apimaster.ai/v1
API key APIMaster 키를 붙여넣기
Endpoint compatibility OpenAI 호환
Model ID 예: gpt-5.5

APIMaster 구성

  1. Model ID: 마켓플레이스의 채팅 모델 ID (gpt-5.4, claude-sonnet-4-6, …). gpt-image-2 같은 이미지 모델은 건너뜁니다.

  2. 선택적 단계: Skip 채널, 웹 검색, 스킬, 훅.

채널 건너뛰기

3단계 — 웹 채팅

브라우저가 열리지 않으면:

openclaw dashboard

페이지가 로드되지 않으면 openclaw dashboard를 다시 실행하거나 openclaw onboard를 다시 실행하세요.

4단계 — 테스트

입력 아래에서 모델을 선택하고(예: gpt-5.5 (Custom Provider)), hello를 보내고 응답을 확인하세요.

웹 채팅

문제 해결

문제 조치
잘못된 구성 openclaw onboard
페이지가 열리지 않음 openclaw dashboard
401 / 모델 오류 URL, 키, 모델 ID 확인; 연결 테스트

macOS

문제 조치
openclaw: command not found ~/.zshrc에 추가: export PATH="$(npm prefix -g)/bin:$PATH", Terminal을 다시 엽니다
nvm으로 Node 버전이 여전히 잘못됨 nvm install 24 && nvm use 24 && nvm alias default 24, 설치 프로그램 재실행
Homebrew 설치 실패 Administrator 계정을 사용하거나 먼저 Homebrew를 설치하세요
Gateway가 실행 중이 아님 openclaw gateway status; openclaw onboard --install-daemon 시도

체크리스트

  • Custom Provider + https://apimaster.ai/v1 + 키
  • 채팅 모델 ID (이미지 아님)
  • openclaw dashboard 작동
  • 테스트 메시지 성공

참고 항목