Chuyển đến nội dung chính
OpenClaw hỗ trợ các mô hình Gemini với Google Search grounding tích hợp sẵn, trả về các câu trả lời do AI tổng hợp, được hỗ trợ bởi kết quả Google Search trực tiếp kèm trích dẫn.

​
Lấy API key

1

Tạo khóa

Truy cập Google AI Studio và tạo một API key.
2

Lưu khóa

Đặt GEMINI_API_KEY trong môi trường Gateway, dùng lại models.providers.google.apiKey, hoặc cấu hình một khóa tìm kiếm web chuyên dụng qua:
openclaw configure --section web

​
Cấu hình

{
  plugins: {
    entries: {
      google: {
        config: {
          webSearch: {
            apiKey: "AIza...", // optional if GEMINI_API_KEY or models.providers.google.apiKey is set
            baseUrl: "https://generativelanguage.googleapis.com/v1beta", // optional; falls back to models.providers.google.baseUrl
            model: "gemini-2.5-flash", // default
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "gemini",
      },
    },
  },
}
Thứ tự ưu tiên thông tin xác thực: Tìm kiếm web Gemini dùng plugins.entries.google.config.webSearch.apiKey trước, sau đó đến GEMINI_API_KEY, rồi models.providers.google.apiKey. Với URL cơ sở, cấu hình chuyên dụng plugins.entries.google.config.webSearch.baseUrl được ưu tiên trước models.providers.google.baseUrl. Với một bản cài đặt Gateway, đặt các khóa môi trường trong ~/.openclaw/.env.

​
Cách hoạt động

Khác với các nhà cung cấp tìm kiếm truyền thống trả về danh sách liên kết và đoạn trích, Gemini dùng Google Search grounding để tạo câu trả lời do AI tổng hợp với trích dẫn nội tuyến. Kết quả bao gồm cả câu trả lời đã tổng hợp và các URL nguồn.
  • URL trích dẫn từ Gemini grounding được tự động phân giải từ URL chuyển hướng của Google thành URL trực tiếp.
  • Việc phân giải chuyển hướng dùng đường dẫn bảo vệ SSRF (HEAD + kiểm tra chuyển hướng + xác thực http/https) trước khi trả về URL trích dẫn cuối cùng.
  • Việc phân giải chuyển hướng dùng các mặc định SSRF nghiêm ngặt, vì vậy các chuyển hướng đến mục tiêu riêng tư/nội bộ sẽ bị chặn.

​
Tham số được hỗ trợ

Tìm kiếm Gemini hỗ trợ query, freshness, date_after và date_before. count được chấp nhận để tương thích với web_search dùng chung, nhưng Gemini grounding vẫn trả về một câu trả lời đã tổng hợp kèm trích dẫn thay vì danh sách N kết quả. freshness chấp nhận day, week, month, year và các lối tắt dùng chung pd, pw, pm và py. day/pd thêm hướng dẫn về độ mới vào truy vấn Gemini thay vì một phạm vi cứng 24 giờ. week, month, year và các phạm vi tường minh date_after/date_before đặt timeRangeFilter của Gemini Google Search grounding. country, language và domain_filter không được hỗ trợ.

​
Chọn mô hình

Mô hình mặc định là gemini-2.5-flash (nhanh và tiết kiệm chi phí). Có thể dùng bất kỳ mô hình Gemini nào hỗ trợ grounding thông qua plugins.entries.google.config.webSearch.model.

​
Ghi đè URL cơ sở

Đặt plugins.entries.google.config.webSearch.baseUrl khi tìm kiếm web Gemini phải định tuyến qua proxy của người vận hành hoặc điểm cuối tùy chỉnh tương thích với Gemini. Nếu chưa đặt giá trị đó, tìm kiếm web Gemini sẽ dùng lại models.providers.google.baseUrl. Giá trị thuần https://generativelanguage.googleapis.com được chuẩn hóa thành https://generativelanguage.googleapis.com/v1beta; các đường dẫn proxy tùy chỉnh được giữ nguyên như đã cung cấp sau khi cắt bỏ dấu gạch chéo ở cuối.

​
Liên quan