OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Fireworks

Fireworks menyediakan model berbobot terbuka dan model terarah melalui API yang kompatibel dengan OpenAI. Instal plugin penyedia Fireworks resmi untuk menggunakan dua model Kimi yang telah dikatalogkan dan model atau id router Fireworks apa pun saat runtime.

Properti Nilai
Id penyedia fireworks (alias: fireworks-ai)
Paket @openclaw/fireworks-provider
Variabel env autentikasi FIREWORKS_API_KEY
Flag onboarding --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 default fireworks/accounts/fireworks/routers/kimi-k2p6-turbo
Alias default Kimi K2.6 Turbo

Memulai

  • Instal plugin

    bash
    openclaw plugins install @openclaw/fireworks-provider

  • Tetapkan kunci API Fireworks

    Onboarding
    openclaw onboard --auth-choice fireworks-api-key
    Flag langsung
    openclaw onboard --non-interactive \--auth-choice fireworks-api-key \--fireworks-api-key "$FIREWORKS_API_KEY"
    Hanya env
    export FIREWORKS_API_KEY=fw-...

    Onboarding menyimpan kunci untuk penyedia fireworks dalam profil autentikasi Anda dan menetapkan router Kimi K2.6 Turbo Fire Pass sebagai model default.

  • Verifikasi bahwa model tersedia

    bash
    openclaw models list --provider fireworks

    Daftar tersebut seharusnya menyertakan Kimi K2.6 dan Kimi K2.6 Turbo (Fire Pass). Jika FIREWORKS_API_KEY tidak dapat diresolusi, openclaw models status --json melaporkan kredensial yang tidak tersedia pada auth.unusableProfiles.

    • Penyiapan noninteraktif

    Untuk instalasi dengan skrip atau Pipeline 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 Input Konteks Output maks. Pemikiran
    fireworks/accounts/fireworks/models/kimi-k2p6 Kimi K2.6 teks + gambar 262,144 262,144 Dipaksa nonaktif
    fireworks/accounts/fireworks/routers/kimi-k2p6-turbo Kimi K2.6 Turbo (Fire Pass) teks + gambar 256,000 256,000 Dipaksa nonaktif (default)

    Id model Fireworks khusus

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

    json5
    {  agents: {    defaults: {      model: {        primary: "fireworks/accounts/fireworks/models/<your-model-id>",      },    },  },}
    Cara kerja pemberian awalan id model

    Setiap referensi model Fireworks di OpenClaw diawali dengan fireworks/ yang diikuti oleh id atau jalur router persis dari platform Fireworks. Contoh:

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

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

    Alasan pemikiran dipaksa nonaktif untuk Kimi

    Fireworks menyajikan Kimi tanpa saluran penalaran terpisah, sehingga alur 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 manual /think dan permukaan kebijakan penyedia tetap selaras dengan kontrak runtime.

    Untuk menggunakan penalaran Kimi secara menyeluruh, konfigurasikan penyedia Moonshot dan arahkan model yang sama melaluinya.

    Ketersediaan lingkungan untuk daemon

    Jika Gateway berjalan sebagai layanan terkelola (launchd, systemd, Docker), kunci Fireworks harus dapat dilihat oleh proses tersebut — bukan hanya oleh shell interaktif Anda.

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

    Terkait

    Penyedia model

    Memilih penyedia, referensi model, dan perilaku failover.
    Mode pemikiran

    Tingkat /think, kebijakan penyedia, dan pengarahan model yang mampu melakukan penalaran.
    Moonshot

    Jalankan Kimi dengan output pemikiran native melalui API milik Moonshot.
    Pemecahan masalah

    Pemecahan masalah umum dan FAQ.
    Was this useful?
    On this page

    On this page