Providers
Pháo hoa
Fireworks cung cấp các mô hình trọng số mở và mô hình định tuyến thông qua API tương thích với OpenAI. Cài đặt plugin nhà cung cấp Fireworks chính thức để sử dụng hai mô hình Kimi đã được lập danh mục sẵn và bất kỳ mã định danh mô hình hoặc bộ định tuyến Fireworks nào trong thời gian chạy.
| Thuộc tính | Giá trị |
|---|---|
| Mã định danh nhà cung cấp | fireworks (bí danh: fireworks-ai) |
| Gói | @openclaw/fireworks-provider |
| Biến môi trường xác thực | FIREWORKS_API_KEY |
| Cờ thiết lập ban đầu | --auth-choice fireworks-api-key |
| Cờ CLI trực tiếp | --fireworks-api-key <key> |
| API | Tương thích với OpenAI (openai-completions) |
| URL cơ sở | https://api.fireworks.ai/inference/v1 |
| Mô hình mặc định | fireworks/accounts/fireworks/routers/kimi-k2p5-turbo |
| Bí danh mặc định | Kimi K2.5 Turbo |
Bắt đầu
Cài đặt plugin
openclaw plugins install @openclaw/fireworks-providerĐặt khóa API Fireworks
openclaw onboard --auth-choice fireworks-api-keyopenclaw onboard --non-interactive \--auth-choice fireworks-api-key \--fireworks-api-key "$FIREWORKS_API_KEY"export FIREWORKS_API_KEY=fw-...Quá trình thiết lập ban đầu lưu khóa cho nhà cung cấp fireworks trong các hồ sơ xác thực của bạn và đặt bộ định tuyến Kimi K2.5 Turbo Fire Pass làm mô hình mặc định.
Xác minh mô hình khả dụng
openclaw models list --provider fireworksDanh sách phải bao gồm Kimi K2.6 và Kimi K2.5 Turbo (Fire Pass). Nếu không thể phân giải FIREWORKS_API_KEY, openclaw models status --json sẽ báo thông tin xác thực còn thiếu trong auth.unusableProfiles.
Thiết lập không tương tác
Đối với các lượt cài đặt bằng tập lệnh hoặc CI, hãy truyền mọi thông tin 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-riskDanh mục tích hợp sẵn
| Tham chiếu mô hình | Tên | Đầu vào | Ngữ cảnh | Đầu ra tối đa | Suy luận |
|---|---|---|---|---|---|
fireworks/accounts/fireworks/models/kimi-k2p6 |
Kimi K2.6 | văn bản + hình ảnh | 262,144 | 262,144 | Buộc tắt |
fireworks/accounts/fireworks/routers/kimi-k2p5-turbo |
Kimi K2.5 Turbo (Fire Pass) | văn bản + hình ảnh | 256,000 | 256,000 | Buộc tắt (mặc định) |
Mã định danh mô hình Fireworks tùy chỉnh
OpenClaw chấp nhận bất kỳ mã định danh mô hình hoặc bộ định tuyến Fireworks nào trong thời gian chạy. Hãy dùng chính xác mã định danh 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 với OpenAI, chi phí mặc định bằng không) và tự động tắt suy luận khi mã định danh khớp với mẫu Kimi. Các mã định danh GLM động được đánh dấu là chỉ hỗ trợ 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>", }, }, },}Cách thêm tiền tố vào mã định danh mô hình
Mọi tham chiếu mô hình Fireworks trong OpenClaw đều bắt đầu bằng fireworks/, theo sau là mã định danh hoặc đường dẫn bộ định tuyến chính xác từ nền tảng Fireworks. Ví dụ:
- Mô hình bộ định tuyến:
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 đường dẫn còn lại đến điểm cuối Fireworks dưới dạng trường model tương thích với OpenAI.
Tại sao Kimi bị buộc tắt suy luận
Fireworks phục vụ Kimi mà không có kênh suy luận riêng, vì vậy chuỗi suy luận có thể xuất hiện trong luồng content hiển thị. Với mọi yêu cầu Kimi trên Fireworks, OpenClaw gửi thinking: { type: "disabled" } và loại bỏ reasoning, reasoning_effort cùng reasoningEffort khỏi tải trọng (extensions/fireworks/stream.ts). Chính sách nhà cung cấp (extensions/fireworks/thinking-policy.ts) chỉ công bố mức suy luận off cho các mã định danh mô hình Kimi, nhờ đó các lần chuyển đổi /think thủ công và các bề mặt chính sách nhà cung cấp luôn thống nhất với hợp đồng thời gian chạy.
Để sử dụng khả năng suy luận của Kimi từ đầu đến cuối, hãy cấu hình nhà cung cấp Moonshot và định tuyến cùng mô hình đó qua nhà cung cấp này.
Khả năng truy cập biến môi trường của tiến trình nền
Nếu Gateway chạy dưới dạng 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 trình bao tương tác của bạn.
OpenClaw nạp ~/.openclaw/.env khi nạp cấu hình, vì vậy các khóa được lưu tại đó sẽ đến được các dịch vụ Gateway được quản lý trên mọi nền tảng. Khởi động lại Gateway (hoặc chạy lại openclaw doctor --fix) sau khi thay khóa.
Nội dung liên quan
Cách chọn nhà cung cấp, tham chiếu mô hình và hành vi chuyển đổi dự phòng.
Các mức /think, chính sách nhà cung cấp và cách định tuyến các mô hình có khả năng suy luận.
Chạy Kimi với đầu ra suy luận gốc thông qua API riêng của Moonshot.
Hướng dẫn khắc phục sự cố chung và câu hỏi thường gặp.