การค้นหาด้วย 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", // or "llm-context"
            baseUrl: "https://api.search.brave.com", // optional proxy/base URL override
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}

การตั้งค่าการค้นหา Brave เฉพาะผู้ให้บริการตอนนี้อยู่ใต้ plugins.entries.brave.config.webSearch.* ค่าเดิม tools.web.search.apiKey ยังโหลดผ่าน compatibility shim ได้ แต่ไม่ใช่เส้นทางคอนฟิกมาตรฐานอีกต่อไป

webSearch.mode ควบคุมการส่งข้อมูลของ Brave:

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

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

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

querystringrequired

คำค้นหา

countnumber

จำนวนผลลัพธ์ที่จะส่งคืน (1–10)

countrystring

รหัสประเทศ ISO 2 ตัวอักษร (เช่น US, DE)

languagestring

รหัสภาษา ISO 639-1 สำหรับผลการค้นหา (เช่น en, de, fr)

search_langstring

รหัสภาษาการค้นหาของ Brave (เช่น en, en-gb, zh-hans)

ui_langstring

รหัสภาษา ISO สำหรับองค์ประกอบ UI

freshness'day' | 'week' | 'month' | 'year'

ตัวกรองเวลา — day คือ 24 ชั่วโมง

date_afterstring

เฉพาะผลลัพธ์ที่เผยแพร่หลังวันที่นี้ (YYYY-MM-DD)

date_beforestring

เฉพาะผลลัพธ์ที่เผยแพร่ก่อนวันที่นี้ (YYYY-MM-DD)

ตัวอย่าง:

// Country and language-specific search
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Recent results (past week)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Date range search
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, สถานะ/เวลาตอบกลับ และเหตุการณ์ hit/miss/write ของแคชการค้นหาระหว่างแก้ปัญหา แฟล็กนี้จะไม่บันทึกคีย์ API หรือเนื้อหาการตอบกลับ แต่คำค้นหาอาจเป็นข้อมูลละเอียดอ่อน

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

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