OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

Tìm kiếm web bằng Ollama

OpenClaw hỗ trợ Ollama Web Search dưới dạng nhà cung cấp web_search tích hợp sẵn, trả về tiêu đề, URL và đoạn trích từ API tìm kiếm web của Ollama.

Theo mặc định, Ollama cục bộ/tự lưu trữ không cần khóa API; hệ thống yêu cầu máy chủ Ollama có thể truy cập được cùng với ollama signin. Tìm kiếm trực tiếp trên dịch vụ lưu trữ (không dùng Ollama cục bộ) yêu cầu baseUrl: "https://ollama.com" và OLLAMA_API_KEY hợp lệ.

Thiết lập

  • Khởi động Ollama

    Đảm bảo Ollama đã được cài đặt và đang chạy.

  • Đăng nhập

    bash
    ollama signin

  • Chọn Ollama Web Search

    bash
    openclaw configure --section web

    Chọn Ollama Web Search làm nhà cung cấp.

    • Nếu bạn đã sử dụng Ollama cho các mô hình, Ollama Web Search sẽ dùng lại máy chủ đã được cấu hình đó.

    Cấu hình

    json5
    {  tools: {    web: {      search: {        provider: "ollama",      },    },  },}

    Tùy chọn ghi đè máy chủ, chỉ áp dụng cho tìm kiếm web:

    json5
    {  plugins: {    entries: {      ollama: {        config: {          webSearch: {            baseUrl: "http://ollama-host:11434",          },        },      },    },  },}

    Hoặc dùng lại máy chủ đã được cấu hình cho nhà cung cấp mô hình Ollama:

    json5
    {  models: {    providers: {      ollama: {        baseUrl: "http://ollama-host:11434",      },    },  },}

    models.providers.ollama.baseUrl là khóa chuẩn; nhà cung cấp tìm kiếm web cũng chấp nhận baseURL tại đó để tương thích với các ví dụ cấu hình theo kiểu OpenAI SDK. Nếu không thiết lập gì, OpenClaw mặc định sử dụng http://127.0.0.1:11434.

    Ollama Web Search được lưu trữ trực tiếp (không dùng Ollama cục bộ):

    json5
    {  models: {    providers: {      ollama: {        baseUrl: "https://ollama.com",        apiKey: "OLLAMA_API_KEY",      },    },  },  tools: {    web: {      search: {        provider: "ollama",      },    },  },}

    Xác thực và định tuyến yêu cầu

    • Không có trường khóa API dành riêng cho tìm kiếm web; nhà cung cấp dùng lại models.providers.ollama.apiKey (hoặc thông tin xác thực của nhà cung cấp tương ứng được cấp qua biến môi trường) khi máy chủ đã cấu hình được bảo vệ bằng xác thực.
    • Thứ tự phân giải máy chủ: plugins.entries.ollama.config.webSearch.baseUrl → models.providers.ollama.baseUrl (hoặc baseURL) → http://127.0.0.1:11434.
    • Nếu máy chủ đã phân giải là https://ollama.com, OpenClaw gọi trực tiếp https://ollama.com/api/web_search với khóa API dùng làm thông tin xác thực bearer.
    • Nếu không, trước tiên OpenClaw gọi điểm cuối proxy cục bộ /api/experimental/web_search (điểm cuối này ký và chuyển tiếp đến Ollama Cloud), sau đó chuyển sang /api/web_search trên cùng máy chủ nếu lần gọi đầu thất bại. Nếu cả hai đều thất bại và OLLAMA_API_KEY đã được đặt, hệ thống thử lại một lần với https://ollama.com/api/web_search bằng khóa đó — mà không gửi khóa đến máy chủ cục bộ.
    • OpenClaw cảnh báo trong quá trình thiết lập nếu không thể truy cập Ollama hoặc chưa đăng nhập, nhưng không ngăn việc chọn nhà cung cấp.

    Liên quan

    • Tổng quan về tìm kiếm web -- tất cả nhà cung cấp và tính năng tự động phát hiện
    • Ollama -- thiết lập mô hình Ollama và các chế độ đám mây/cục bộ
    Was this useful?
    On this page

    On this page