메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Fireworks는 OpenAI 호환 API를 통해 오픈 웨이트 모델과 라우팅된 모델을 제공합니다. OpenClaw에는 사전 카탈로그화된 Kimi 모델 두 개와 함께 제공되며 런타임에 모든 Fireworks 모델 또는 라우터 ID를 허용하는 번들 Fireworks 제공자 Plugin이 포함되어 있습니다.
속성값
제공자 IDfireworks (별칭: fireworks-ai)
Plugin번들, enabledByDefault: true
인증 환경 변수FIREWORKS_API_KEY
온보딩 플래그--auth-choice fireworks-api-key
직접 CLI 플래그--fireworks-api-key <key>
APIOpenAI 호환 (openai-completions)
기본 URLhttps://api.fireworks.ai/inference/v1
기본 모델fireworks/accounts/fireworks/routers/kimi-k2p5-turbo
기본 별칭Kimi K2.5 Turbo

​
시작하기

1

Fireworks API 키 설정

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

모델을 사용할 수 있는지 확인

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

​
비대화형 설정

스크립트 또는 CI 설치의 경우 모든 값을 명령줄로 전달합니다. 
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice fireworks-api-key \
  --fireworks-api-key "$FIREWORKS_API_KEY" \
  --skip-health \
  --accept-risk

​
내장 카탈로그

모델 참조이름입력컨텍스트최대 출력Thinking
fireworks/accounts/fireworks/models/kimi-k2p6Kimi K2.6텍스트 + 이미지262,144262,144강제로 끔
fireworks/accounts/fireworks/routers/kimi-k2p5-turboKimi K2.5 Turbo (Fire Pass)텍스트 + 이미지256,000256,000강제로 끔 (기본값)
Fireworks가 프로덕션에서 Kimi thinking 매개변수를 거부하므로 OpenClaw는 모든 Fireworks Kimi 모델을 thinking: off로 고정합니다. Moonshot을 통해 같은 모델을 직접 라우팅하면 Kimi 추론 출력이 보존됩니다. 제공자 간 전환은 thinking 모드를 참조하세요.

​
사용자 지정 Fireworks 모델 ID

OpenClaw는 런타임에 모든 Fireworks 모델 또는 라우터 ID를 허용합니다. Fireworks에 표시된 정확한 ID를 사용하고 fireworks/를 접두사로 붙이세요. 동적 확인은 Fire Pass 템플릿(텍스트 + 이미지 입력, OpenAI 호환 API, 기본 비용 0)을 복제하고 ID가 Kimi 패턴과 일치하면 thinking을 자동으로 비활성화합니다. 
{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/models/<your-model-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 엔드포인트에 전송합니다.
Kimi가 Moonshot 자체 API를 통해 thinking을 지원하더라도, 요청에 reasoning_* 매개변수가 포함되어 있으면 Fireworks K2.6은 400을 반환합니다. 번들 정책(extensions/fireworks/thinking-policy.ts)은 Kimi 모델 ID에 대해 off thinking 수준만 알리므로 수동 /think 전환과 제공자 정책 표면이 런타임 계약과 일치합니다.Kimi 추론을 엔드투엔드로 사용하려면 Moonshot 제공자를 구성하고 같은 모델을 통해 라우팅하세요.
Gateway가 관리형 서비스(launchd, systemd, Docker)로 실행되는 경우 Fireworks 키는 대화형 셸뿐 아니라 해당 프로세스에서도 보여야 합니다.
~/.profile에만 있는 키는 해당 환경도 가져오지 않는 한 launchd 또는 systemd 데몬에 도움이 되지 않습니다. Gateway 프로세스에서 읽을 수 있도록 키를 ~/.openclaw/.env에 설정하거나 env.shellEnv를 통해 설정하세요.
macOS에서 openclaw gateway install은 이미 ~/.openclaw/.env를 LaunchAgent 환경 파일에 연결합니다. 키를 교체한 후 install을 다시 실행하거나 openclaw doctor --fix를 실행하세요.

​
관련 항목

모델 제공자

제공자, 모델 참조, 장애 조치 동작 선택.

Thinking 모드

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

Moonshot

Moonshot 자체 API를 통해 네이티브 thinking 출력으로 Kimi를 실행합니다.

문제 해결

일반적인 문제 해결 및 FAQ.