Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Fireworks cung cấp các mô hình open-weight và mô hình định tuyến thông qua một API tương thích OpenAI. OpenClaw bao gồm một Plugin nhà cung cấp Fireworks được đóng gói sẵn, đi kèm hai mô hình Kimi đã được lập danh mục trước và chấp nhận mọi id mô hình hoặc router của Fireworks khi chạy.
Thuộc tínhGiá trị
Id nhà cung cấpfireworks (bí danh: fireworks-ai)
Pluginđược đóng gói sẵn, enabledByDefault: true
Biến môi trường xác thựcFIREWORKS_API_KEY
Cờ onboarding--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

Đặt khóa API Fireworks

openclaw onboard --auth-choice fireworks-api-key
Onboarding lưu khóa cho nhà cung cấp fireworks trong hồ sơ xác thực của bạn và đặt router Kimi K2.5 Turbo Fire Pass làm mô hình mặc định.
2

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 sẽ bá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

​
Danh mục tích hợp sẵn

Tham chiếu mô hìnhTênĐầu vàoNgữ cảnhĐầ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 cố định tất cả mô hình Fireworks Kimi ở thinking: off vì Fireworks từ chối tham số thinking của Kimi trong môi trường production. Định tuyến cùng mô hình trực tiếp qua Moonshot sẽ giữ nguyên đầu ra suy luận của Kimi. Xem chế độ thinking để chuyển đổi giữa các nhà cung cấp.

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

OpenClaw chấp nhận mọi id mô hình hoặc router của Fireworks 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 mẫu Kimi. 
{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/models/<your-model-id>",
      },
    },
  },
}
Mọi tham chiếu mô hình 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 đóng gói sẵn (extensions/fireworks/thinking-policy.ts) chỉ quảng bá mức thinking off cho id mô hình Kimi, nên các chuyển đổi /think thủ công và bề mặt chính sách nhà cung cấp luôn khớp với hợp đồng runtime.Để dùng suy luận 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ế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.
Khóa chỉ nằm trong ~/.profile 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 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 install (hoặc openclaw doctor --fix) sau khi xoay vòng khóa.

​
Liên quan

Nhà cung cấp mô hình

Chọn nhà cung cấp, tham chiếu mô hình và hành vi failover.

Chế độ thinking

Các mức /think, chính sách nhà cung cấp và định tuyến mô hình có khả năng suy 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.