Cấu hình OpenClaw
OpenClaw là một công cụ dòng lệnh/Web UI hướng tới các tình huống lập trình. Công cụ này hỗ trợ nhiều giao thức mô hình, do đó trọng tâm của việc cấu hình không chỉ là điền một địa chỉ mà là phải ghép cặp chính xác giữa baseUrl và api.
Thông tin chính thức Tải về và tài liệu tham khảo theo trang web chính thức.
Công cụ này là gì và dùng để làm gì
Trước tiên hãy xác định cách chọn giao thức
| Tình huống | Cách xem Base URL | Cách chọn trường API |
|---|---|---|
| OpenAI Native | Sử dụng địa chỉ API OpenAI / tương thích OpenAI do provider cung cấp, việc có bao gồm /v1 hay không phụ thuộc vào backend | openai-responses |
| Claude Native | Sử dụng địa chỉ giao diện Anthropic / Claude do provider cung cấp | anthropic-messages |
| Gemini Native | Sử dụng địa chỉ giao diện Google / Gemini do provider cung cấp | google-generative-ai |
| Chế độ tương thích (Compatibility Mode) | Địa chỉ giao diện tương thích OpenAI của provider | openai-completions |
Nếu trang của provider phân tách riêng các giao diện OpenAI, Claude và Gemini, đừng chỉ sao chép tên miền; hãy sao chép cả địa chỉ đầy đủ cho giao thức tương ứng.
Tham khảo đoạn cấu hình mẫu
Tệp cấu hình thường nằm tại ~/. openclaw/openclaw.json Nếu trình hướng dẫn khởi tạo không thể điền chính xác địa chỉ của provider, trước tiên bạn có thể bỏ qua bước chọn mô hình rồi chỉnh sửa tệp cấu hình theo cách thủ công.
Đoạn mã ví dụ cho một Provider duy nhất trong OpenClaw
"models": { "providers": { "mz-openai": { "baseUrl": "https://YOUR_PROVIDER_API_URL", "apiKey": "YOUR_KEY", "auth": "api-key", "api": "openai-responses", "models": [ { "id": "MODEL_ID_FROM_PROVIDER_DASHBOARD", "name": "DISPLAY_NAME", "reasoning": false, "input": [], "contextWindow": 128000, "maxTokens": 32000 } ] } } }Cách kiểm tra sau khi lưu
- Trước tiên, chỉ cấu hình một provider và không thêm quá nhiều mô hình cùng một lúc.
- Vào dự án thử nghiệm và chọn mô hình mới được thêm vào.
- Gửi câu hỏi ngắn nhất, ví dụ: 'Please only reply with configuration successful.'
- Nếu báo lỗi giao thức, trước tiên hãy kiểm tra xem trường api và Base URL có đến từ cùng một loại giao diện hay không.
Câu hỏi thường gặp cho người mới bắt đầu
| Hiện tượng | Ưu tiên kiểm tra | Cách xử lý |
|---|---|---|
| Lỗi liên quan đến giao thức | Kiểm tra xem trường api có khớp với Base URL hay không | Không trộn lẫn OpenAI, Claude và Gemini; điền theo đúng giao thức tương ứng của provider |
| Danh sách mô hình trống | Provider có hỗ trợ lấy danh sách mô hình không? | Nhập thủ công model ID / tên mô hình do backend cung cấp khi lấy dữ liệu thất bại |
| Đã thay đổi tệp cấu hình nhưng không có hiệu lực | Đã chỉnh sửa đúng tệp cấu hình mà OpenClaw thực tế đang đọc hay chưa | Khởi động lại OpenClaw và thử lại; không thay đổi nhiều thiết lập cấu hình cùng một lúc |
| Key chính xác nhưng vẫn thất bại | Các trường auth và apiKey của Provider hiện tại | Xác nhận rằng Key thuộc về đúng giao thức hiện tại và provider hiện tại |
Trang web chính thức OpenClaw Xem giới thiệu công cụ và lối vào.
Tham khảo cấu hình provider AI trên OpenClaw Tham khảo phương pháp cấu hình theo cặp các trường baseUrl và api theo các giao thức khác nhau.