Providers

Moonshot AI

Moonshot는 OpenAI 호환 엔드포인트로 Kimi API를 제공합니다. provider를 구성하고 기본 모델을 moonshot/kimi-k2.6으로 설정하거나, kimi/kimi-code로 Kimi Coding을 사용할 수 있습니다.

내장 모델 카탈로그

Model ref	이름	Reasoning	입력	컨텍스트	최대 출력
`moonshot/kimi-k2.6`	Kimi K2.6	아니요	text, image	262,144	262,144
`moonshot/kimi-k2.5`	Kimi K2.5	아니요	text, image	262,144	262,144
`moonshot/kimi-k2-thinking`	Kimi K2 Thinking	예	text	262,144	262,144
`moonshot/kimi-k2-thinking-turbo`	Kimi K2 Thinking Turbo	예	text	262,144	262,144
`moonshot/kimi-k2-turbo`	Kimi K2 Turbo	아니요	text	256,000	16,384

현재 Moonshot가 호스팅하는 K2 모델에 대한 번들 비용 추정치는 Moonshot의 공개 종량제 요금을 사용합니다. Kimi K2.6은 캐시 적중 시 $0.16/MTok, 입력 $0.95/MTok, 출력 $4.00/MTok이며, Kimi K2.5는 캐시 적중 시 $0.10/MTok, 입력 $0.60/MTok, 출력 $3.00/MTok입니다. 다른 레거시 카탈로그 항목은 config에서 재정의하지 않는 한 0 비용 placeholder를 유지합니다.

시작하기

사용할 provider를 선택하고 설정 단계를 따르세요.

Moonshot API

가장 적합한 경우: Moonshot Open Platform을 통해 Kimi K2 모델을 사용할 때.

엔드포인트 리전 선택

인증 선택지	엔드포인트	리전
`moonshot-api-key`	`https://api.moonshot.ai/v1`	국제
`moonshot-api-key-cn`	`https://api.moonshot.cn/v1`	중국

온보딩 실행

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

또는 중국 엔드포인트의 경우:

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

기본 모델 설정

{
  agents: {
    defaults: {
      model: { primary: "moonshot/kimi-k2.6" },
    },
  },
}

모델 사용 가능 여부 확인

openclaw models list --provider moonshot

live smoke 테스트 실행

일반 세션을 건드리지 않고 모델 접근성과 비용 추적을 검증하려면 격리된 상태 디렉터리를 사용하세요:

OPENCLAW_CONFIG_PATH=/tmp/openclaw-kimi/openclaw.json \
OPENCLAW_STATE_DIR=/tmp/openclaw-kimi \
openclaw agent --local \
  --session-id live-kimi-cost \
  --message 'Reply exactly: KIMI_LIVE_OK' \
  --thinking off \
  --json

JSON 응답에는 provider: "moonshot" 및 model: "kimi-k2.6"이 보고되어야 합니다. assistant transcript 항목에는 Moonshot가 사용량 메타데이터를 반환할 때 정규화된 토큰 사용량과 추정 비용이 usage.cost 아래에 저장됩니다.

config 예시

{
  env: { MOONSHOT_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "moonshot/kimi-k2.6" },
      models: {
        // moonshot-kimi-k2-aliases:start
        "moonshot/kimi-k2.6": { alias: "Kimi K2.6" },
        "moonshot/kimi-k2.5": { alias: "Kimi K2.5" },
        "moonshot/kimi-k2-thinking": { alias: "Kimi K2 Thinking" },
        "moonshot/kimi-k2-thinking-turbo": { alias: "Kimi K2 Thinking Turbo" },
        "moonshot/kimi-k2-turbo": { alias: "Kimi K2 Turbo" },
        // moonshot-kimi-k2-aliases:end
      },
    },
  },
  models: {
    mode: "merge",
    providers: {
      moonshot: {
        baseUrl: "https://api.moonshot.ai/v1",
        apiKey: "${MOONSHOT_API_KEY}",
        api: "openai-completions",
        models: [
          // moonshot-kimi-k2-models:start
          {
            id: "kimi-k2.6",
            name: "Kimi K2.6",
            reasoning: false,
            input: ["text", "image"],
            cost: { input: 0.95, output: 4, cacheRead: 0.16, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 262144,
          },
          {
            id: "kimi-k2.5",
            name: "Kimi K2.5",
            reasoning: false,
            input: ["text", "image"],
            cost: { input: 0.6, output: 3, cacheRead: 0.1, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 262144,
          },
          {
            id: "kimi-k2-thinking",
            name: "Kimi K2 Thinking",
            reasoning: true,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 262144,
          },
          {
            id: "kimi-k2-thinking-turbo",
            name: "Kimi K2 Thinking Turbo",
            reasoning: true,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 262144,
          },
          {
            id: "kimi-k2-turbo",
            name: "Kimi K2 Turbo",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 256000,
            maxTokens: 16384,
          },
          // moonshot-kimi-k2-models:end
        ],
      },
    },
  },
}

Kimi Coding

가장 적합한 경우: Kimi Coding 엔드포인트를 통한 코드 중심 작업.

온보딩 실행

openclaw onboard --auth-choice kimi-code-api-key

기본 모델 설정

{
  agents: {
    defaults: {
      model: { primary: "kimi/kimi-code" },
    },
  },
}

모델 사용 가능 여부 확인

openclaw models list --provider kimi

config 예시

{
  env: { KIMI_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "kimi/kimi-code" },
      models: {
        "kimi/kimi-code": { alias: "Kimi" },
      },
    },
  },
}

Kimi 웹 검색

OpenClaw는 Moonshot 웹 검색을 기반으로 하는 web_search provider로 Kimi도 함께 제공합니다.

대화형 웹 검색 설정 실행

openclaw configure --section web

웹 검색 섹션에서 Kimi를 선택하면 plugins.entries.moonshot.config.webSearch.*가 저장됩니다.

웹 검색 리전과 모델 구성

대화형 설정은 다음 항목을 묻습니다:

설정	옵션
API 리전	`https://api.moonshot.ai/v1` (국제) 또는 `https://api.moonshot.cn/v1` (중국)
웹 검색 모델	기본값 `kimi-k2.6`

config는 plugins.entries.moonshot.config.webSearch 아래에 저장됩니다:

{
  plugins: {
    entries: {
      moonshot: {
        config: {
          webSearch: {
            apiKey: "sk-...", // 또는 KIMI_API_KEY / MOONSHOT_API_KEY 사용
            baseUrl: "https://api.moonshot.ai/v1",
            model: "kimi-k2.6",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "kimi",
      },
    },
  },
}

고급 구성

기본 thinking 모드

Moonshot Kimi는 이진 기본 thinking을 지원합니다:

thinking: { type: "enabled" }
thinking: { type: "disabled" }

agents.defaults.models.<provider/model>.params를 통해 모델별로 구성하세요:

{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.6": {
          params: {
            thinking: { type: "disabled" },
          },
        },
      },
    },
  },
}

OpenClaw는 Moonshot에 대해 런타임 /think 수준도 매핑합니다:

`/think` 수준	Moonshot 동작
`/think off`	`thinking.type=disabled`
off가 아닌 모든 수준	`thinking.type=enabled`

Kimi K2.6은 또한 reasoning_content의 다중 턴 유지 방식을 제어하는 선택적 thinking.keep 필드를 허용합니다. 턴 간 전체 reasoning을 유지하려면 "all"로 설정하고, 서버 기본 전략을 사용하려면 생략하거나 null로 두세요. OpenClaw는 thinking.keep을 moonshot/kimi-k2.6에만 전달하고 다른 모델에서는 제거합니다.

{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.6": {
          params: {
            thinking: { type: "enabled", keep: "all" },
          },
        },
      },
    },
  },
}

도구 호출 ID 정제

Moonshot Kimi는 functions.<name>:<index> 형태의 tool_call ID를 제공합니다. OpenClaw는 다중 턴 도구 호출이 계속 작동하도록 이를 변경하지 않고 그대로 유지합니다.

사용자 지정 OpenAI 호환 provider에서 엄격한 정제를 강제하려면 sanitizeToolCallIds: true를 설정하세요:

{
  models: {
    providers: {
      "my-kimi-proxy": {
        api: "openai-completions",
        sanitizeToolCallIds: true,
      },
    },
  },
}

스트리밍 사용량 호환성

기본 Moonshot 엔드포인트(https://api.moonshot.ai/v1 및 https://api.moonshot.cn/v1)는 공유 openai-completions 전송에서 스트리밍 사용량 호환성을 알립니다. OpenClaw는 이를 엔드포인트 capability를 기준으로 판단하므로, 동일한 기본 Moonshot 호스트를 대상으로 하는 호환 사용자 지정 provider ID도 같은 스트리밍 사용량 동작을 상속합니다.

번들된 K2.6 가격 책정에서는 입력, 출력, 캐시 읽기 토큰을 포함하는 스트리밍 사용량도 /status, /usage full, /usage cost, transcript 기반 세션 회계를 위한 로컬 추정 USD 비용으로 변환됩니다.

엔드포인트 및 모델 참조 참조

Provider	모델 참조 접두사	엔드포인트	인증 env var
Moonshot	`moonshot/`	`https://api.moonshot.ai/v1`	`MOONSHOT_API_KEY`
Moonshot CN	`moonshot/`	`https://api.moonshot.cn/v1`	`MOONSHOT_API_KEY`
Kimi Coding	`kimi/`	Kimi Coding 엔드포인트	`KIMI_API_KEY`
웹 검색	해당 없음	Moonshot API 리전과 동일	`KIMI_API_KEY` 또는 `MOONSHOT_API_KEY`

Kimi 웹 검색은 KIMI_API_KEY 또는 MOONSHOT_API_KEY를 사용하며, 기본값은 https://api.moonshot.ai/v1와 모델 kimi-k2.6입니다.
필요하면 models.providers에서 가격 및 컨텍스트 메타데이터를 재정의하세요.
Moonshot가 특정 모델에 대해 다른 컨텍스트 제한을 게시하면 contextWindow를 그에 맞게 조정하세요.

Moonshot AI

내장 모델 카탈로그

시작하기

Moonshot API

엔드포인트 리전 선택

온보딩 실행

기본 모델 설정

모델 사용 가능 여부 확인

live smoke 테스트 실행

config 예시

Kimi Coding

온보딩 실행

기본 모델 설정

모델 사용 가능 여부 확인

config 예시

Kimi 웹 검색

대화형 웹 검색 설정 실행

웹 검색 리전과 모델 구성

고급 구성

관련 항목

Ask OpenClaw

# 내장 모델 카탈로그

# 시작하기

Moonshot API

엔드포인트 리전 선택

온보딩 실행

기본 모델 설정

모델 사용 가능 여부 확인

live smoke 테스트 실행

# config 예시

Kimi Coding

온보딩 실행

기본 모델 설정

모델 사용 가능 여부 확인

# config 예시

# Kimi 웹 검색

대화형 웹 검색 설정 실행

웹 검색 리전과 모델 구성

# 고급 구성

# 관련 항목

내장 모델 카탈로그

시작하기

config 예시

config 예시

Kimi 웹 검색

고급 구성

관련 항목