Tools

Ollama ウェブ検索

OpenClaw は、バンドルされた web_search プロバイダーとして Ollama Web Search をサポートし、Ollama のウェブ検索 API からタイトル、URL、スニペットを返します。

ローカル/セルフホストの Ollama では、デフォルトで API キーは不要です。到達可能な Ollama ホストと ollama signin が必要です。直接ホスト型検索(ローカル Ollama なし)では、baseUrl: "https://ollama.com" と実際の OLLAMA_API_KEY が必要です。

セットアップ

  • Ollama を起動

    Ollama がインストールされ、実行中であることを確認します。

  • サインイン

    bash
    ollama signin
  • Ollama Web Search を選択

    bash
    openclaw configure --section web

    プロバイダーとして Ollama Web Search を選択します。

  • モデルですでに Ollama を使用している場合、Ollama Web Search は設定済みの同じホストを再利用します。

    設定

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

    ウェブ検索のみに適用される、任意のホスト上書き設定:

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

    または、Ollama モデルプロバイダーにすでに設定されているホストを再利用します:

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

    models.providers.ollama.baseUrl が正規のキーです。ウェブ検索プロバイダーは、OpenAI SDK 形式の設定例との互換性のため、ここで baseURL も受け付けます。何も設定されていない場合、OpenClaw はデフォルトで http://127.0.0.1:11434 を使用します。

    直接ホスト型 Ollama Web Search(ローカル Ollama なし):

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

    認証とリクエストのルーティング

    • ウェブ検索専用の API キーフィールドはありません。設定されたホストが認証で保護されている場合、プロバイダーは models.providers.ollama.apiKey(または対応する環境変数ベースのプロバイダー認証)を再利用します。
    • ホストの解決順序:plugins.entries.ollama.config.webSearch.baseUrlmodels.providers.ollama.baseUrl(または baseURL)→ http://127.0.0.1:11434
    • 解決されたホストが https://ollama.com の場合、OpenClaw は API キーをベアラー認証として使用し、https://ollama.com/api/web_search を直接呼び出します。
    • それ以外の場合、OpenClaw はまずローカルプロキシエンドポイント /api/experimental/web_search(署名して Ollama Cloud に転送)を呼び出し、その後、同じホストの /api/web_search にフォールバックします。両方が失敗し、OLLAMA_API_KEY が設定されている場合、そのキーを使用して https://ollama.com/api/web_search に対して一度だけ再試行します。このキーがローカルホストに送信されることはありません。
    • セットアップ中に Ollama に到達できない場合やサインインされていない場合、OpenClaw は警告を表示しますが、プロバイダーの選択はブロックしません。

    関連項目

    • ウェブ検索の概要 -- すべてのプロバイダーと自動検出
    • Ollama -- Ollama モデルのセットアップとクラウド/ローカルモード
    Was this useful?
    On this page

    On this page