---
read_when:
    - Anda ingin menggunakan Fireworks dengan OpenClaw
    - Anda memerlukan variabel lingkungan kunci API Fireworks atau ID model default
    - Anda sedang men-debug perilaku penonaktifan proses berpikir Kimi di Fireworks
summary: Penyiapan Fireworks (autentikasi + pemilihan model)
title: Kembang Api
x-i18n:
    generated_at: "2026-07-12T14:36:28Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 15feed0730ec65d943f103824468490be6616478ece80bedfeb9ad8137506180
    source_path: providers/fireworks.md
    workflow: 16
---

[Fireworks](https://fireworks.ai) menyediakan model berbobot terbuka dan model yang dirutekan melalui API yang kompatibel dengan OpenAI. Instal plugin penyedia resmi Fireworks untuk menggunakan dua model Kimi yang telah dikatalogkan sebelumnya serta model atau id router Fireworks apa pun saat runtime.

| Properti           | Nilai                                                   |
| ------------------ | ------------------------------------------------------- |
| Id penyedia        | `fireworks` (alias: `fireworks-ai`)                     |
| Paket              | `@openclaw/fireworks-provider`                          |
| Variabel env auth  | `FIREWORKS_API_KEY`                                     |
| Flag orientasi     | `--auth-choice fireworks-api-key`                       |
| Flag CLI langsung  | `--fireworks-api-key <key>`                             |
| API                | Kompatibel dengan OpenAI (`openai-completions`)         |
| URL dasar          | `https://api.fireworks.ai/inference/v1`                 |
| Model bawaan       | `fireworks/accounts/fireworks/routers/kimi-k2p5-turbo`  |
| Alias bawaan       | `Kimi K2.5 Turbo`                                       |

## Memulai

<Steps>
  <Step title="Instal plugin">
    ```bash
    openclaw plugins install @openclaw/fireworks-provider
    ```
  </Step>
  <Step title="Tetapkan kunci API Fireworks">
    <CodeGroup>

```bash Orientasi
openclaw onboard --auth-choice fireworks-api-key
```

```bash Flag langsung
openclaw onboard --non-interactive \
  --auth-choice fireworks-api-key \
  --fireworks-api-key "$FIREWORKS_API_KEY"
```

```bash Hanya env
export FIREWORKS_API_KEY=fw-...
```

    </CodeGroup>

    Orientasi menyimpan kunci untuk penyedia `fireworks` dalam profil auth Anda dan menetapkan router Kimi K2.5 Turbo **Fire Pass** sebagai model bawaan.

  </Step>
  <Step title="Verifikasi bahwa model tersedia">
    ```bash
    openclaw models list --provider fireworks
    ```

    Daftar tersebut seharusnya mencakup `Kimi K2.6` dan `Kimi K2.5 Turbo (Fire Pass)`. Jika `FIREWORKS_API_KEY` tidak dapat diatasi, `openclaw models status --json` melaporkan kredensial yang hilang di bawah `auth.unusableProfiles`.

  </Step>
</Steps>

## Penyiapan noninteraktif

Untuk instalasi dengan skrip atau CI, teruskan semuanya melalui baris perintah:

```bash
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice fireworks-api-key \
  --fireworks-api-key "$FIREWORKS_API_KEY" \
  --skip-health \
  --accept-risk
```

## Katalog bawaan

| Referensi model                                        | Nama                        | Masukan       | Konteks | Keluaran maks. | Pemikiran                  |
| ------------------------------------------------------ | --------------------------- | ------------- | ------- | -------------- | -------------------------- |
| `fireworks/accounts/fireworks/models/kimi-k2p6`        | Kimi K2.6                   | teks + gambar | 262,144 | 262,144        | Dinonaktifkan secara paksa |
| `fireworks/accounts/fireworks/routers/kimi-k2p5-turbo` | Kimi K2.5 Turbo (Fire Pass) | teks + gambar | 256,000 | 256,000        | Dinonaktifkan secara paksa (bawaan) |

<Note>
  OpenClaw menetapkan semua model Kimi Fireworks ke `thinking: off` karena Kimi di Fireworks dapat membocorkan rantai pemikiran ke balasan yang terlihat kecuali permintaan secara eksplisit menonaktifkan pemikiran. Merutekan model yang sama secara langsung melalui [Moonshot](/id/providers/moonshot) mempertahankan keluaran penalaran Kimi. Lihat [mode pemikiran](/id/tools/thinking) untuk beralih antarpenyedia.
</Note>

## Id model Fireworks khusus

OpenClaw menerima id model atau router Fireworks apa pun saat runtime. Gunakan id persis seperti yang ditampilkan oleh Fireworks dan beri awalan `fireworks/`. Resolusi dinamis mengkloning templat Fire Pass (masukan teks + gambar, API yang kompatibel dengan OpenAI, biaya bawaan nol) dan menonaktifkan pemikiran secara otomatis saat id cocok dengan pola Kimi. Id dinamis GLM ditandai sebagai hanya teks kecuali Anda mengonfigurasi entri model khusus dengan masukan gambar.

```json5
{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/models/<your-model-id>",
      },
    },
  },
}
```

<AccordionGroup>
  <Accordion title="Cara kerja pemberian awalan id model">
    Setiap referensi model Fireworks di OpenClaw diawali dengan `fireworks/`, diikuti id atau jalur router yang persis sama dari platform Fireworks. Contoh:

    - Model router: `fireworks/accounts/fireworks/routers/kimi-k2p5-turbo`
    - Model langsung: `fireworks/accounts/fireworks/models/<model-name>`

    OpenClaw menghapus awalan `fireworks/` saat menyusun permintaan API dan mengirimkan jalur sisanya ke endpoint Fireworks sebagai bidang `model` yang kompatibel dengan OpenAI.

  </Accordion>

  <Accordion title="Mengapa pemikiran dinonaktifkan secara paksa untuk Kimi">
    Fireworks menyajikan Kimi tanpa saluran penalaran terpisah, sehingga rantai pemikiran dapat muncul dalam aliran `content` yang terlihat. Pada setiap permintaan Kimi Fireworks, OpenClaw mengirimkan `thinking: { type: "disabled" }` dan menghapus `reasoning`, `reasoning_effort`, serta `reasoningEffort` dari payload (`extensions/fireworks/stream.ts`). Kebijakan penyedia (`extensions/fireworks/thinking-policy.ts`) hanya mengiklankan tingkat pemikiran `off` untuk id model Kimi, sehingga peralihan `/think` manual dan permukaan kebijakan penyedia tetap selaras dengan kontrak runtime.

    Untuk menggunakan penalaran Kimi dari awal hingga akhir, konfigurasikan [penyedia Moonshot](/id/providers/moonshot) dan rutekan model yang sama melaluinya.

  </Accordion>

  <Accordion title="Ketersediaan lingkungan untuk daemon">
    Jika Gateway berjalan sebagai layanan terkelola (launchd, systemd, Docker), kunci Fireworks harus terlihat oleh proses tersebut—bukan hanya oleh shell interaktif Anda.

    <Warning>
      Kunci yang hanya diekspor dalam shell interaktif tidak akan membantu daemon launchd atau systemd kecuali lingkungan tersebut juga diimpor ke sana. Tetapkan kunci di `~/.openclaw/.env` atau melalui `env.shellEnv` agar dapat dibaca dari proses Gateway.
    </Warning>

    OpenClaw memuat `~/.openclaw/.env` saat memuat konfigurasi, sehingga kunci yang disimpan di sana dapat dijangkau oleh layanan Gateway terkelola di setiap platform. Mulai ulang Gateway (atau jalankan kembali `openclaw doctor --fix`) setelah merotasi kunci.

  </Accordion>
</AccordionGroup>

## Terkait

<CardGroup cols={2}>
  <Card title="Penyedia model" href="/id/concepts/model-providers" icon="layers">
    Memilih penyedia, referensi model, dan perilaku failover.
  </Card>
  <Card title="Mode pemikiran" href="/id/tools/thinking" icon="brain">
    Tingkat `/think`, kebijakan penyedia, dan perutean model yang mampu melakukan penalaran.
  </Card>
  <Card title="Moonshot" href="/id/providers/moonshot" icon="moon">
    Jalankan Kimi dengan keluaran pemikiran native melalui API milik Moonshot.
  </Card>
  <Card title="Pemecahan masalah" href="/id/help/troubleshooting" icon="wrench">
    Pemecahan masalah umum dan FAQ.
  </Card>
</CardGroup>