OpenClaw

Tác nhân dòng lệnh · OpenAI Chat, OpenAI Responses, Anthropic Messages, Gemini

Hướng dẫn đầy đủ

Định dạng	Nơi cấu hình
OpenAI Chat, OpenAI Responses, Anthropic Messages, Gemini	Cấu hình OpenClaw (~/.openclaw/openclaw.json) → models.providers.<id>; mô hình mặc định — agents.defaults.model.primary; chỉnh sửa an toàn — openclaw config set models.providers.<id> '<json>' --strict-json --merge

Cấu hình

Sao chép cấu hình và thay sk-... bằng khóa của bạn từ trang quản lý tài khoản Ailoot. Nên lưu khóa trong biến môi trường AILOOT_API_KEY, nếu ứng dụng hỗ trợ.

Trước khi chạy, gọi GET /v1/models bằng khóa Ailoot của bạn. Chọn ID mô hình chính xác có các phương thức POST /v1/chat/completions, POST /v1/responses, POST /v1/messages, POST /v1beta/models/{model}:generateContent rồi dùng ID đó trong cấu hình. Với tác tử, hãy kiểm tra cả công cụ và tính năng mà phiên bản ứng dụng của bạn cần.

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "ailoot/claude-sonnet-5-5"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "ailoot": {
        "baseUrl": "https://api.ailoot.ai/v1",
        "apiKey": "${AILOOT_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-sonnet-5-5",
            "name": "Claude Sonnet 5.5",
            "reasoning": true,
            "input": [
              "text"
            ],
            "contextWindow": 1000000,
            "maxTokens": 128000
          },
          {
            "id": "deepseek-v4-pro",
            "name": "DeepSeek V4 Pro",
            "reasoning": true,
            "input": [
              "text"
            ],
            "contextWindow": 1000000,
            "maxTokens": 131072
          }
        ]
      },
      "ailoot-claude": {
        "baseUrl": "https://api.ailoot.ai",
        "apiKey": "${AILOOT_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-opus-5-5",
            "name": "Claude Opus 5.5",
            "reasoning": true,
            "input": [
              "text"
            ],
            "contextWindow": 1000000,
            "maxTokens": 131072
          }
        ]
      }
    }
  }
}

Cấu hình này đọc khóa từ biến AILOOT_API_KEY. Hãy đặt biến trước khi khởi động ứng dụng:

export AILOOT_API_KEY="sk-..."   # thêm vào ~/.zshrc hoặc ~/.bashrc

setx AILOOT_API_KEY "sk-..."   # sau đó khởi động lại terminal

Mô hình ví dụ: claude-sonnet-5-5. Chọn bất kỳ mô hình khác từ danh mục — kiểm tra xem mô hình đó có định dạng cần thiết hay không.

Điều cần biết

Các bộ chuyển đổi api: openai-completions (mặc định khi đặt baseUrl), openai-responses (chỉ khi máy chủ hỗ trợ /v1/responses — Ailoot có hỗ trợ), anthropic-messages, google-generative-ai và các loại khác. Với anthropic-messages, các ví dụ OpenClaw đặt baseUrl không có /v1. OpenClaw có thể truyền hình ảnh khi input của mô hình chứa "image". Các ví dụ Claude chỉ giữ văn bản: trong bản chụp danh mục ngày 2026-09-30, những phương thức này không khai báo đầu vào image. Chỉ thêm "image" cho mô hình cụ thể có thẻ trong danh mục hiện tại khai báo đầu vào hình ảnh và định dạng API đã chọn. Ví dụ, gemini-3.6-flash trong bản chụp này khai báo đầu vào image cho OpenAI Chat; hỗ trợ thực tế phụ thuộc vào thẻ mô hình và định dạng. Đường dẫn tệp cấu hình chính được lấy từ thông lệ OpenClaw; trang đã đọc cũng nhắc đến ~/.openclaw/agents/<agentId>/agent/models.json.

Kiểm tra

Với định dạng OpenAI, địa chỉ là https://api.ailoot.ai/v1 (hoặc đường dẫn đầy đủ nếu ứng dụng yêu cầu địa chỉ đầy đủ).
Với định dạng Anthropic, địa chỉ là https://api.ailoot.ai không có /v1.
Với định dạng Gemini, địa chỉ là https://api.ailoot.ai — địa chỉ gốc API. Ví dụ bên trên không trình bày đầy đủ cách cấu hình định dạng này; kiểm tra đường dẫn cần nhập vào trường của máy khách trong tài liệu của máy khách. Tiền tố tuyến API là /v1beta.
Đặt một câu hỏi ngắn. Nếu nhận được lỗi, hãy xem mã lỗi và Request ID rồi đối chiếu với trang Lỗi và giới hạn.
Lỗi 404 ngay sau khi cấu hình hầu như luôn là do địa chỉ sai: thừa hoặc thiếu /v1.
402 — số dư không đủ cho khoản giữ trước. Tác nhân giữ trước nhiều tiền hơn ứng dụng trò chuyện: lý do.

Tài liệu của ứng dụng: https://docs.openclaw.ai/gateway/config-tools/custom-providers

Còn câu hỏi? Hãy gửi Request ID và mô tả — chúng tôi sẽ giúp tìm hiểu.Liên hệ hỗ trợ