การค้นหาด้วย Gemini

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

รับคีย์ API

openclaw configure --section web

การกำหนดค่า

{  plugins: {    entries: {      google: {        config: {          webSearch: {            apiKey: "AIza...", // ไม่บังคับ หากตั้งค่า GEMINI_API_KEY หรือ models.providers.google.apiKey ไว้แล้ว            baseUrl: "https://generativelanguage.googleapis.com/v1beta", // ไม่บังคับ หากไม่กำหนดจะใช้ models.providers.google.baseUrl            model: "gemini-2.5-flash", // ค่าเริ่มต้น          },        },      },    },  },  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 เพื่อสร้างคำตอบที่ AI สังเคราะห์ขึ้น พร้อมการอ้างอิงภายในข้อความ ผลลัพธ์ประกอบด้วยทั้งคำตอบที่สังเคราะห์ขึ้นและ URL ของแหล่งข้อมูล

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

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

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

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

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

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

โมเดลเริ่มต้นคือ gemini-2.5-flash (รวดเร็วและคุ้มค่า) สามารถใช้โมเดล Gemini ใดก็ได้ที่รองรับการเชื่อมโยงข้อมูลผ่าน 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 -- ผลลัพธ์แบบมีโครงสร้างพร้อมการแยกเนื้อหา