การค้นหา Gemini

OpenClaw รองรับโมเดล Gemini พร้อม Google Search grounding ในตัว ซึ่งส่งคืนคำตอบที่ AI สังเคราะห์โดยอ้างอิงจากผลลัพธ์ Google Search แบบสดพร้อม การอ้างอิง

รับคีย์ API

openclaw configure --section web

การกำหนดค่า

{  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",      },    },  },}

ลำดับความสำคัญของข้อมูลประจำตัว: การค้นหาเว็บของ Gemini ใช้ plugins.entries.google.config.webSearch.apiKey ก่อน จากนั้นจึงใช้ GEMINI_API_KEY แล้วจึงใช้ models.providers.google.apiKey สำหรับ URL พื้นฐาน ค่าเฉพาะ plugins.entries.google.config.webSearch.baseUrl จะมีผลก่อน models.providers.google.baseUrl

สำหรับการติดตั้ง Gateway ให้วางคีย์สภาพแวดล้อมไว้ใน ~/.openclaw/.env

วิธีการทำงาน

ต่างจากผู้ให้บริการค้นหาแบบดั้งเดิมที่ส่งคืนรายการลิงก์และข้อความตัวอย่าง Gemini ใช้ Google Search grounding เพื่อสร้างคำตอบที่ AI สังเคราะห์พร้อม การอ้างอิงแบบอินไลน์ ผลลัพธ์มีทั้งคำตอบที่สังเคราะห์แล้วและ URL แหล่งที่มา

• URL การอ้างอิงจาก Gemini grounding จะถูกแปลงจาก URL เปลี่ยนเส้นทางของ Google เป็น URL โดยตรงโดยอัตโนมัติ
• การแปลงการเปลี่ยนเส้นทางใช้เส้นทางป้องกัน SSRF (HEAD + การตรวจสอบการเปลี่ยนเส้นทาง + การตรวจสอบ http/https) ก่อนส่งคืน URL การอ้างอิงสุดท้าย
• การแปลงการเปลี่ยนเส้นทางใช้ค่าเริ่มต้น SSRF แบบเข้มงวด ดังนั้นการเปลี่ยนเส้นทางไปยัง เป้าหมายส่วนตัว/ภายในจะถูกบล็อก

พารามิเตอร์ที่รองรับ

การค้นหา Gemini รองรับ query, freshness, date_after และ date_before

count รองรับเพื่อความเข้ากันได้กับ web_search ที่ใช้ร่วมกัน แต่ Gemini grounding ยังคงส่งคืนคำตอบที่สังเคราะห์หนึ่งรายการพร้อมการอ้างอิง แทนที่จะเป็นรายการผลลัพธ์ N รายการ

freshness รองรับ day, week, month, year และชอร์ตคัตที่ใช้ร่วมกัน pd, pw, pm และ py day/pd จะเพิ่มคำสั่งความใหม่ให้กับ query ของ Gemini แทนช่วงเวลา 24 ชั่วโมงแบบตายตัว week, month, year และช่วง date_after/date_before ที่ระบุชัดเจนจะตั้งค่า timeRangeFilter ของ Google Search grounding ของ Gemini ไม่รองรับ country, language และ domain_filter

การเลือกโมเดล

โมเดลเริ่มต้นคือ gemini-2.5-flash (รวดเร็วและคุ้มค่า) สามารถใช้โมเดล Gemini ใดก็ได้ที่รองรับ grounding ผ่าน plugins.entries.google.config.webSearch.model

การแทนที่ URL พื้นฐาน

ตั้งค่า plugins.entries.google.config.webSearch.baseUrl เมื่อการค้นหาเว็บของ Gemini ต้องกำหนดเส้นทางผ่านพร็อกซีของผู้ปฏิบัติการหรือปลายทางแบบกำหนดเองที่เข้ากันได้กับ Gemini หาก ไม่ได้ตั้งค่าไว้ การค้นหาเว็บของ Gemini จะใช้ models.providers.google.baseUrl ซ้ำ ค่า https://generativelanguage.googleapis.com แบบธรรมดาจะถูกทำให้เป็น https://generativelanguage.googleapis.com/v1beta; เส้นทางพร็อกซีแบบกำหนดเองจะถูกเก็บไว้ ตามที่ระบุหลังจากตัดเครื่องหมายทับท้ายออก

ที่เกี่ยวข้อง

• ภาพรวมการค้นหาเว็บ -- ผู้ให้บริการทั้งหมดและการตรวจจับอัตโนมัติ
• Brave Search -- ผลลัพธ์แบบมีโครงสร้างพร้อมข้อความตัวอย่าง
• Perplexity Search -- ผลลัพธ์แบบมีโครงสร้าง + การดึงเนื้อหา