OpenClaw 입문: 설치와 사용자 지정 엔드포인트 설정

OpenClaw 공식 설치 절차와 Node.js 및 npm 조건, Gateway 기본 명령, OpenAI 호환 엔드포인트 설정을 한국어로 안내합니다.

OpenClaw 입문: 설치와 사용자 지정 엔드포인트 설정

OpenClaw는 Gateway를 중심으로 에이전트를 실행하고 설정하는 오픈 소스 도구입니다. 이 글에서는 공식 설치 절차를 따라 기본 실행을 확인한 뒤, 사용자 지정 OpenAI 호환 엔드포인트와 모델을 설정하는 방법을 소개합니다.

공식 릴리스 페이지의 최신 버전은 2026.9.5이며, 2026-09-19에 공개되었습니다. 이 글의 버전, 명령, 설정 예시는 2026-09-24에 공식 문서에서 다시 확인했습니다. 공식 릴리스

설치 전 확인

OpenClaw 공식 설치 문서는 Node.js 24.16 이상 또는 26.1 이상을 요구하며, Node.js 26 사용을 권장합니다. 설치 전에 버전을 확인하세요.

node --version
npm --version

공식 설치 안내는 설치 스크립트와 npm 설치 방법을 제공합니다. macOS, Linux, WSL2에서는 공식 설치 스크립트를 사용할 수 있습니다.

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

Windows PowerShell에서는 다음 설치 스크립트를 사용할 수 있습니다.

iwr -useb https://openclaw.ai/install.ps1 | iex

npm으로 설치할 경우 npm 버전에 따라 명령이 다릅니다. npm 12 또는 npm 11.16 이상에서는 다음처럼 설치할 수 있습니다.

npm install -g openclaw@latest --allow-scripts=openclaw

npm 11.15 이하에서는 해당 옵션을 빼고 실행합니다.

npm install -g openclaw@latest

설치 후 온보딩을 시작하고 Gateway 상태와 대시보드를 확인합니다.

openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard

세부 단계와 버전별 안내는 공식 Getting Started를 확인하세요.

사용자 지정 OpenAI 호환 엔드포인트 설정

OpenClaw의 공식 사용자 지정 공급자 예시는 models.providers에 접속 주소, API 키, API 형식, 모델 목록을 지정하고 agents.defaults.model.primary에서 사용할 모델을 선택합니다. 아래는 기존 모델 설정과 함께 사용할 수 있도록 mode를 merge로 두었습니다. 사용자 지정 공급자 안내 · 공급자 설정 예시

API 키는 환경 변수로 전달합니다. 저장소나 설정 파일에 실제 키 문자열을 넣지 마세요.

export BAZAARLINK_API_KEY="발급받은_API_키"

Windows PowerShell:

$env:BAZAARLINK_API_KEY = "발급받은_API_키"

설정 파일에는 다음 예시를 추가합니다. OpenClaw 설정은 JSON5 형식이므로 따옴표 없는 키와 마지막 쉼표를 사용할 수 있습니다.

{
  models: {
    mode: "merge",
    providers: {
      bazaarlink: {
        baseUrl: "https://api.bazaarlink.ai/v1",
        apiKey: "${BAZAARLINK_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "gemini-3.8-flash", name: "gemini-3.8-flash" },
        ],
      },
    },
  },
  agents: {
    defaults: {
      model: {
        primary: "bazaarlink/gemini-3.8-flash",
      },
    },
  },
}

이 글에서 사용한 gemini-3.8-flash는 2026-09-24 공개 모델 목록에서 확인한 ID입니다. 모델 ID가 목록에 있다는 사실만으로 OpenClaw에서 사용할 모든 기능이나 동작까지 확인된 것은 아닙니다. 연결 후에는 사용 환경에서 필요한 기능을 직접 점검하세요. BazaarLink 공개 모델 목록

OpenClaw 설치 문서와 릴리스, 공급자 설정 문서, BazaarLink 공개 모델 목록 최종 확인일: 2026-09-24.

대만 달러 결제 · 대만 통일영수증 · 주요 AI 모델 · OpenAI 호환 API