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

Providers

Kembang Api

Fireworks 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

  • Instal plugin

    bash
    openclaw plugins install @openclaw/fireworks-provider

  • Tetapkan kunci API Fireworks

    Orientasi
    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-...

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

  • 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.

    • 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)

    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>",      },    },  },}
    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.

    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 dan rutekan model yang sama melaluinya.

    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.

    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.

    Terkait

    Penyedia model

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

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

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

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

    On this page