mixgateway.io

OpenClaw (Clawdbot) — 설정 및 API 연동

OpenClaw란?

일반적인 운영체제에서 실행되는 에이전트 게이트웨이로, WhatsApp, Telegram, Discord, iMessage 등 채널에 연결할 수 있습니다. 메시지를 보내면 여러 인터페이스에서 에이전트 응답을 받을 수 있으며, 플러그인으로 추가 채널을 확장할 수 있습니다.

최신 기능과 문서는 공식 사이트에서 확인하세요: OpenClaw.

1. OpenClaw 설치

OS에 맞는 절차를 선택합니다.

스크립트 설치(권장)

macOS / Linux

  1. 설치
curl -fsSL https://openclaw.ai/install.sh | bash
  1. 확인
openclaw --version

Windows(PowerShell)

참고: OpenClaw 설치 프로그램은 보통 WSL2 안에서 실행합니다. PowerShell에서 WSL을 시작한 뒤 WSL 내부에서 설치를 실행하세요.

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

확인:

openclaw --version

2. OpenClaw 초기화

대화형 마법사를 실행합니다.

openclaw onboard

일반적인 흐름(버전에 따라 문구가 다를 수 있음):

  1. QuickStart 선택
  2. 아직 벤더 키가 필요 없으면 Skip for now
  3. All providers(또는 플랜에 맞는 옵션) 선택
  4. 확실하지 않으면 Keep current
  5. 선택적 채팅 도구나 skills 단계는 Skip 후 온보딩 완료 가능
  6. 마법사가 권장하는 프라이버시/게이트웨이 옵션이 있으면 활성화

완료 후 브라우저에서 게이트웨이 UI가 열릴 수 있습니다.

게이트웨이가 실행 중이 아니면:

openclaw gateway

2. OpenClaw를 mixgateway.io에 연결

1. 게이트웨이 API 키 발급

  1. mixgateway.io에 접속해 로그인합니다.
  2. [콘솔](/dashboard)에서 API Keys(또는 동등 메뉴)를 엽니다.
  3. 키를 생성해 복사하고, 게이트웨이 요청에 Authorization: Bearer …로 사용합니다.

2. openclaw.json 편집

설치 후 설정은 OpenClaw 구성 디렉터리(대개 ~/.openclaw)에 있습니다.

폴더 열기

open ~/.openclaw

Windows + WSL에서는 해당 디렉터리에서 탐색기를 열 수 있습니다.

explorer.exe .

편집: openclaw.json. 기존 파일과 아래 개념을 병합합니다. OpenAI 호환 베이스 URL **https://api.mixgateway.io/v1**를 가리키는 provider를 두고, agents.defaults.model.primary를 해당 provider를 쓰는 모델 ID로 연결합니다.

예시(OpenClaw 버전에 맞게 이름 조정 — 구조는 ApiSet의 OpenClaw 문서 등 참고):

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "mixgateway/deepseek:deepseek-chat"
      },
      "models": {
        "mixgateway/deepseek:deepseek-chat": {}
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "mixgateway": {
        "baseUrl": "https://api.mixgateway.io/v1",
        "apiKey": "PASTE_YOUR_GATEWAY_API_KEY_HERE",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek:deepseek-chat",
            "name": "deepseek-chat",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

참고:

  • **PASTE_YOUR_GATEWAY_API_KEY_HERE**를 대시보드의 실제 키로 바꿉니다.
  • **deepseek:deepseek-chat**는 게이트웨이가 지원하는 모델로 변경할 수 있습니다(모델 및 라우팅 참고).
  • **mixgateway**는 이 예시의 provider 키일 뿐입니다 — 이름은 바꿀 수 있지만 agents.defaults.model.primary와 맞춥니다(providerKey/modelId).

3. 게이트웨이 재시작

openclaw gateway restart

게이트웨이 UI에 새 provider와 모델이 반영되어야 합니다.

같이 보면 좋은 문서

  • OpenClaw 개요 — mixgateway.io와 함께 OpenClaw를 쓰는 이유.
  • 빠른 시작 — https://api.mixgateway.io/v1/chat/completions 직접 호출.