Chuyển đến nội dung chính
Hướng dẫn này dành cho người dùng self-hosted OpenClaw muốn kết nối AI Sonar làm provider AI của họ.

​
Tổng quan

Đối với các phiên bản OpenClaw hiện tại, cách khuyến nghị là cấu hình AI Sonar qua models.providers. Nếu bạn chỉ muốn bắt đầu nhanh, chỉ cần cấu hình aisonar là đủ. Chỉ thêm các provider khác khi bạn thực sự cần hành vi Responses API, Claude native, Gemini native, hoặc MiniMax native.
Nhà cung cấpOpenClaw apiPhù hợp chobaseUrl
aisonaropenai-completionsGPT, DeepSeek, Qwen, và hầu hết các gọi tương thích OpenAIhttps://api.aisonar.dev/v1
aisonar-responsesopenai-responsesCác luồng công việc OpenAI Responses mong đợi ngữ nghĩa /v1/responseshttps://api.aisonar.dev/v1
aisonar-claudeanthropic-messagesAPI Messages gốc của Claudehttps://api.aisonar.dev
aisonar-geminigoogle-generative-aiĐịnh dạng API Gemini gốchttps://api.aisonar.dev
aisonar-minimaxanthropic-messagesĐiều hướng MiniMax gốchttps://api.aisonar.dev
Chỉ sử dụng hậu tố /v1 cho openai-completions và openai-responses.Các nhà cung cấp gốc như anthropic-messages và google-generative-ai nên dùng https://api.aisonar.dev mà không có /v1, nếu không OpenClaw có thể tạo sai đường dẫn upstream.

​
Yêu cầu tiên quyết

  • Một instance OpenClaw self-hosted
  • Một AI Sonar API Key — Get one here

​
Cấu hình

Chỉnh sửa cấu hình OpenClaw của bạn:
  • Tự lưu trữ: ~/.openclaw/openclaw.json
Thêm provider AI Sonar dưới models.providers: 
{
  agents: {
    defaults: {
      model: {
        primary: "aisonar-claude/claude-sonnet-4-6"
      }
    }
  },
  models: {
    mode: "merge",
    providers: {
      aisonar: {
        api: "openai-completions",
        baseUrl: "https://api.aisonar.dev/v1",
        apiKey: "sk-your-api-key",
        models: [
          { id: "gpt-4o", name: "GPT-4o" },
          { id: "deepseek-r1", name: "DeepSeek R1" },
          { id: "qwen3-32b", name: "Qwen 3 32B" }
        ]
      },
      "aisonar-responses": {
        api: "openai-responses",
        baseUrl: "https://api.aisonar.dev/v1",
        apiKey: "sk-your-api-key",
        models: [
          { id: "gpt-4o", name: "GPT-4o (Responses)" },
          { id: "gpt-5.2", name: "GPT-5.2 (Responses)" }
        ]
      },
      "aisonar-claude": {
        api: "anthropic-messages",
        baseUrl: "https://api.aisonar.dev",
        apiKey: "sk-your-api-key",
        models: [
          { id: "claude-sonnet-4-6", name: "Claude Sonnet 4.6" },
          { id: "claude-opus-4-6", name: "Claude Opus 4.6" }
        ]
      },
      "aisonar-gemini": {
        api: "google-generative-ai",
        baseUrl: "https://api.aisonar.dev",
        apiKey: "sk-your-api-key",
        models: [
          { id: "gemini-2.5-flash", name: "Gemini 2.5 Flash" },
          { id: "gemini-3-flash-preview", name: "Gemini 3 Flash Preview" }
        ]
      },
      "aisonar-minimax": {
        api: "anthropic-messages",
        baseUrl: "https://api.aisonar.dev",
        apiKey: "sk-your-api-key",
        models: [
          { id: "minimax-m1", name: "MiniMax M1" }
        ]
      }
    }
  }
}
Cả 5 nhà cung cấp đều dùng cùng một API Key. Bạn chỉ cần một tài khoản AI Sonar.
Các mảng models ở trên chỉ hiển thị các ví dụ phổ biến. Thêm các model ID khác cho từng nhà cung cấp khi cần.

​
Sử dụng Models

OpenClaw vẫn tham chiếu các model theo định dạng provider/model: 
{
  agents: {
    defaults: {
      model: {
        primary: "aisonar-gemini/gemini-2.5-flash"
      }
    }
  }
}

​
Ví dụ Model

Nhà cung cấpTham chiếu modelMô tả
aisonaraisonar/gpt-4oRoute tương thích OpenAI
aisonaraisonar/deepseek-r1Mô hình suy luận DeepSeek
aisonar-responsesaisonar-responses/gpt-4oRoute Responses API
aisonar-claudeaisonar-claude/claude-sonnet-4-6Route Messages gốc của Claude
aisonar-geminiaisonar-gemini/gemini-2.5-flashRoute Gemini gốc
aisonar-minimaxaisonar-minimax/minimax-m1Route MiniMax gốc
Browse all available models at aisonar.dev/models.

​
Khi nào sử dụng provider nào

  • aisonar: lựa chọn mặc định cho hầu hết các trường hợp sử dụng agent và chat đa dụng.
  • aisonar-responses: dùng khi luồng công việc OpenClaw của bạn phụ thuộc rõ ràng vào ngữ nghĩa OpenAI Responses.
  • aisonar-claude: dùng khi bạn muốn hành vi Messages gốc của Claude.
  • aisonar-gemini: dùng khi bạn cần định dạng yêu cầu/đáp trả gốc của Gemini hoặc tích hợp theo kiểu Gemini hiện có.
  • aisonar-minimax: dùng khi bạn muốn MiniMax theo route gốc của nó.
Nếu bạn không cần hành vi Gemini-gốc, bạn vẫn có thể gọi các model Gemini thông qua aisonar/gemini-* trên route tương thích OpenAI.

​
Những lỗi phổ biến

Tài liệu OpenClaw hiện tại sử dụng models.providers. Nếu bạn giữ định dạng mảng providers cấp cao cũ, OpenClaw có thể bỏ qua cấu hình hoặc không thể giải quyết tiền tố provider như mong đợi.
openai-responses ánh xạ đến đường dẫn /v1/responses của AI Sonar, nên aisonar-responses phải sử dụng https://api.aisonar.dev/v1.
anthropic-messages và google-generative-ai nên sử dụng https://api.aisonar.dev mà không có /v1. Thêm /v1 có thể tạo ra các đường dẫn yêu cầu không chính xác.
Có. Tài liệu OpenClaw hiện tại vẫn bao gồm provider tích hợp sẵn google và cũng hỗ trợ các provider tùy chỉnh sử dụng api: "google-generative-ai". Vì vậy aisonar-gemini vẫn là một route Gemini gốc hợp lệ cho người dùng OpenClaw.

​
Xác minh cấu hình

Sau khi lưu cấu hình, khởi động lại instance OpenClaw của bạn và thử với một tin nhắn đơn giản. Nếu bạn nhận được phản hồi, provider đã được cấu hình chính xác. 
# Tự lưu trữ: khởi động lại dịch vụ
systemctl --user restart openclaw    # Linux
launchctl stop cc.aisonar.openclaw && launchctl start cc.aisonar.openclaw  # macOS

​
Bước tiếp theo

Khi OpenClaw đã kết nối, các hướng dẫn sau sẽ giúp bạn sử dụng AI Sonar hiệu quả hơn:
  • Định dạng API — hiểu sự khác nhau giữa các route OpenAI, Responses, Anthropic và Gemini
  • IDE / SDK Compatibility — xem khi nào /v1/responses là lựa chọn phù hợp hơn
  • Xử lý lỗi — tìm hiểu các chế độ thất bại phổ biến và các mẫu phục hồi
  • Tổng quan mô hình — duyệt các ID model trước khi kết nối chúng vào agents