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

Providers

Fireworks

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 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ỳ id mô hình hoặc bộ định tuyến Fireworks nào trong thời gian chạy.

Thuộc tính Giá trị
Id 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-k2p6-turbo
Bí danh mặc định Kimi K2.6 Turbo

Bắt đầu

  • Cài đặt Plugin

    bash
    openclaw plugins install @openclaw/fireworks-provider

  • Đặt khóa API Fireworks

    Thiết lập ban đầu
    openclaw onboard --auth-choice fireworks-api-key
    Cờ trực tiếp
    openclaw onboard --non-interactive \--auth-choice fireworks-api-key \--fireworks-api-key "$FIREWORKS_API_KEY"
    Chỉ biến môi trường
    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.6 Turbo Fire Pass làm mô hình mặc định.

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

    bash
    openclaw models list --provider fireworks

    Danh sách phải bao gồm Kimi K2.6 và Kimi K2.6 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 bị thiếu trong auth.unusableProfiles.

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

    Đối với quy trình cài đặt bằng tập lệnh hoặc CI, hãy truyền mọi thứ trên dòng lệnh:

    bash
    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ì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-k2p6-turbo Kimi K2.6 Turbo (Fire Pass) văn bản + hình ảnh 256,000 256,000 Buộc tắt (mặc định)

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

    OpenClaw chấp nhận bất kỳ id mô hình hoặc bộ định tuyến Fireworks nào trong thời gian chạy. Sử dụng chính xác id do Fireworks hiển thị và thêm tiền tố fireworks/. Quá trình 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 id khớp với mẫu Kimi. Các id GLM động được đánh dấu là chỉ hỗ trợ văn bản, trừ khi bạn định cấu hình một mục mô hình tùy chỉnh có đầu vào hình ảnh.

    json5
    {  agents: {    defaults: {      model: {        primary: "fireworks/accounts/fireworks/models/<your-model-id>",      },    },  },}
    Cách thêm tiền tố vào id mô hình

    Mọi tham chiếu mô hình Fireworks trong OpenClaw đều bắt đầu bằng fireworks/, theo sau là id 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-k2p6-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 cung cấp 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ị. Trong mọi yêu cầu Kimi trên Fireworks, OpenClaw gửi thinking: { type: "disabled" } và loại bỏ reasoning, reasoning_effort và 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 id mô hình Kimi, nhờ đó các thao tác chuyển đổi /think thủ công và các bề mặt chính sách nhà cung cấp luôn nhất quán với hợp đồng thời gian chạy.

    Để sử dụng toàn bộ khả năng suy luận của Kimi từ đầu đến cuối, hãy định 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 shell tương tác của bạn.

    OpenClaw tải ~/.openclaw/.env khi tải 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 xoay vòng khóa.

    Liên quan

    Nhà cung cấp mô hình

    Cách chọn nhà cung cấp, tham chiếu mô hình và hành vi chuyển đổi dự phòng.
    Chế độ suy luận

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

    Chạy Kimi với đầu ra suy luận gốc thông qua API riêng của Moonshot.
    Khắc phục sự cố

    Hướng dẫn khắc phục sự cố chung và câu hỏi thường gặp.
    Was this useful?
    On this page

    On this page