@openclaw/clawrouter đi kèm và một
thông tin xác thực ClawRouter đã được cấp.
| Thuộc tính | Giá trị |
|---|---|
| Nhà cung cấp | clawrouter |
| Gói | @openclaw/clawrouter |
| Xác thực | CLAWROUTER_API_KEY |
| URL mặc định | https://clawrouter.openclaw.ai |
| Danh mục mô hình | Phạm vi theo thông tin xác thực qua /v1/catalog |
| Hạn mức | Ngân sách hằng tháng và mức sử dụng qua /v1/usage |
Bắt đầu
Lấy thông tin xác thực có phạm vi
Hãy yêu cầu quản trị viên ClawRouter cấp thông tin xác thực có chính sách bao gồm
các nhà cung cấp, mô hình và ngân sách hằng tháng mà bạn nên dùng. Thông tin xác thực
chỉ được hiển thị một lần khi được cấp.
Cấu hình OpenClaw
plugins.allow, hãy thêm clawrouter vào danh sách đó trước khi bật Plugin. Đối với
triển khai tùy chỉnh, đặt models.providers.clawrouter.baseUrl thành
nguồn gốc ClawRouter; mặc định là https://clawrouter.openclaw.ai.Liệt kê các mô hình được cấp quyền
clawrouter/openai/..., clawrouter/anthropic/..., hoặc
clawrouter/google/.... Nếu agents.defaults.models là danh sách cho phép trong
cấu hình của bạn, hãy thêm từng tham chiếu ClawRouter đã chọn vào đó.Phát hiện mô hình
GET /v1/catalog là nguồn chân lý. OpenClaw không phát hành một danh sách
mô hình ClawRouter cố định thứ hai. Một mô hình được cấu hình trong ClawRouter sẽ xuất hiện khi:
- chính sách của thông tin xác thực cấp quyền cho nhà cung cấp của mô hình đó;
- kết nối nhà cung cấp đã được bật và sẵn sàng;
- mô hình trong danh mục quảng bá một năng lực LLM được hỗ trợ; và
- danh mục công bố một hợp đồng truyền tải được Plugin hỗ trợ.
Giao thức và Plugin nhà cung cấp
Bạn không cần cài đặt Plugin xác thực của mọi công ty thượng nguồn. ClawRouter sở hữu thông tin xác thực thượng nguồn; danh mục của nó cho OpenClaw biết nên dùng phương thức truyền tải nào. Plugin hỗ trợ:| Tuyến danh mục | Phương thức truyền tải OpenClaw |
|---|---|
| Chat tương thích OpenAI | openai-completions |
| Responses tương thích OpenAI | openai-responses |
| Tin nhắn Anthropic gốc | anthropic-messages |
| Truyền phát Google Gemini gốc | google-generative-ai |
Hạn mức và mức sử dụng
Phản hồi/v1/usage của ClawRouter cung cấp dữ liệu cho các bề mặt mức sử dụng nhà cung cấp
thông thường của OpenClaw. /status và trạng thái dashboard liên quan hiển thị cửa sổ ngân sách hằng tháng
khi khóa có giới hạn, cùng tổng số yêu cầu, token và chi tiêu. Các khóa không đo lường
vẫn hiển thị mức sử dụng tổng hợp mà không có cửa sổ phần trăm.
Tra cứu hạn mức dùng cùng khóa có phạm vi như phát hiện mô hình. Tra cứu hạn mức
thất bại không chặn việc thực thi mô hình.
Kiểm tra snapshot trực tiếp bằng:
/status trong chat và giao diện mức sử dụng
của OpenClaw. Ngân sách áp dụng cho toàn chính sách, nên các yêu cầu do một client khác thực hiện bằng
cùng chính sách ClawRouter có thể thay đổi phần trăm còn lại.
Khắc phục sự cố
| Triệu chứng | Kiểm tra |
|---|---|
| Không có mô hình ClawRouter | Xác nhận Plugin đã được bật và được plugins.allow cho phép, sau đó kiểm tra thông tin xác thực còn hoạt động và cấp quyền cho ít nhất một nhà cung cấp sẵn sàng. |
| Thiếu một mô hình ClawRouter đã cấu hình | Kiểm tra năng lực và định dạng tuyến của mô hình đó trong /v1/catalog. Các hợp đồng truyền tải không được hỗ trợ được cố ý lọc ra. |
Unknown model: clawrouter/... | Thêm tham chiếu danh mục chính xác vào agents.defaults.models khi bản đồ cấu hình đó đang được dùng làm danh sách cho phép. |
401 hoặc 403 từ danh mục hoặc mức sử dụng | Cấp lại hoặc đặt lại phạm vi thông tin xác thực ClawRouter; OpenClaw không dự phòng sang khóa nhà cung cấp thượng nguồn. |
| Lệnh gọi mô hình thất bại sau khi phát hiện | Kiểm tra kết nối nhà cung cấp và tình trạng thượng nguồn trong ClawRouter, sau đó thử lại khi trạng thái sẵn sàng của nó phục hồi. |
| Mức sử dụng có tổng số nhưng không có phần trăm | Chính sách không được đo lường; thêm ngân sách hằng tháng trong ClawRouter để hiển thị cửa sổ phần trăm. |
Hành vi bảo mật
- Phát hiện danh mục có phạm vi theo khóa proxy đã cấu hình và được lưu vào cache theo từng khóa.
- Khóa proxy chỉ được gắn khi điều phối yêu cầu; nó không được lưu trong siêu dữ liệu mô hình.
- ID mô hình Anthropic và Gemini gốc chỉ được viết lại thành ID thượng nguồn của chúng khi điều phối.
- Các hàng danh mục không được hỗ trợ hoặc không được cấp quyền sẽ fail closed và không thể chọn.
Liên quan
Nhà cung cấp mô hình
Cấu hình nhà cung cấp và lựa chọn mô hình.
Theo dõi mức sử dụng
Các bề mặt mức sử dụng và trạng thái của OpenClaw.