Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw hỗ trợ SearXNG làm nhà cung cấp web_search tự lưu trữ, không cần khóa. SearXNG là một công cụ siêu tìm kiếm nguồn mở tổng hợp kết quả từ Google, Bing, DuckDuckGo và các nguồn khác. Ưu điểm:
  • Miễn phí và không giới hạn — không cần khóa API hoặc gói đăng ký thương mại
  • Quyền riêng tư / cách ly mạng — truy vấn không bao giờ rời khỏi mạng của bạn
  • Hoạt động ở mọi nơi — không bị giới hạn theo khu vực trên các API tìm kiếm thương mại

​
Thiết lập

1

Chạy một phiên bản SearXNG

docker run -d -p 8888:8080 searxng/searxng
Hoặc dùng bất kỳ triển khai SearXNG hiện có nào mà bạn có quyền truy cập. Xem tài liệu SearXNG để thiết lập cho môi trường sản xuất.
2

Cấu hình

openclaw configure --section web
# Select "searxng" as the provider
Hoặc đặt biến môi trường và để tính năng tự động phát hiện tìm thấy nó:
export SEARXNG_BASE_URL="http://localhost:8888"

​
Cấu hình

{
  tools: {
    web: {
      search: {
        provider: "searxng",
      },
    },
  },
}
Thiết lập cấp Plugin cho phiên bản SearXNG: 
{
  plugins: {
    entries: {
      searxng: {
        config: {
          webSearch: {
            baseUrl: "http://localhost:8888",
            categories: "general,news", // optional
            language: "en", // optional
          },
        },
      },
    },
  },
}
Trường baseUrl cũng chấp nhận các đối tượng SecretRef. Quy tắc truyền tải:
  • https:// hoạt động cho máy chủ SearXNG công khai hoặc riêng tư
  • http:// chỉ được chấp nhận cho máy chủ mạng riêng đáng tin cậy hoặc loopback
  • máy chủ SearXNG công khai phải dùng https://

​
Biến môi trường

Đặt SEARXNG_BASE_URL làm lựa chọn thay thế cho cấu hình: 
export SEARXNG_BASE_URL="http://localhost:8888"
Khi SEARXNG_BASE_URL được đặt và không có nhà cung cấp rõ ràng nào được cấu hình, tính năng tự động phát hiện tự động chọn SearXNG (ở mức ưu tiên thấp nhất — bất kỳ nhà cung cấp dựa trên API nào có khóa sẽ thắng trước).

​
Tham chiếu cấu hình Plugin

TrườngMô tả
baseUrlURL cơ sở của phiên bản SearXNG của bạn (bắt buộc)
categoriesCác danh mục phân tách bằng dấu phẩy như general, news, hoặc science
languageMã ngôn ngữ cho kết quả như en, de, hoặc fr

​
Ghi chú

  • JSON API — dùng endpoint format=json gốc của SearXNG, không phải quét HTML
  • Không cần khóa API — hoạt động ngay với bất kỳ phiên bản SearXNG nào
  • Xác thực URL cơ sở — baseUrl phải là URL http:// hoặc https:// hợp lệ; máy chủ công khai phải dùng https://
  • Thứ tự tự động phát hiện — SearXNG được kiểm tra cuối cùng (thứ tự 200) trong tự động phát hiện. Các nhà cung cấp dựa trên API có khóa đã cấu hình chạy trước, rồi đến DuckDuckGo (thứ tự 100), rồi Ollama Web Search (thứ tự 110)
  • Tự lưu trữ — bạn kiểm soát phiên bản, truy vấn và các công cụ tìm kiếm thượng nguồn
  • Danh mục mặc định là general khi chưa được cấu hình
Để JSON API của SearXNG hoạt động, hãy bảo đảm phiên bản SearXNG của bạn đã bật định dạng json trong settings.yml của nó, bên dưới search.formats.

​
Liên quan