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

OpenClaw รองรับ Brave Search API ในฐานะผู้ให้บริการ web_search

รับคีย์ API

1. สร้างบัญชี Brave Search API ที่ https://brave.com/search/api/
2. ในแดชบอร์ด ให้เลือกแผน Search และสร้างคีย์ API
3. จัดเก็บคีย์ในการกำหนดค่า หรือตั้งค่า BRAVE_API_KEY ในสภาพแวดล้อมของ Gateway

ตัวอย่างการกำหนดค่า

{  plugins: {    entries: {      brave: {        config: {          webSearch: {            apiKey: "BRAVE_API_KEY_HERE",            mode: "web", // หรือ "llm-context"            baseUrl: "https://api.search.brave.com", // การแทนที่พร็อกซี/URL ฐาน (ไม่บังคับ)          },        },      },    },  },  tools: {    web: {      search: {        provider: "brave",        maxResults: 5,        timeoutSeconds: 30,      },    },  },}

การตั้งค่าการค้นหาเฉพาะของผู้ให้บริการ Brave อยู่ภายใต้ plugins.entries.brave.config.webSearch.* ซึ่งเป็นพาธการกำหนดค่าหลัก tools.web.search.apiKey ระดับบนสุดที่ใช้ร่วมกันและ tools.web.search.brave.* ที่จำกัดขอบเขตยังคงโหลดได้ผ่านการผสานเพื่อความเข้ากันได้ แต่การกำหนดค่าใหม่ควรใช้พาธที่จำกัดขอบเขตเฉพาะ Plugin ด้านบน

webSearch.mode ควบคุมวิธีรับส่งข้อมูลของ Brave:

• web (ค่าเริ่มต้น): การค้นหาเว็บ Brave ตามปกติ พร้อมชื่อเรื่อง URL และข้อความย่อ
• llm-context: Brave LLM Context API พร้อมส่วนข้อความและแหล่งข้อมูลที่แยกไว้ล่วงหน้าสำหรับใช้อ้างอิงข้อมูล

webSearch.baseUrl สามารถกำหนดให้คำขอ Brave ส่งไปยังพร็อกซีหรือเกตเวย์ที่เข้ากันได้กับ Brave และเชื่อถือได้ OpenClaw จะต่อท้าย /res/v1/web/search หรือ /res/v1/llm/context เข้ากับ URL ฐานที่กำหนดค่าไว้ และรวม URL ฐานไว้ในคีย์แคช ปลายทางสาธารณะต้องใช้ https:// ส่วน http:// ยอมรับเฉพาะโฮสต์พร็อกซี local loopback ที่เชื่อถือได้หรือโฮสต์ในเครือข่ายส่วนตัวเท่านั้น

พารามิเตอร์ของเครื่องมือ

ตัวอย่าง:

// ค้นหาเฉพาะประเทศและภาษาawait web_search({  query: "renewable energy",  country: "DE",  language: "de",}); // ผลลัพธ์ล่าสุด (สัปดาห์ที่ผ่านมา)await web_search({  query: "AI news",  freshness: "week",}); // ค้นหาตามช่วงวันที่await web_search({  query: "AI developments",  date_after: "2024-01-01",  date_before: "2024-06-30",});

หมายเหตุ

• OpenClaw ใช้แผน Search ของ Brave หากคุณมีการสมัครใช้งานแบบเดิม (เช่น แผน Free ดั้งเดิมที่รองรับ 2,000 คำค้นหาต่อเดือน) การสมัครดังกล่าวจะยังคงใช้ได้ แต่จะไม่รวมคุณสมบัติใหม่กว่า เช่น LLM Context หรือขีดจำกัดอัตราการใช้งานที่สูงขึ้น
• แผน Brave แต่ละแผนมี เครดิตฟรี $5 ต่อเดือน (ต่ออายุใหม่ทุกเดือน) แผน Search มีค่าใช้จ่าย $5 ต่อ 1,000 คำขอ ดังนั้นเครดิตจึงครอบคลุม 1,000 คำค้นหาต่อเดือน ตั้งค่าขีดจำกัดการใช้งานในแดชบอร์ด Brave เพื่อหลีกเลี่ยงค่าใช้จ่ายที่ไม่คาดคิด ดูแผนปัจจุบันได้ที่ พอร์ทัล Brave API
• แผน Search มีปลายทาง LLM Context และสิทธิ์การอนุมาน AI การจัดเก็บผลลัพธ์เพื่อฝึกหรือปรับแต่งโมเดลต้องใช้แผนที่ให้สิทธิ์การจัดเก็บไว้อย่างชัดเจน โปรดดู ข้อกำหนดในการให้บริการ ของ Brave
• โหมด llm-context ส่งคืนรายการแหล่งข้อมูลที่ใช้อ้างอิงแทนโครงสร้างข้อความย่อของการค้นหาเว็บตามปกติ
• โหมด llm-context รองรับ freshness และช่วง date_after + date_before ที่มีขอบเขตจำกัด แต่ไม่รองรับ ui_lang และจะปฏิเสธ date_before ที่ไม่มี date_after เนื่องจาก Brave กำหนดให้ช่วงเวลาความสดใหม่แบบกำหนดเองต้องมีทั้งวันที่เริ่มต้นและวันที่สิ้นสุด
• ui_lang ต้องมีแท็กย่อยของภูมิภาค เช่น en-US
• ผลลัพธ์จะถูกแคชไว้ 15 นาทีโดยค่าเริ่มต้น (กำหนดค่าได้ผ่าน cacheTtlMinutes)
• ค่า webSearch.baseUrl แบบกำหนดเองจะรวมอยู่ในข้อมูลระบุแคชของ Brave ดังนั้นการตอบกลับเฉพาะของแต่ละพร็อกซีจึงไม่ชนกัน
• เปิดใช้งานแฟล็กการวินิจฉัย brave.http เพื่อบันทึก URL/พารามิเตอร์คำค้นหาของคำขอ Brave สถานะ/ระยะเวลาการตอบกลับ และเหตุการณ์พบ/ไม่พบ/เขียนแคชการค้นหาในระหว่างการแก้ไขปัญหา แฟล็กนี้จะไม่บันทึกคีย์ API หรือเนื้อหาการตอบกลับ แต่คำค้นหาอาจมีข้อมูลที่ละเอียดอ่อน

เนื้อหาที่เกี่ยวข้อง

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