Kimi OpenClaw

상위 문서: ← Kimi Integrations 출처: Kimi API Platform 공식 문서 — Use Kimi in OpenClaw 한글화 (2026-07-22) 공급사: Moonshot AI (月之暗面)

OpenClaw(구 Clawdbot/Moltbot)는 WhatsApp, Telegram, Discord, Slack, Signal과 통합되는 셀프 호스팅 AI 에이전트 플랫폼입니다. 여러 LLM 프로바이더를 지원하며, 데이터와 API Key에 대한 완전한 통제권을 제공합니다.

아래 단계는 OpenClaw 2026.7.1, 공식 Moonshot Provider, Kimi K3(Chat Completion) 기준입니다. 이전 K2.5 프리셋은 이 가이드의 대상 구성이 아닙니다.

kimi-k2.5는 신규 가입자에게 더 이상 제공되지 않습니다. 신규 사용자는 공식 Moonshot Provider를 설치하고 moonshot/kimi-k3를 기본 모델로 설정하세요. API Key는 로컬 마법사 또는 터미널에서만 입력하고, 문서·스크린샷·저장소·채팅 메시지에는 절대 노출하지 마세요.

사전 준비

OpenClaw 공식 엔트리 포인트에서 설치/업데이트
공식 저장소에서 소스/릴리스/변경 이력 검토
국제판 Kimi Open Platform API Key 생성·비공개 보관

Kimi K3 사용에 가용 잔액 필요. 등급별 한도는 Rate Limits 참고. IP 화이트리스트 사용 시 Organization Best Practices 참고.

Kimi K3 설정

사전 준비 항목이 모두 갖춰졌는지 확인 후, 공식 Moonshot Provider를 설치/업데이트:

openclaw plugins install @openclaw/moonshot-provider
openclaw gateway restart

온보딩 실행:

openclaw onboard --auth-choice moonshot-api-key

마법사에서 다음을 선택:

Step 1: Model.auth provider > Choose Moonshot
Step 2: Model AI auth method > Choose Kimi API key (.ai)
Step 3: Enter Moonshot API Key (.ai) > 국제판 API Key 입력
Step 4: Default model > 온보딩 후 moonshot/kimi-k3로 설정

K3가 마법사 목록에 보이지 않으면, 인증 완료 후 다음 명령으로 모델을 강제 설정:

openclaw models list --provider moonshot
openclaw models set moonshot/kimi-k3

여전히 K3가 없으면 Provider를 업그레이드하고 Gateway를 재시작:

openclaw plugins update @openclaw/moonshot-provider
openclaw gateway restart
openclaw models list --provider moonshot

이전 온보딩 스크린샷에는 Moonshot AI (Kimi K2.5) 또는 moonshot/kimi-k2.5 프리셋이 보일 수 있습니다. 이 가이드는 그 프리셋을 더 이상 사용하지 않습니다. 본문 단계와 K3 모델 선택 스크린샷을 따르고, 이전 기본 모델은 사용하지 마세요.

업데이트 후에도 K3가 없으면 ~/.openclaw/openclaw.json의 models.providers.moonshot.models에 K3 항목을 추가하세요(기존 모델 보존):

{
  "models": {
    "mode": "merge",
    "providers": {
      "moonshot": {
        "baseUrl": "https://api.moonshot.ai/v1",
        "api": "openai-completions",
        "models": [{
          "id": "kimi-k3",
          "name": "Kimi K3",
          "reasoning": true,
          "input": ["text", "image", "video"],
          "contextWindow": 1048576,
          "maxTokens": 8192,
          "thinkingLevelMap": {
            "off": null,
            "minimal": "max",
            "low": "max",
            "medium": "max",
            "high": "max",
            "xhigh": "max",
            "max": "max"
          },
          "compat": {
            "maxTokensField": "max_tokens",
            "supportsUsageInStreaming": false,
            "requiresStringContent": true,
            "supportsReasoningEffort": true,
            "supportedReasoningEfforts": ["minimal", "low", "medium", "high", "xhigh", "max"]
          }
        }]
      }
    }
  }
}

이미지·비디오 입력도 K3로 라우팅하려면 같은 설정에 다음을 추가:

{
  "agents": {
    "defaults": {
      "imageModel": "moonshot/kimi-k3"
    }
  },
  "tools": {
    "media": {
      "image": { "models": [{ "type": "provider", "provider": "moonshot", "model": "kimi-k3", "capabilities": ["image"] }] },
      "video": { "models": [{ "type": "provider", "provider": "moonshot", "model": "kimi-k3", "capabilities": ["video"] }] }
    }
  }
}

K3는 서버 사이드 max reasoning 설정을 항상 사용합니다. contextWindow는 1M을 유지하고 maxTokens는 8192(OpenClaw의 응답당 한도)로 설정해 1M 입력을 1M 출력으로 잘못 해석하지 않게 합니다. K3 호환을 위해 maxTokensField: "max_tokens", supportsUsageInStreaming: false, requiresStringContent: true를 유지하세요. K3는 max_completion_tokens, 스트리밍 usage, 배열 형태의 순수 텍스트 content를 다르게 처리합니다.

4단계: OpenClaw 사용 시작

설치 후 온보딩 마법사나 Gateway 출력에 표시된 Control UI 주소를 엽니다. Control UI 하단에 kimi-k3 · moonshot가 표시되어야 합니다.

채팅 페이지에서 메시지를 보낼 수 있습니다. 모델 선택기는 위 스크린샷에 표시된 형태입니다.

트러블슈팅

401 / Invalid Authentication

Kimi Open Platform API Key를 사용하는지 확인 (Kimi Code Key 아님)
국제판 Key에는 moonshot-api-key, 중국판 Key에는 중국판 옵션 사용
환경에 기존 Key가 있으면 온보딩을 다시 실행해 국제판 Key 재입력

Moonshot 인증 옵션이 보이지 않음

공식 Provider 설치 + Gateway 재시작 확인:

openclaw plugins install @openclaw/moonshot-provider
openclaw gateway restart

모델 목록에 K3가 없음

OpenClaw와 Moonshot Provider를 업그레이드. 여전히 없으면 3단계의 K3 항목을 추가하고 openclaw models set moonshot/kimi-k3 재실행.

자세한 내용은 Troubleshooting 참고.

변경 이력

날짜	변경
2026-07-22	초판 작성 (공식 OpenClaw 통합 가이드 한글화)
2026-07-22	제목에 "Kimi" 접두사 추가, 본문 H1 중복 제거