Skip to main content
Fireworks는 OpenAI 호환 API를 통해 오픈 웨이트 모델과 라우팅 모델을 제공합니다. 공식 Fireworks 제공자 Plugin을 설치하면 사전 카탈로그에 등록된 두 Kimi 모델과 모든 Fireworks 모델 또는 라우터 ID를 런타임에 사용할 수 있습니다.

​
시작하기

1

Plugin 설치

2

Fireworks API 키 설정

온보딩은 인증 프로필의 fireworks 제공자에 키를 저장하고 Fire Pass Kimi K2.5 Turbo 라우터를 기본 모델로 설정합니다.
3

모델 사용 가능 여부 확인

목록에 Kimi K2.6과 Kimi K2.5 Turbo (Fire Pass)가 포함되어야 합니다. FIREWORKS_API_KEY를 확인할 수 없으면 openclaw models status --json이 auth.unusableProfiles 아래에 누락된 자격 증명을 보고합니다.

​
비대화형 설정

스크립트 또는 CI 설치에서는 모든 항목을 명령줄에 전달합니다.

​
기본 제공 카탈로그

Fireworks의 Kimi는 요청에서 사고를 명시적으로 비활성화하지 않으면 사고 과정이 사용자에게 표시되는 응답에 노출될 수 있으므로, OpenClaw는 모든 Fireworks Kimi 모델을 thinking: off로 고정합니다. 동일한 모델을 Moonshot을 통해 직접 라우팅하면 Kimi의 추론 출력이 유지됩니다. 제공자 간 전환 방법은 사고 모드를 참조하세요.

​
사용자 지정 Fireworks 모델 ID

OpenClaw는 런타임에 모든 Fireworks 모델 또는 라우터 ID를 허용합니다. Fireworks에 표시된 정확한 ID 앞에 fireworks/를 붙여 사용하세요. 동적 해석은 Fire Pass 템플릿(텍스트 + 이미지 입력, OpenAI 호환 API, 기본 비용 0)을 복제하며, ID가 Kimi 패턴과 일치하면 사고를 자동으로 비활성화합니다. GLM 동적 ID는 이미지 입력을 포함하는 사용자 지정 모델 항목을 구성하지 않는 한 텍스트 전용으로 표시됩니다.
OpenClaw의 모든 Fireworks 모델 참조는 fireworks/로 시작하며, 그 뒤에 Fireworks 플랫폼의 정확한 ID 또는 라우터 경로가 이어집니다. 예:
  • 라우터 모델: fireworks/accounts/fireworks/routers/kimi-k2p5-turbo
  • 직접 모델: fireworks/accounts/fireworks/models/<model-name>
OpenClaw는 API 요청을 구성할 때 fireworks/ 접두사를 제거하고 나머지 경로를 OpenAI 호환 model 필드로 Fireworks 엔드포인트에 전송합니다.
Fireworks는 별도의 추론 채널 없이 Kimi를 제공하므로 사고 과정이 사용자에게 표시되는 content 스트림에 나타날 수 있습니다. OpenClaw는 모든 Fireworks Kimi 요청에서 thinking: { type: "disabled" }를 전송하고 페이로드에서 reasoning, reasoning_effort, reasoningEffort를 제거합니다(extensions/fireworks/stream.ts). 제공자 정책(extensions/fireworks/thinking-policy.ts)은 Kimi 모델 ID에 대해 off 사고 수준만 알리므로, 수동 /think 전환과 제공자 정책 화면이 런타임 계약에 맞게 유지됩니다.Kimi 추론을 처음부터 끝까지 사용하려면 Moonshot 제공자를 구성하고 동일한 모델을 이를 통해 라우팅하세요.
Gateway가 관리형 서비스(launchd, systemd, Docker)로 실행되는 경우 Fireworks 키는 대화형 셸뿐 아니라 해당 프로세스에서도 확인할 수 있어야 합니다.
대화형 셸에서만 내보낸 키는 해당 환경도 함께 가져오지 않는 한 launchd 또는 systemd 데몬에서 사용할 수 없습니다. Gateway 프로세스에서 키를 읽을 수 있도록 ~/.openclaw/.env 또는 env.shellEnv에 키를 설정하세요.
OpenClaw는 구성을 불러올 때 ~/.openclaw/.env를 불러오므로, 그곳에 저장된 키는 모든 플랫폼의 관리형 Gateway 서비스에 전달됩니다. 키를 교체한 후 Gateway를 다시 시작하거나 openclaw doctor --fix를 다시 실행하세요.

​
관련 항목

모델 제공자

제공자, 모델 참조, 장애 조치 동작을 선택하는 방법입니다.

사고 모드

/think 수준, 제공자 정책, 추론 가능 모델의 라우팅입니다.

Moonshot

Moonshot 자체 API를 통해 Kimi를 네이티브 사고 출력과 함께 실행합니다.

문제 해결

일반적인 문제 해결 및 자주 묻는 질문입니다.