Hugging Face (suy luận)

OpenClaw phát hiện các mô hình bằng:

GET https://router.huggingface.co/v1/modelsAuthorization: Bearer $HUGGINGFACE_HUB_TOKEN   # hoặc $HF_TOKEN

Phản hồi theo kiểu OpenAI: { "object": "list", "data": [ { "id": "Qwen/Qwen3-8B", "owned_by": "Qwen", ... }, ... ] }.

Khi đã cấu hình khóa (qua quy trình thiết lập ban đầu, HUGGINGFACE_HUB_TOKEN hoặc HF_TOKEN), danh sách thả xuống Default Hugging Face model trong quá trình thiết lập tương tác sẽ được điền từ điểm cuối này. Khi Gateway khởi động, lệnh gọi tương tự được thực hiện lại để làm mới danh mục. Các mô hình được phát hiện sẽ được hợp nhất với danh mục tích hợp ở trên (dùng cho siêu dữ liệu như cửa sổ ngữ cảnh và chi phí khi ID trùng khớp). Nếu yêu cầu thất bại, không trả về dữ liệu hoặc chưa đặt khóa, OpenClaw chỉ sử dụng danh mục tích hợp.

Tắt tính năng phát hiện mà không xóa nhà cung cấp:

openclaw config set plugins.entries.huggingface.config.discovery.enabled false

• Tên từ API: các mô hình được phát hiện sử dụng name, title hoặc display_name của API khi có; nếu không, OpenClaw suy ra tên từ ID mô hình (ví dụ: deepseek-ai/DeepSeek-R1 trở thành "DeepSeek R1").
• Ghi đè tên hiển thị: đặt nhãn tùy chỉnh cho từng mô hình trong cấu hình:

{  agents: {    defaults: {      models: {        "huggingface/deepseek-ai/DeepSeek-R1": { alias: "DeepSeek R1 (fast)" },        "huggingface/deepseek-ai/DeepSeek-R1:cheapest": { alias: "DeepSeek R1 (cheap)" },      },    },  },}

• Hậu tố chính sách: :fastest và :cheapest là quy ước của bộ định tuyến HF, không phải nội dung mà OpenClaw viết lại: hậu tố được gửi nguyên văn như một phần của ID mô hình và bộ định tuyến của HF chọn nhà cung cấp suy luận tương ứng. Thêm từng biến thể dưới dạng một mục riêng trong models.providers.huggingface.models (hoặc trong model.primary) nếu bạn muốn có bí danh riêng cho từng hậu tố.
• Hợp nhất cấu hình: các mục hiện có trong models.providers.huggingface.models (ví dụ: trong models.json) được giữ lại khi hợp nhất cấu hình, vì vậy mọi name, alias tùy chỉnh hoặc tùy chọn mô hình bạn đặt ở đó vẫn tồn tại sau khi khởi động lại.

Nếu Gateway chạy dưới dạng daemon (launchd/systemd), hãy đảm bảo HUGGINGFACE_HUB_TOKEN hoặc HF_TOKEN khả dụng cho tiến trình đó (ví dụ: trong ~/.openclaw/.env hoặc thông qua env.shellEnv).