Chuyển đến nội dung chính
Fireworks cung cấp các mô hình trọng số mở và mô hình được định tuyến thông qua API tương thích OpenAI. Cài đặt Plugin provider Fireworks chính thức để sử dụng hai mô hình Kimi đã được đưa sẵn vào catalog và bất kỳ mô hình hoặc router id Fireworks nào khi chạy.
Thuộc tínhGiá trị
Provider idfireworks (bí danh: fireworks-ai)
Package@openclaw/fireworks-provider
Biến env xác thựcFIREWORKS_API_KEY
Cờ thiết lập ban đầu--auth-choice fireworks-api-key
Cờ CLI trực tiếp--fireworks-api-key <key>
APITương thích OpenAI (openai-completions)
URL cơ sởhttps://api.fireworks.ai/inference/v1
Mô hình mặc địnhfireworks/accounts/fireworks/routers/kimi-k2p5-turbo
Bí danh mặc địnhKimi K2.5 Turbo

​
Bắt đầu

1

Cài đặt Plugin

openclaw plugins install @openclaw/fireworks-provider
2

Đặt khóa API Fireworks

openclaw onboard --auth-choice fireworks-api-key

openclaw onboard --non-interactive \
  --auth-choice fireworks-api-key \
  --fireworks-api-key "$FIREWORKS_API_KEY"

export FIREWORKS_API_KEY=fw-...
Quy trình thiết lập ban đầu lưu khóa vào provider fireworks trong hồ sơ xác thực của bạn và đặt router Fire Pass Kimi K2.5 Turbo làm mô hình mặc định.
3

Xác minh mô hình có sẵn

openclaw models list --provider fireworks
Danh sách nên bao gồm Kimi K2.6 và Kimi K2.5 Turbo (Fire Pass). Nếu FIREWORKS_API_KEY chưa được phân giải, openclaw models status --json báo cáo thông tin xác thực bị thiếu trong auth.unusableProfiles.

​
Thiết lập không tương tác

Đối với cài đặt bằng script hoặc CI, truyền mọi thứ trên dòng lệnh: 
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice fireworks-api-key \
  --fireworks-api-key "$FIREWORKS_API_KEY" \
  --skip-health \
  --accept-risk

​
Catalog tích hợp sẵn

Model refTênĐầu vàoContextĐầu ra tối đaThinking
fireworks/accounts/fireworks/models/kimi-k2p6Kimi K2.6văn bản + hình ảnh262,144262,144Bắt buộc tắt
fireworks/accounts/fireworks/routers/kimi-k2p5-turboKimi K2.5 Turbo (Fire Pass)văn bản + hình ảnh256,000256,000Bắt buộc tắt (mặc định)
OpenClaw ghim tất cả mô hình Fireworks Kimi ở thinking: off vì Fireworks từ chối các tham số thinking của Kimi trong môi trường production. Việc định tuyến cùng mô hình trực tiếp qua Moonshot vẫn giữ nguyên đầu ra lập luận của Kimi. Xem chế độ thinking để chuyển đổi giữa các provider.

​
ID mô hình Fireworks tùy chỉnh

OpenClaw chấp nhận bất kỳ mô hình hoặc router id Fireworks nào khi chạy. Dùng đúng id do Fireworks hiển thị và thêm tiền tố fireworks/. Cơ chế phân giải động sao chép mẫu Fire Pass (đầu vào văn bản + hình ảnh, API tương thích OpenAI, chi phí mặc định bằng không) và tự động tắt thinking khi id khớp với mẫu Kimi. Các id động GLM được đánh dấu là chỉ văn bản trừ khi bạn cấu hình một mục mô hình tùy chỉnh có đầu vào hình ảnh. 
{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/models/<your-model-id>",
      },
    },
  },
}
Mọi model ref Fireworks trong OpenClaw đều bắt đầu bằng fireworks/, theo sau là id chính xác hoặc đường dẫn router từ nền tảng Fireworks. Ví dụ:
  • Mô hình router: fireworks/accounts/fireworks/routers/kimi-k2p5-turbo
  • Mô hình trực tiếp: fireworks/accounts/fireworks/models/<model-name>
OpenClaw loại bỏ tiền tố fireworks/ khi tạo yêu cầu API và gửi phần đường dẫn còn lại đến endpoint Fireworks dưới dạng trường model tương thích OpenAI.
Fireworks K2.6 trả về 400 nếu yêu cầu mang các tham số reasoning_*, dù Kimi hỗ trợ thinking thông qua API riêng của Moonshot. Chính sách provider (extensions/fireworks/thinking-policy.ts) chỉ công bố mức thinking off cho các model id Kimi, vì vậy các lần chuyển thủ công bằng /think và các bề mặt chính sách provider vẫn đồng bộ với hợp đồng runtime.Để sử dụng khả năng lập luận Kimi từ đầu đến cuối, hãy cấu hình provider Moonshot và định tuyến cùng mô hình qua provider đó.
Nếu Gateway chạy như một dịch vụ được quản lý (launchd, systemd, Docker), khóa Fireworks phải hiển thị với tiến trình đó — không chỉ với shell tương tác của bạn.
Một khóa chỉ được export trong shell tương tác sẽ không giúp daemon launchd hoặc systemd trừ khi môi trường đó cũng được nhập vào đó. Đặt khóa trong ~/.openclaw/.env hoặc thông qua env.shellEnv để tiến trình gateway có thể đọc được.
Trên macOS, openclaw gateway install đã nối ~/.openclaw/.env vào tệp môi trường LaunchAgent. Chạy lại cài đặt (hoặc openclaw doctor --fix) sau khi xoay vòng khóa.

​
Liên quan

Provider mô hình

Chọn provider, model ref và hành vi failover.

Chế độ thinking

Các mức /think, chính sách provider và định tuyến mô hình có khả năng lập luận.

Moonshot

Chạy Kimi với đầu ra thinking gốc thông qua API riêng của Moonshot.

Khắc phục sự cố

Khắc phục sự cố chung và câu hỏi thường gặp.