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

Providers

Chutes

Chutes cung cấp các danh mục mô hình mã nguồn mở thông qua một API tương thích với OpenAI. OpenClaw hỗ trợ cả OAuth trên trình duyệt và xác thực bằng khóa API.

Thuộc tính Giá trị
Nhà cung cấp chutes
Plugin gói bên ngoài chính thức (@openclaw/chutes-provider)
API tương thích với OpenAI
URL cơ sở https://llm.chutes.ai/v1
Xác thực OAuth hoặc khóa API (xem bên dưới)
Biến môi trường runtime CHUTES_API_KEY, CHUTES_OAUTH_TOKEN

CHUTES_OAUTH_TOKEN cung cấp trực tiếp một access token OAuth đã lấy được (ví dụ trong CI), bỏ qua luồng trình duyệt tương tác bên dưới.

Cài đặt Plugin

bash
openclaw plugins install @openclaw/chutes-provideropenclaw gateway restart

Bắt đầu

Cả hai cách đều đặt mô hình mặc định thành chutes/zai-org/GLM-5-TEE và đăng ký danh mục Chutes.

OAuth

  • Chạy luồng thiết lập ban đầu OAuth

    bash
    openclaw onboard --auth-choice chutes

    OpenClaw khởi chạy luồng trình duyệt cục bộ hoặc hiển thị URL + luồng dán chuyển hướng trên máy chủ từ xa/không giao diện. Token OAuth tự động làm mới thông qua hồ sơ xác thực OpenClaw.

    • Khóa API

  • Lấy khóa API

    Tạo khóa tại chutes.ai/settings/api-keys.

  • Chạy luồng thiết lập ban đầu bằng khóa API

    bash
    openclaw onboard --auth-choice chutes-api-key

    • Hành vi khám phá

    Khi có thông tin xác thực Chutes, OpenClaw truy vấn GET /v1/models bằng thông tin xác thực đó và sử dụng các mô hình đã khám phá, được lưu vào bộ nhớ đệm trong 5 phút cho mỗi thông tin xác thực. Khi khóa hết hạn/không được ủy quyền (HTTP 401), OpenClaw thử lại một lần mà không có thông tin xác thực. Nếu quá trình khám phá vẫn không trả về hàng nào, thất bại hoặc trả về bất kỳ trạng thái không phải 2xx nào khác, hệ thống quay về danh mục tĩnh đi kèm (cả khám phá bằng khóa API và OAuth đều sử dụng cùng đường dẫn này). Nếu quá trình khám phá thất bại khi khởi động, danh mục tĩnh sẽ tự động được sử dụng.

    Bí danh mặc định

    OpenClaw đăng ký hai bí danh tiện dụng cho danh mục Chutes:

    Bí danh Mô hình đích
    chutes-pro chutes/deepseek-ai/DeepSeek-V3.2-TEE
    chutes-vision chutes/moonshotai/Kimi-K2.5-TEE

    Danh mục khởi đầu tích hợp sẵn

    Danh mục dự phòng đi kèm chứa năm mô hình hiện đang được cung cấp sau:

    Tham chiếu mô hình
    chutes/zai-org/GLM-5-TEE
    chutes/deepseek-ai/DeepSeek-V3.2-TEE
    chutes/moonshotai/Kimi-K2.5-TEE
    chutes/MiniMaxAI/MiniMax-M2.5-TEE
    chutes/Qwen/Qwen3.5-397B-A17B-TEE

    Chạy openclaw models list --all --provider chutes để xem danh sách đầy đủ.

    Ví dụ cấu hình

    json5
    {  agents: {    defaults: {      model: { primary: "chutes/zai-org/GLM-5-TEE" },      models: {        "chutes/zai-org/GLM-5-TEE": { alias: "Chutes GLM 5" },        "chutes/deepseek-ai/DeepSeek-V3.2-TEE": { alias: "Chutes DeepSeek V3.2" },      },    },  },}
    Ghi đè OAuth

    Tùy chỉnh luồng OAuth bằng các biến môi trường tùy chọn:

    Biến Mục đích
    CHUTES_CLIENT_ID ID máy khách OAuth (sẽ được nhắc nhập nếu chưa đặt)
    CHUTES_CLIENT_SECRET Bí mật máy khách OAuth
    CHUTES_OAUTH_REDIRECT_URI URI chuyển hướng (mặc định http://127.0.0.1:1456/oauth-callback)
    CHUTES_OAUTH_SCOPES Các phạm vi phân tách bằng dấu cách (mặc định openid profile chutes:invoke)

    Xem tài liệu OAuth của Chutes để biết các yêu cầu đối với ứng dụng chuyển hướng và nhận trợ giúp.

    Ghi chú
    • Các mô hình Chutes được đăng ký dưới dạng chutes/<model-id>.
    • Chutes không báo cáo mức sử dụng token trong khi truyền phát trực tuyến (supportsUsageInStreaming: false); tổng mức sử dụng vẫn hiển thị sau khi luồng hoàn tất.

    Liên quan

    Chọn mô hình

    Quy tắc nhà cung cấp, tham chiếu mô hình và hành vi chuyển đổi dự phòng.
    Tham chiếu cấu hình

    Lược đồ cấu hình đầy đủ, bao gồm các thiết lập nhà cung cấp.
    Chutes

    Bảng điều khiển Chutes và tài liệu API.
    Khóa API Chutes

    Tạo và quản lý khóa API Chutes.
    Was this useful?
    On this page

    On this page