Tìm kiếm Gemini

OpenClaw hỗ trợ các mô hình Gemini với grounding Google Search tích hợp, trả về 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 khóa API

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ở, giá trị chuyên dụng plugins.entries.google.config.webSearch.baseUrl được ưu tiên trước models.providers.google.baseUrl.

Với bản cài đặt Gateway, hãy đặt các khóa môi trường trong ~/.openclaw/.env.

# Cách hoạt động

Không giống 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 grounding Google Search để 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, nên 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ì một 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. OpenClaw chuyển đổi các giá trị này, hoặc một khoảng date_after/date_before rõ ràng, thành 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à hiệu quả về chi phí). Bất kỳ mô hình Gemini nào hỗ trợ grounding đều có thể được dù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 đi qua proxy của nhà vận hành hoặc endpoint tùy chỉnh tương thích với Gemini. Nếu giá trị đó chưa được đặt, tìm kiếm web Gemini dùng lại models.providers.google.baseUrl. Một 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

• Tổng quan Web Search -- tất cả nhà cung cấp và tự động phát hiện
• Brave Search -- kết quả có cấu trúc kèm đoạn trích
• Perplexity Search -- kết quả có cấu trúc + trích xuất nội dung